grahammccain/chart-library-mcp

Market memory for AI, with published research for agents and people.
Version 6.3.3 marks failed public tool calls as MCP errors while preserving their
structured recovery details. Invalid requests explain how to correct the inputs;
stale publication versions retain instructions to restart from the current overview.
Successful response schemas and direct Python calls remain compatible.
Five read-only tools
| Tool | Input | Result |
| --- | --- | --- |
| market_state | Symbol; optional date | Completed-session state, historical analogs, outcome ranges, transition memory and tape |
| daily_note | Optional date | Published daily research, selection rule and settled-note tally |
| research_quality | None | Published calibration receipt, dated sample and qualifications |
| search_research | Query; optional kind, limit and offset | Relevant publications, IDs, findings, sample receipts, limitations and versions |
| read_research | Research ID; optional section, offset and version | Overview or an exact source document, with pagination and hashes |
Market-state requests need no preliminary search or cohort handle. For published
research, search for an ID, then read its evidence.
Example question: “Read AAPL's latest completed-session state. Report the
historical analog ranges, sample sizes, session date and limitations.”
Omitting date uses the latest built/published session, not a real-time quote.
Dates use YYYY-MM-DD. Missing or thin evidence stays missing or thin.
Connect
The primary remote endpoint is **https://chartlibrary.io/mcp**, using
Streamable HTTP and no authentication.
For a command-based client, install or upgrade the package:
Then use the equivalent of this configuration in your MCP client:
No API key or server-side Python packages are required. An optional
CHART_LIBRARY_API_KEY is forwarded as a Bearer token when set. An empty key
does not send an Authorization header. CHART_LIBRARY_API_URL can select your
own compatible endpoint; only point it at a server you trust with that key.
Python 3.10+ is required. This release uses the MCP 1.x FastMCP interface and
pins mcp>=1.28.1,<2.0.0; MCP 2.x is a separate migration.
The equivalent HTTP calls
Use only the call relevant to the question. For a historical state add
&date=YYYY-MM-DD. Daily REST requests call the date parameter session.
Research workflow
Replace FULL_VERSION_FROM_SEARCH with the full 64-character version from the chosen
search result. Updated servers supply documents[section].read_arguments directly;
copy those into the tool and follow content.next_read until null. With earlier
servers, pass the returned version and next_offset explicitly. Omitting the optional
version reads the current publication without checking it against earlier responses.
A changed version returns an error explaining how to restart from the current
overview; the client does not retry automatically.
Search summaries are discovery metadata, not a source read. Read available guides
and relevant limiting findings before making claims. Keyword search ranks document