Model Context Protocol

A hosted MCP server for medical chronologies

MCP is the open standard that lets AI agents call external tools without custom glue code. Point any MCP-capable client at Chartely’s endpoint and it gets real, page-cited chronology building as a first-class tool, no wrapper to write, no guessed dates to trust.

REST API docs

Setup

Add the server

Streamable HTTP transport, JSON-RPC 2.0, MCP protocol 2024-11-05, one URL, no local process to run.

Endpoint:

https://chartely.com/api/mcp

Config snippet for Claude Code, Claude Desktop, Cursor or any client that reads a mcpServers map. The Authorization header is optional, omit it to call anonymously at the anonymous rate limit (a throttled trial; the Free plan itself has no API/MCP access. Pro or Scale unlocks it).

mcp config

{
  "mcpServers": {
    "chartely": {
      "url": "https://chartely.com/api/mcp",
      "headers": {
        "Authorization": "Bearer cty_live_..."
      }
    }
  }
}

Tools

What the server exposes

Three tools, the same extraction engine and saved-chronology store the REST API and the website use.

build_chronology

Build a full page-cited chronology from a case record set - pass text, file_url or file_base64 (+file_name), optional matter_name/matter_type.

{ "file_url": "https://example.com/records.pdf", "matter_type": "personal_injury" }

extract_medical_events

Lightweight extraction from already-extracted text - returns just the events array, no persistence.

{ "text": "..." }

get_chronology

Fetch one previously built chronology by id, with its events.

{ "id": "CHRONOLOGY_ID" }

tools/call request

POST https://chartely.com/api/mcp
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "build_chronology",
    "arguments": { "file_url": "https://example.com/records.pdf" }
  }
}

response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [{
      "type": "text",
      "text": "{ \"chronology_id\": \"chr_2b7f\", \"status\": \"completed\", \"event_count\": 5, \"gaps\": [ ... ], \"confidence\": 0.91, \"request_id\": \"req_2b7f\" }"
    }]
  }
}

Anonymous calls are rate-limited to 4/min and 20/day per IP, enough to try the server from an agent config, not enough to build on. Pass Authorization: Bearer <key> (create one in Settings → API keys) for production limits: 120/min on Pro, up to 600/min on Scale. See pricing for the full table.

Chartely organizes the medical records you provide. It is not legal or medical advice, and automated extraction can misread poor-quality scans. Review the chronology before you rely on it. Every event links to its source page, so review takes minutes, not days.