Chart Library MCP
Free market-state research. One question, one call.
Version 6.2.0 introduces the same three-tool starting point as the hosted service. Existing integrations retain their callable tool names.
Three 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 |
Each tool works independently. No preliminary search or cohort handle is needed.
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:
python -m pip install --upgrade chartlibrary-mcp
Then 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.
The equivalent HTTP calls
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.
Read the evidence accurately
- Preserve dates, sample sizes, informative receipts, warnings and provenance.
- State-packet excess returns are percentage-point observations relative to a date-matched liquid-stock baseline. Each horizon has its own observed n.
- Raw historical percentiles are not automatically calibrated forecasts.
research_qualityaudits only the method and population its receipt names. Do not transfer its coverage percentage to every market state or all research.- Daily research has its own selection rule and settled-note tally.
- Historical frequencies are not recommendations to buy or sell.
Research access is free. Service limits and underlying data terms still apply. Honor HTTP 429 and retry guidance; do not assume unlimited throughput.
Existing integrations
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.
Build with us
For a custom integration, a larger study, or a product built on the memory, contact Graham McCain — graham@chartlibrary.io.
Developer guide · Methodology · Data terms · Privacy
Local verification
python -m pytest test_vendor_import.py
The import smoke runs without an API key and without application services/
or db/ packages. No package or registry publication is performed by tests.
1 maintainer
Release files for chartlibrary-mcp 6.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| chartlibrary_mcp-6.2.0.tar.gz | 39.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| chartlibrary_mcp-6.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 79.1 kB
Release files / chartlibrary_mcp-6.2.0.tar.gz
| Download URL | chartlibrary_mcp-6.2.0.tar.gz |
|---|---|
| Size | 39.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
643faaa51b4f815da96a3af4dd28f33f5ecacf1ec8acebd45d5cb0c12f6087a6
|
|
BLAKE2b-256 checksum How to use checksums |
1a0f04e5f169d8df28263f6c323bf3a11af4dc032e105f78fd85bce13c9907ce
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.2
|
Release files / chartlibrary_mcp-6.2.0-py3-none-any.whl
| Download URL | chartlibrary_mcp-6.2.0-py3-none-any.whl |
|---|---|
| Size | 40.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6d8e225f26bd3c17058bfb2d7e59102f3daa7937daaa1ccbaf03697a2ebafa66
|
|
BLAKE2b-256 checksum How to use checksums |
418123e12dd78ef5205efd33e8717c5a11631af57663eed6880d5f691d18c064
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.2
|
