curl -s "https://api.danubeai.com/v1/claude-code/mcp-json" \
-H "danube-api-key: YOUR_API_KEY"
curl -s "https://api.danubeai.com/v1/claude-code/mcp-json" \
-H "danube-api-key: YOUR_API_KEY" | jq '.mcp_json' > .mcp.json
{
"file": ".mcp.json",
"scope": "project",
"mcp_json": {
"mcpServers": {
"danube": {
"type": "http",
"url": "https://mcp.danubeai.com/mcp",
"headers": {
"danube-api-key": "${DANUBE_API_KEY}",
"danube-org-id": "8f0c2c4e-6c1b-4f7e-9d2a-3b5e1a9c7d10"
}
}
}
},
"org": {
"org_id": "8f0c2c4e-6c1b-4f7e-9d2a-3b5e1a9c7d10",
"org_name": "Acme Robotics",
"org_slug": "acme-robotics",
"role": "admin"
},
"instructions": "Commit this as .mcp.json at the repo root (project scope). Each engineer sets DANUBE_API_KEY in their environment ... Equivalent CLI: claude mcp add --transport http --scope project danube https://mcp.danubeai.com/mcp --header 'danube-api-key: ${DANUBE_API_KEY}' --header 'danube-org-id: 8f0c2c4e-6c1b-4f7e-9d2a-3b5e1a9c7d10'"
}
Claude Code
Get MCP JSON
Generate a ready-to-commit project-scope .mcp.json for a Claude Code team rollout
GET
/
v1
/
claude-code
/
mcp-json
curl -s "https://api.danubeai.com/v1/claude-code/mcp-json" \
-H "danube-api-key: YOUR_API_KEY"
curl -s "https://api.danubeai.com/v1/claude-code/mcp-json" \
-H "danube-api-key: YOUR_API_KEY" | jq '.mcp_json' > .mcp.json
{
"file": ".mcp.json",
"scope": "project",
"mcp_json": {
"mcpServers": {
"danube": {
"type": "http",
"url": "https://mcp.danubeai.com/mcp",
"headers": {
"danube-api-key": "${DANUBE_API_KEY}",
"danube-org-id": "8f0c2c4e-6c1b-4f7e-9d2a-3b5e1a9c7d10"
}
}
}
},
"org": {
"org_id": "8f0c2c4e-6c1b-4f7e-9d2a-3b5e1a9c7d10",
"org_name": "Acme Robotics",
"org_slug": "acme-robotics",
"role": "admin"
},
"instructions": "Commit this as .mcp.json at the repo root (project scope). Each engineer sets DANUBE_API_KEY in their environment ... Equivalent CLI: claude mcp add --transport http --scope project danube https://mcp.danubeai.com/mcp --header 'danube-api-key: ${DANUBE_API_KEY}' --header 'danube-org-id: 8f0c2c4e-6c1b-4f7e-9d2a-3b5e1a9c7d10'"
}
Overview
Returns the exact.mcp.json content to commit at a repository root so every Claude Code seat in that repo connects to Danube under one organization. The API key is the placeholder ${DANUBE_API_KEY}, which Claude Code expands from each engineer’s environment at connect time, so no secret lands in the repo. When an organization resolves for the caller, a danube-org-id header pins every seat to it.
The organization is resolved the same way as Get Org Context: explicit selector, then the key’s bound organization, then the personal organization. If resolution fails for a reason other than 401 or 404, the template is still returned with org set to null and no danube-org-id header.
The step-by-step rollout is in the Claude Code guide.
Auth: Accepts either JWT or API key (danube-api-key header).
The Python and TypeScript SDKs do not wrap this endpoint yet. Call it directly.
Query Parameters
string
Organization UUID to pin. Requires membership.
Headers
string
Same as
org_id. Ignored when the query parameter is present.Response
string
Always
.mcp.jsonstring
Always
projectobject
object
string
Human-readable commit instructions, including the equivalent
claude mcp add commandErrors
| Code | Meaning |
|---|---|
| 401 | No credentials, or no profile exists for the caller |
| 404 | The selected organization does not exist or the caller is not a member |
Example
curl -s "https://api.danubeai.com/v1/claude-code/mcp-json" \
-H "danube-api-key: YOUR_API_KEY"
curl -s "https://api.danubeai.com/v1/claude-code/mcp-json" \
-H "danube-api-key: YOUR_API_KEY" | jq '.mcp_json' > .mcp.json
{
"file": ".mcp.json",
"scope": "project",
"mcp_json": {
"mcpServers": {
"danube": {
"type": "http",
"url": "https://mcp.danubeai.com/mcp",
"headers": {
"danube-api-key": "${DANUBE_API_KEY}",
"danube-org-id": "8f0c2c4e-6c1b-4f7e-9d2a-3b5e1a9c7d10"
}
}
}
},
"org": {
"org_id": "8f0c2c4e-6c1b-4f7e-9d2a-3b5e1a9c7d10",
"org_name": "Acme Robotics",
"org_slug": "acme-robotics",
"role": "admin"
},
"instructions": "Commit this as .mcp.json at the repo root (project scope). Each engineer sets DANUBE_API_KEY in their environment ... Equivalent CLI: claude mcp add --transport http --scope project danube https://mcp.danubeai.com/mcp --header 'danube-api-key: ${DANUBE_API_KEY}' --header 'danube-org-id: 8f0c2c4e-6c1b-4f7e-9d2a-3b5e1a9c7d10'"
}