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.5.tar.gz (368.4 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.5-py3-none-any.whl (122.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mcp_ivolatility_data-0.1.5.tar.gz
  • Upload date:
  • Size: 368.4 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.5.tar.gz
Algorithm Hash digest
SHA256 1d816602d58568ebf4e80de48077ac47b900e6d190b56eb5ac012157c0c3efcb
MD5 a2b86604818fbca2006e1d69aa131531
BLAKE2b-256 5bef4a73c0c9f7e96498b7523d4051c916dd7afa1cd8070d0a936c6de71424c4

See more details on using hashes here.

File details

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

File metadata

  • Download URL: mcp_ivolatility_data-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 122.6 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.5-py3-none-any.whl
Algorithm Hash digest
SHA256 574d290581f4ec39e90de48867d39c9060eb8d81267ceb89cfba34ddf6c5dd64
MD5 ea64e8c2690648220d41b13565970ab4
BLAKE2b-256 0eaf44b90f735d548de45dbfc88ce809984e0ae3936ee1f445427ff5fed04c01

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