Skip to main content

iVolatility market data in any MCP client: option chains, IV surface/IVX/skew, greeks, NBBO, earnings

Project description

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_endpointscall_apiquery_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

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_ivolatility_data-0.1.7.tar.gz (372.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_ivolatility_data-0.1.7-py3-none-any.whl (126.3 kB view details)

Uploaded Python 3

File details

Details for the file mcp_ivolatility_data-0.1.7.tar.gz.

File metadata

  • Download URL: mcp_ivolatility_data-0.1.7.tar.gz
  • Upload date:
  • Size: 372.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for mcp_ivolatility_data-0.1.7.tar.gz
Algorithm Hash digest
SHA256 9199d508049a541025f65b36ee65dbe99716166ea9f42fd43a5c90b61a07e390
MD5 622b625be6719af47bae430076435e30
BLAKE2b-256 2dfb7fd661a8d1a9d3ea06fd317e320ba65dbd3fc015ea2c6e4adf229430e95d

See more details on using hashes here.

File details

Details for the file mcp_ivolatility_data-0.1.7-py3-none-any.whl.

File metadata

  • Download URL: mcp_ivolatility_data-0.1.7-py3-none-any.whl
  • Upload date:
  • Size: 126.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for mcp_ivolatility_data-0.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 96add58811b5cf04b852d75a6243fa0dc292ed70182881760cb8a643406a7514
MD5 015af70703184c3e4c1cc001acb5ac07
BLAKE2b-256 e9ae3b53c78fda4376478083ad205ccbef43428bb16fce3bc2ee7294350c54c5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page