Create a read-only link to a collection timeline (internal)

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://docs.usehearsay.com/mcp

Standard setup for AI tools providing an mcp.json file

{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}

POST /admin/collection-ops/collections/{codeId}/claude-link

Access token

Mints a signed, read-only link to the code's markdown timeline, valid for the configured number of days (7 by default, at most 30), and records it on the timeline. A link cannot be revoked on its own. Returns 503 when the link secret is not configured and 404 when the code has no collection state. Super admin only; 404 while the collection-ops console is turned off.

Path parameters

codeId string Required

Id of the extraction code

Responses

200 application/json
Hide response attributes Show response attributes object
- data object Required
  
  Hide data attributes Show data attributes object
  
  url string Required
  
  expiresAt string(date-time) Required
- statusCode number Required
- timestamp string(date-time) Required

POST /admin/collection-ops/collections/{codeId}/claude-link

curl \
 --request POST 'http://api.example.com/admin/collection-ops/collections/{codeId}/claude-link' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "data": {
    "url": "https://api.example.com/public/collection-ops/timeline/eyJjIjoiNjVhMWIyYzMifQ.c2lnbmF0dXJl",
    "expiresAt": "2026-01-15T10:30:00.000Z"
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}