chartlibrary-mcp 1.0.2

Chart Library MCP Server — pattern intelligence for AI agents

Chart Library MCP Server

A compliance-safe way for AI agents to discuss stocks using real historical data.

Instead of hallucinating predictions or refusing to answer, your agent can say: "The last 10 times a chart looked like NVDA, 7 went up over 5 days (avg +3.1%)." This is factual historical data from 24 million pattern embeddings across 10 years and 15,000+ stocks — not financial advice, not predictions, just what happened before.

Install

pip install chartlibrary-mcp

Usage with Claude

# Claude Code
claude mcp add chart-library -- chartlibrary-mcp

# Or run directly
CHART_LIBRARY_API_KEY=cl_your_key chartlibrary-mcp

Tools

Tool	Description
analyze_pattern	Search + forward returns + AI summary (recommended)
search_charts	Find 10 most similar historical patterns
get_follow_through	Forward returns (1/3/5/10-day) for matches
get_pattern_summary	AI-generated plain-English summary
get_discover_picks	Daily top patterns ranked by interest score
search_batch	Multi-symbol parallel search (up to 20)
get_status	Database stats and coverage

Example Conversation

User: What does NVDA's chart look like right now?

Claude (using Chart Library): NVDA's current pattern matches 10 historical setups. The closest is AAPL from May 2016 (93% similarity). Of the 10 matches, 8 went up over 5 days with an average gain of +3.0%. The current market regime resembles the post-SVB period of early 2023, which historically resolved bullishly.

API Key

Get a free API key (500 calls/day) at chartlibrary.io/developers.

Set it as an environment variable:

export CHART_LIBRARY_API_KEY=cl_your_key

Links

• Website: chartlibrary.io
• API Docs: chartlibrary.io/api/docs
• Developer Portal: chartlibrary.io/developers
• Regime Tracker: chartlibrary.io/regime