---
# Firmament MCP server
**Your team's shared knowledge, available to every agent.**
Firmament holds what is true about your company and how work actually gets done
there: the decisions, the numbers, the gotchas, and the exact steps that work in
your organisation. None of that is in any model's training data, so an agent
without it guesses, or works from a document that went stale months ago.
This server exposes Firmament to any MCP client over a hosted HTTP endpoint.
There is nothing to install and nothing to run locally.
## What it does
Two tools.
**`ask`** looks up what your team already knows, before the agent acts or
answers. It covers both kinds of knowledge: facts about your organisation (its
products, customers, metrics, status, decisions) and how work gets done in it
(conventions, prerequisites, the step that is not in the README).
**`submit`** records what the agent learned on the way out: a new fact, a
decision and its reasoning, a number, what failed and why, or the full recipe
for a multi-step process. That goes back to the shared knowledge base, so the
next session and every teammate's agent starts from it.
The result is that knowledge accumulates as work happens, instead of being
written up later by whoever has time.
## Configuration
The server is remote and speaks streamable HTTP. Point your client at:
```
https://mcp.getfirmament.com/mcp
```
Authentication is OAuth 2.1 with dynamic client registration, so most clients
need nothing beyond the URL. You sign in once in your browser when the client
first connects, and it handles the rest.
### VS Code
Add it from the Extensions panel by searching `@mcp`, or add the URL directly to
your MCP configuration as an HTTP server.
### Other clients
Any MCP client that supports remote HTTP servers works. Firmament also ships
first-class packages for several agents, so you may prefer those:
| Agent | Install |
|---|---|
| Claude Code | `claude plugin marketplace add spkenny455/firmament-plugin` then `claude plugin install firmament@firmament` |
| Gemini CLI | `gemini extensions install https://github.com/spkenny455/firmament-gemini-extension` |
| Cursor, Codex, Copilot CLI | see [firmament-plugin](https://github.com/spkenny455/firmament-plugin) |
## Using it
You do not need to prompt the tools by name. The packages above ship a standing
instruction so the agent consults Firmament on its own. With a bare MCP
connection, the tool descriptions carry the same guidance.
In practice it looks like this:
- Before a deploy, the agent asks how releases are actually done here and gets
your runbook, including the manual step missing from the README.
- Asked about pricing, a discount or a refund, it checks your team's approved
answer before replying to a customer.
- After a long debugging session, it records the root cause and the fix, so
nobody loses a day to it again.
- After a multi-step migration, it submits the recipe with the exact commands,
so the next person runs it in one pass.
## Accounts
Firmament is a hosted product. Sign up at
[getfirmament.com](https://getfirmament.com). Knowledge is scoped to your
workspace, and the server resolves every call to a workspace and user from the
OAuth token, so one team's knowledge is never visible to another.
## Links
- Product: https://getfirmament.com
- MCP endpoint: https://mcp.getfirmament.com/mcp
- Registry entry: `com.getfirmament/firmament`
