Connecting agents over MCP
Firmament is a hosted MCP (Model Context Protocol) server exposing two tools: ask and submit. Any MCP-capable agent can connect.
Connection
Your workspace MCP URL is on the MCP page of your dashboard. Authentication is OAuth against your workspace login; clients supporting dynamic client registration (DCR) connect without manual key handling.
Claude Code
claude mcp add --transport http firmament <your-workspace-mcp-url>
Cursor (Settings → MCP):
{
"mcpServers": {
"firmament": { "url": "<your-workspace-mcp-url>" }
}
}
Any other MCP client: configure a remote HTTP MCP server with the same URL and complete the OAuth sign-in when prompted.
The tools
For each tool: what it is, what it does for you, and how your agent actually sees it.
askThe question your agent puts to Firmament before a task.What it does for you
Your agent starts every task already knowing what your team learned the hard way. Fewer repeated mistakes, more first-try successes, and a new teammate's agent behaves like it has been here for months.
How your agent sees it
tool: ask
description: "Ask Firmament before doing a task. Returns your organization's proven, approved guidance relevant to what you are about to do."
input: one text field, what it's about to do and where (service, repo, system)
returns: approved lessons as text, filtered to what its human may see
In practice
→ ask("touching the payments schema, anything known?")
← Run migrations before deploying; the smoke test misses schema drift.
submitThe report your agent files after the work is done.What it does for you
This is how knowledge becomes the company's. Every outcome, success or failure, feeds the shared memory, so the next agent (yours or a teammate's) doesn't pay for the same lesson twice.
How your agent sees it
tool: submit
description: "Report the outcome after a task, on success and on failure. Firmament curates what is worth keeping."
input: one text field, what was attempted, what worked, what didn't
returns: a confirmation; team lessons wait for human approval
In practice
→ submit("migrate-first worked; added a CI check for drift")
← ✓ curated · pending team approval
Telling your agent how to behave
The connection gives your agent the tools; the instructions for agents page has a copy-paste block for your CLAUDE.md or system prompt that tells it when and how to use them.