Metadata-Version: 2.4
Name: mcp-ivolatility-data
Version: 0.1.7
Summary: iVolatility market data in any MCP client: option chains, IV surface/IVX/skew, greeks, NBBO, earnings
Project-URL: Homepage, https://www.ivolatility.com
Project-URL: Documentation, https://www.ivolatility.com/api-features/
Author-email: iVolatility <support@ivolatility.com>
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.12
Requires-Dist: certifi>=2026.2.25
Requires-Dist: httpx>=0.28.1
Requires-Dist: mcp>=1.27.0
Requires-Dist: numpy>=2.4.4
Requires-Dist: pydantic>=2.12.5
Requires-Dist: python-dotenv>=1.2.2
Requires-Dist: pyyaml>=6.0
Requires-Dist: sqlglot>=30.4.0
Description-Content-Type: text/markdown

# mcp-ivolatility-data

iVolatility market data MCP server for local use by data-oriented clients
(quants with their own Claude, Cursor, or any MCP client). One package ships
the engine (`ivol_mcp_core`) and the bundled endpoint index, and runs the tools
(`search_endpoints` → `call_api` → `query_data`) against the iVolatility REST API.

No hosting — the client installs it locally and uses their own `IVOL_API_KEY`.
Access control stays on the REST API (tariff/limits by key).

## Install

```bash
uv tool install mcp-ivolatility-data
claude mcp add ivolatility -e IVOL_API_KEY=<key> -- mcp-ivolatility-data
```

Or any `mcp.json`-style client (Cursor, …): `command: mcp-ivolatility-data`,
`env: {IVOL_API_KEY: <key>}`. `uv` brings its own Python — the client does not
install Python manually. Claude Desktop users: prefer the `.mcpb` bundle
(double-click install, key form) or the remote connector URL.

## What it covers

65 endpoints: full REST (equities/futures EOD+intraday, RT REST, fixed income,
curves) from the bundled OpenAPI spec, plus `/account/access` and WebSocket
discovery from the prompt supplement. (RT market-wide screeners intentionally
excluded.)

## Env

| Var | Required | Purpose |
|-----|----------|---------|
| `IVOL_API_KEY` | yes | iVolatility API key (sent as `?apiKey=`) |
| `IVOL_API_BASE_URL` | no | defaults to `https://restapi.ivolatility.com` |

Index sources (`openapi_ivolatility.yml`, `index_supplement.yml`) are bundled
with the package; `IVOL_OPENAPI_PATH` / `IVOL_SUPPLEMENT_PATH` override them.
