MCP server · live
Your cited data,in any AI agent.
Convexity's API is exposed as a Model Context Protocol server – the open standard for handing tools to AI agents. Point Claude Code, Claude Desktop, or any MCP-capable client at one endpoint, and your agent pulls quotes, scores, screens, and reference data – each answer stamped with the moment it was measured.
https://convexityos.com/api/v1/mcpStreamable HTTP“As of 2026-07-21, NVDA sits in the 87th percentile.”the agent cites, instead of guessing
38 tools4 scopes1 endpoint0 write / trade100% carry data_as_of
Two lines, and the round trip begins.
Authentication is the same bearer key as the REST API, sent as anAuthorization header. Mint one from the/settings/developer dashboard; the key shows its plaintext value once, so store it before closing the panel.
claude mcp add --transport http convexity https://convexityos.com/api/v1/mcp \
--header "Authorization: Bearer YOUR_KEY"{
"mcpServers": {
"convexity": {
"type": "http",
"url": "https://convexityos.com/api/v1/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}Thirty-eight read-only tools, scoped per key.
Each tool requires the scope beside it; a key that lacks the scope gets403. No write tools, no order placement, no trade execution – the server reads, it never writes. The seven below are a representative slice; the full set (including the ontology-graph and portfolio reads) is in theAPI reference.
get_quotequote:readCurrent quotes for up to 25 tickers.get_price_historyquote:readOHLCV history for one ticker, ranges 1D through ALL.get_convexity_scorescore:readLatest Convexity Score with factor contributions and sector percentile.get_company_referencedata:readCompany profile, key stats, valuation fields.
run_screenerdata:readScreen US equities by score, sector, market cap, valuation ratios, insider buys, and more.get_company_eventsdata:readUpcoming earnings plus recent actuals vs estimates.get_related_companiesdata:readPeers, sector members, and supply-chain counterparties.
Read-only. All thirty-eight tools, with request/response shapes, in the API reference.
It meters like the REST API. It dates every answer. It cannot write.
Every tool call draws against the same per-minute and per-day rate limits and the same monthly cap as the REST API. The handshake (initialize, tools/list) is free – only real data requests are metered.
Tool results return a DataEnvelope whosemeta.data_as_of is computed from the data itself, not request time. The agent cites “as of2026-07-21” instead of presenting stale data as current.
Every tool reads; there is no write path and no trade execution. Most need only public-data scopes; the portfolio tools read the key owner's own book and nothing else, and still cannot write or trade. The worst a leaked key can do is read data within its scopes until you revoke it from the dashboard.
Give your agent market data it can cite.
API access is included with Developer ($99/mo), Quant, andPro Plus. Mint a key, paste two lines, and Convexity is a tool your agent can call.
CONVEXITY MCP · PROTOCOL/v1 · read-only · every result dated