Metadata-Version: 2.4
Name: prysmatic-mcp
Version: 0.1.1
Summary: Query the Prysmatic API (tracked wallets and tokens) from Claude and other MCP clients.
Project-URL: Homepage, https://prysmatic-sol.xyz
Project-URL: Documentation, https://docs.prysmatic-sol.xyz
Author-email: eserya <eserya77@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: claude,mcp,model-context-protocol,prysmatic,solana
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=1.2.0
Description-Content-Type: text/markdown

# Prysmatic MCP

Lets Claude (or any MCP client) query the Prysmatic API with your API key. It adds
five tools for looking up tracked wallets and tokens. Each call uses your credits,
just like the REST API.

## Tools

| Tool | What it returns |
|------|-----------------|
| `list_wallets(page=1)` | Tracked wallets, 25 per page |
| `wallet_metrics(alias)` | Metrics for one wallet |
| `wallet_holdings(alias)` | Tokens a wallet currently holds |
| `tokens_held(min_wallets=2, page=1)` | Tokens held by several wallets |
| `token_swaps(mint, aggregate=False, tracked_only=True)` | Wallet swaps on a token |

## Requirements

- Python 3.10+
- A Prysmatic API key with credits (from the dashboard).

## Add to Claude

Easiest (no install, needs [uv](https://docs.astral.sh/uv/)):

```
claude mcp add prysmatic -e PRYSMATIC_API_KEY=<your_key> -- uvx prysmatic-mcp
```

Or install it first:

```
pipx install prysmatic-mcp
claude mcp add prysmatic -e PRYSMATIC_API_KEY=<your_key> -- prysmatic-mcp
```

## Configuration

| Env var | Required | Default |
|---------|----------|---------|
| `PRYSMATIC_API_KEY` | yes | — |
| `PRYSMATIC_API_BASE` | no | `https://api.prysmatic-sol.xyz` |

## Errors

Tools return a readable message instead of crashing: bad/missing key (401),
out of credits (402), or not found (404).
