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.6.tar.gz (369.8 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.6-py3-none-any.whl (123.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mcp_ivolatility_data-0.1.6.tar.gz
  • Upload date:
  • Size: 369.8 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.6.tar.gz
Algorithm Hash digest
SHA256 b7f514f9899056f2f49785bb084372c67d1f01a9f20a3409562670f5ea1a3662
MD5 d2f3ae9f2409bce23455c03d4879d797
BLAKE2b-256 9476c4fd2925307918fb2f3d53d198f086c291e57dd6e07319fb33b133deaa31

See more details on using hashes here.

File details

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

File metadata

  • Download URL: mcp_ivolatility_data-0.1.6-py3-none-any.whl
  • Upload date:
  • Size: 123.7 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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 a7815f29ad2b20893f00c4f843715b23a07608e44e7af1d66b48582a5102a66f
MD5 1f1d4f6024edd7aae6b81f7b1031c209
BLAKE2b-256 baebc2e18dc0d51905cfa186160fa06d9d60f05f3457d5f7f3c832315b4a9c04

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