cobuilt MCP server
Commit Nov 10, 2026Publish honest build receipts to cobuilt.dev to document how AI was involved in your project development.
Also known as cobuilt-dev/agent-plugins, agent-plugins
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.2.0
- Last commit
- Nov 10, 2026
- License
- MIT
What is cobuilt MCP?
cobuilt publishes honest build receipts to cobuilt.dev to document how AI was involved in your project development.
Summary generated from the project's README
About cobuilt MCP server
Documenting the role of artificial intelligence in your software development is what cobuilt enables for developers using Claude Code or Gemini CLI. By generating build receipts, you create an honest record of how AI tools contributed to your project, including the specific models used and the division of labor between you and the agent. This process ensures transparency by drafting details from your repository and session before requiring your manual approval for every field.
To use this server, you must create an agent token starting with cbt_ from your account settings and provide it during the plugin installation process. The server connects to a remote endpoint to manage your projects and receipts. It includes specific tools to list your projects, access a drafting guide, read existing receipts, and submit new ones. Because the system prioritizes privacy, the agent is instructed never to send source code, secrets, or chat transcripts, and it only transmits the finalized receipt data after you have reviewed and approved the content.
What you can do with it
- 1Review existing project documentationRetrieve the current build receipt associated with your project to see what has been recorded.
Written from the project's README. Every use case is checked against a quote from it.
How to install cobuilt MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall cobuilt MCP in Claude Code
$ claude mcp add --transport http agent-plugins https://cobuilt.dev/mcpInstall cobuilt MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"agent-plugins": {
"url": "https://cobuilt.dev/mcp"
}
}
}Install cobuilt MCP in VS Code
.vscode/mcp.json
{
"servers": {
"agent-plugins": {
"type": "http",
"url": "https://cobuilt.dev/mcp"
}
}
}Install cobuilt MCP in VS Code CLI
$ code --add-mcp '{"name":"agent-plugins","type":"http","url":"https://cobuilt.dev/mcp"}'Install cobuilt MCP in Codex
$ codex mcp add agent-plugins --url https://cobuilt.dev/mcpInstall cobuilt MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.agent-plugins] url = "https://cobuilt.dev/mcp"
Install cobuilt MCP in Gemini CLI
$ gemini mcp add -s user --transport http agent-plugins https://cobuilt.dev/mcpInstall cobuilt MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"agent-plugins": {
"url": "https://cobuilt.dev/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablecobuilt-dev/agent-plugins is public and reachablegithub.com/cobuilt-dev/agent-plugins ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-10github.com/cobuilt-dev/agent-plugins ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubcobuilt plugin
Publish a build receipt for your project to cobuilt.dev from your AI coding agent. A build receipt is an honest record of how a project was built and how AI was involved. Your agent drafts it from the repository and the session, asks you what only you can answer, and sends nothing until you have approved every field.
Where it works
Publishing works in Claude Code and Gemini CLI, which can send your agent token. In claude.ai chat and Cowork the skill loads but the cobuilt tools don't work, because those apps connect servers through an OAuth sign-in, which cobuilt doesn't offer yet. Open your project in Claude Code to publish.
Try it
Say any of these in your project:
- "Publish this project to cobuilt." Your agent drafts the receipt, asks what it can't know, and shows you the final fields to approve.
- "Show me the build receipt this project has on cobuilt." It finds the project among yours and reads the current receipt. Nothing is changed.
- "Update this project's build receipt on cobuilt." It starts from the published receipt, shows you the old and new text side by side, and warns you before replacing anything.
Install (Claude Code)
-
Sign in at cobuilt.dev and create an agent token: Settings → Agent tokens (it starts with
cbt_). -
In a Claude Code session, run:
/plugin install cobuilt --marketplace cobuilt-dev/agent-pluginsPaste your token when the dialog asks for it, then run
/reload-plugins. -
Say "Publish this project to cobuilt", or run
/cobuilt:publish.
If it doesn't work
- Added cobuilt with
claude mcp addbefore? Runclaude mcp remove cobuilt --scope userfirst. A server you added by hand at the same address silently replaces the plugin's. - No cobuilt tools? Run
/plugin configure cobuilt@cobuilt, paste your token, then/reload-plugins. Installing from the shell (claude plugin install) doesn't ask for the token. - Added the plugin on claude.ai? It reaches Claude Code as
cobuilt@synced, so run/plugin configure cobuilt@syncedinstead. - Use Cursor too? Cursor imports the Claude Code plugins you installed (Cursor Settings → Agents → Third-Party
Imports, on by default) and lists this one as "cobuilt · Plugin" with an error, because it can't read the token.
Switch that entry off in Cursor's MCP list (it stays off after a restart) and set Cursor up with the
~/.cursor/mcp.jsonsnippet from cobuilt.dev/connect.
Install (Gemini CLI)
-
Create an agent token as above.
-
In a terminal, run:
gemini extensions install https://github.com/cobuilt-dev/agent-pluginsPaste your token when it asks for cobuilt agent token.
-
Start Gemini CLI and say "Publish this project to cobuilt".
No cobuilt tools? Run gemini extensions config cobuilt, paste your token, then restart Gemini CLI.
gemini mcp list should show cobuilt as connected.
Setup for other clients: cobuilt.dev/connect.
What it contains
- The cobuilt MCP server (
https://cobuilt.dev/mcp), sent your token asAuthorization: Bearer …. Its tools: list your projects, get the drafting guide, read your current receipt, submit a build receipt. - One skill,
publish, shared by Claude Code and Gemini CLI. Your client asks before each cobuilt tool call unless you allow it, and submitting a receipt always asks you first.
Your token
Claude Code stores the token as a secret: in the macOS Keychain, elsewhere in Claude Code's own credentials file in your user folder. Uninstalling the plugin removes it.
Gemini CLI stores it in your system keychain (on Windows, Credential Manager under "Gemini CLI Extensions cobuilt …"; without a keychain, in a file in Gemini CLI's own settings folder). Uninstalling the extension does not remove it: delete that entry yourself (on Windows: Control Panel → Credential Manager → Windows Credentials → Generic Credentials).
Revoking the token in Settings → Agent tokens on cobuilt.dev is the real off switch.
What it sends and where
The plugin runs nothing on your machine: no hooks, scripts or local commands. It talks to one server,
https://cobuilt.dev/mcp, and every request carries your agent token.
- Reading: your agent asks for the drafting guide, your list of projects and a project's current receipt.
- Publishing: after you approve, it sends the receipt: project title, description, links, type and tech stack (for a new project), how AI was involved, the AI tools used, what the AI did, what you did, what went wrong, the agent and model names, and optional summary numbers such as commit counts.
A submitted receipt is public once its project is approved, and a new project is reviewed first. Sending a receipt for an existing project replaces its current one. cobuilt keeps the receipt until you replace it or delete the project.
The plugin's instructions tell your agent never to send source code, diffs, file contents, prompts, chat transcripts, secrets, environment variables or local file paths. Your agent shows you every field first, so check them before you approve. See the privacy policy and terms.
Releases
Each change bumps the version in every manifest and gets a GitHub Release tagged vX.Y.Z. Changes to the drafting
guide and the tools ship on cobuilt.dev and need no plugin update. Changes to this README alone don't bump the version.
server.json lists the server in the official MCP Registry as
dev.cobuilt/cobuilt. It carries the same version as the plugin, and a published version can't be republished, so a change
to it needs a release and then a new publish.
License
cobuilt MCP questions
How do I add cobuilt MCP to Claude Code?
Run claude mcp add --transport http agent-plugins https://cobuilt.dev/mcp in your terminal. Add --scope user to make it available in every project.
How do I add cobuilt MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Where does this work?
It works in Claude Code and Gemini CLI. It does not currently work in claude.ai chat or Cowork because those require OAuth.
Does the plugin run local code?
No, the plugin does not run any hooks, scripts, or local commands on your machine.
What information is sent when publishing a receipt?
It sends project details like title, description, and tech stack, along with details on AI involvement, tools used, and what the AI and human did.
How do I install it in Claude Code?
Run /plugin install cobuilt --marketplace cobuilt-dev/agent-plugins in a Claude Code session and paste your agent token.