Metadata-Version: 2.4
Name: chartlibrary-mcp
Version: 1.0.2
Summary: Chart Library MCP Server — pattern intelligence for AI agents
Author-email: Chart Library <graham@chartlibrary.io>
Project-URL: Homepage, https://chartlibrary.io
Project-URL: Documentation, https://chartlibrary.io/developers
Project-URL: Repository, https://github.com/grahammccain/chart-library-mcp
Keywords: mcp,chart patterns,stock analysis,AI agent,trading
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Office/Business :: Financial :: Investment
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE.bak
Requires-Dist: mcp>=1.0.0
Requires-Dist: requests>=2.28.0
Dynamic: license-file

# 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

```bash
pip install chartlibrary-mcp
```

## Usage with Claude

```bash
# 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](https://chartlibrary.io/developers).

Set it as an environment variable:
```bash
export CHART_LIBRARY_API_KEY=cl_your_key
```

## Links

- Website: [chartlibrary.io](https://chartlibrary.io)
- API Docs: [chartlibrary.io/api/docs](https://chartlibrary.io/api/docs)
- Developer Portal: [chartlibrary.io/developers](https://chartlibrary.io/developers)
- Regime Tracker: [chartlibrary.io/regime](https://chartlibrary.io/regime)

<!-- mcp-name: io.github.grahammccain/chart-library -->
