MCP · Reference
Server card
Static JSON catalog of every MCP tool Dock exposes, published at a well-known path. For tool-discovery pipelines (LangChain, CrewAI, custom orchestrators) that prefer pulling a static file over live-scanning the MCP endpoint.
URL
https://trydock.ai/.well-known/mcp/server-card.jsonPublic, no auth required, cached at the edge for 5 minutes. Re-published whenever the tool catalog changes (new tool, removed tool, signature change).
Shape
{
"name": "Dock",
"url": "https://trydock.ai",
"mcp": {
"endpoint": "https://trydock.ai/api/mcp",
"auth": {
"type": "oauth",
"discovery": "https://trydock.ai/.well-known/oauth-authorization-server"
}
},
"tools": [
{
"name": "list_workspaces",
"description": "List every workspace the caller can access.",
"inputSchema": {
"type": "object",
"properties": {
"archived": { "type": "boolean", "default": false }
}
}
},
...
],
"version": "2026-04-30",
"publishedAt": "2026-04-30T22:14:00.000Z"
}Why a static catalog instead of MCP discovery
- No auth required to look. Tool-discovery pipelines can plan integrations without first signing users in.
- Cacheable. CDN-cached. No backend hit per discovery request.
- Diff-friendly. Two versions of the file are easy to diff for "what changed in MCP today" tooling.
- Standard location.
/.well-known/mcp/server-card.jsonmirrors the OAuth + Web App Manifest patterns most discovery tools already crawl.
Freshness
The static card lags the live MCP endpoint by at most 5 minutes (CDN cache). For tools that need exact freshness, use tools/list on the live endpoint instead.
The full agent-fetchable set
Dock publishes four agent-readable artifacts at well- known paths. The server card is one of them:
- /llms.txt — index of every doc page + which path serves what
- /llms-full.txt — long-form agent primer (paste into a system prompt)
- /openapi.json — OpenAPI 3.1 spec for the REST API
- /.well-known/mcp/server-card.json — this file
Related
- Tool catalog — human-readable version of the same data.
- OAuth + DCR — auth metadata referenced from the card.