
MCP server for Chart Library — visual chart pattern search engine. Find similar historical stock
MCP server for Chart Library — visual chart pattern search engine. Find similar historical stock charts and see what happened next.
·
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.
| 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.
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:
python -m pip install --upgrade chartlibrary-mcpThen use the equivalent of this configuration in your MCP client:
{
"mcpServers": {
"chartlibrary": {
"command": "chartlibrary-mcp"
}
}
}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.
curl "https://chartlibrary.io/api/v1/state-packet?symbol=AAPL"
curl "https://chartlibrary.io/api/v1/daily"
curl "https://chartlibrary.io/api/v1/calibration"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.
search_research(query="IONQ noon", kind="casebook")
read_research(research_id="casebook:ionq-noon", section="article",
version="FULL_VERSION_FROM_SEARCH")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 relevance, not market similarity or evidence strength. A partial result means a publication source was unavailable. Withdrawn articles cannot be read. Publication dates and market cutoffs differ; the noon IONQ case must not be merged with completed-session state analogs.
Complete IONQ example · Agent research plan
research_quality audits only the method and population its receipt names.
Do not transfer its coverage percentage to every market state or all research.Research access is free. Service limits and underlying data terms still apply. Honor HTTP 429 and retry guidance; do not assume unlimited throughput.
Existing tool names stay registered and callable, including pull_comps,
search, state_packet, and the cohort inspection tools. To discover the
extended menu in a local client, set CHART_LIBRARY_MCP_PROFILE=advanced.
This changes discovery, not authorization or access to private research.
The public menu does not expose private fund operations or every experimental
state-memory method. Legacy examples in examples/ use the advanced interface.
For a custom integration, a larger study, or a product built on the memory, contact Graham McCain — [email protected].
Developer guide · Methodology · Data terms · Privacy
python -m pytest test_vendor_import.pyThe import smoke runs without an API key and without application services/
or db/ packages. No package or registry publication is performed by tests.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add chartlibrary -- chartlibrary-mcp{
"mcpServers": {
"chartlibrary": {
"command": "chartlibrary-mcp"
}
}
}code --add-mcp '{"name":"chartlibrary","command":"chartlibrary-mcp"}'[mcp_servers.chartlibrary]
command = "chartlibrary-mcp"Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/chart-library-mcp to learn what the "Chart Library MCP" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
This server runs locally, so we can't read its tool list over the web yet.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/chart-library-mcp)Nothing comparable is listed yet.
v6.3.36.3.3 - Actionable public MCP errorsRelease notesv5.3.0v5.3.0 — Anthropic Connectors Directory submission prepRelease notesv5.0.0v5.0.0 — clean 8-tool canonical surfaceRelease notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "chart-library-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.