Documentation

How to connect your AI agent to KeyVex and query the 60+ tools. The free public endpoint needs no account or API key — point your MCP client at it and go. It's rate-limited; accounts and higher-quota tiers are rolling out (see below).

What is KeyVex

KeyVex is a public-data API for US financial and government disclosures — SEC filings, congressional trades, FEC campaign finance, federal contracts and grants, lobbying, regulatory enforcement, sanctions, macroeconomic indicators, and more. It's built agent-first and delivered as a remote Model Context Protocol (MCP) server, so any MCP client — Claude, Cursor, or your own agent — connects once and can query all 60+ tools with no glue code. And because the endpoint is plain HTTP, you can also call it directly with curl or any HTTP client — handy for non-agent, programmatic use.

All data is public-record information sourced directly from US government agencies. KeyVex normalizes and indexes it; KeyVex does not provide investment advice, derived signals, or trading recommendations.

Quickstart

1. Start on the free tier — no signup needed

KeyVex's free public MCP endpoint is openly accessible — no account, no API key, no consent flow. Point your client at the URL below and start calling tools. The free endpoint is rate-limited (see Rate limits); for higher volume, see Accounts & tiers.

2. Choose your AI

KeyVex has two MCP endpoints — same 60+ tools on both:

https://mcp.keyvex.com        # free public endpoint — no account, rate-limited per IP
https://mcp.keyvex.com/pro    # sign in with your KeyVex account — your plan's quota + history

Pick your client for step-by-step setup:

Claude ChatGPT Cursor Windsurf VS Code

Using something else? Any client that speaks MCP's standard Streamable HTTP transport works — point it at https://mcp.keyvex.com; the free endpoint needs no authentication headers.

claude mcp add --transport http keyvex https://mcp.keyvex.com

claude mcp add --transport http keyvex https://mcp.keyvex.com/pro \
  --header "Authorization: Bearer kvx_live_YOUR_KEY"

{
  "mcpServers": {
    "keyvex": {
      "url": "https://mcp.keyvex.com/pro",
      "headers": { "Authorization": "Bearer kvx_live_YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "keyvex": {
      "serverUrl": "https://mcp.keyvex.com/pro",
      "headers": { "Authorization": "Bearer kvx_live_YOUR_KEY" }
    }
  }
}

{
  "servers": {
    "keyvex": {
      "type": "http",
      "url": "https://mcp.keyvex.com/pro",
      "headers": { "Authorization": "Bearer kvx_live_YOUR_KEY" }
    }
  }
}

3. Make a query

Ask your agent something that touches KeyVex data:

"Show me the largest congressional trades in the past 30 days
 with party and committee context."

The agent will pick the right tools (get_congressional_trades and get_member_profile), run them in parallel, and synthesize an answer.

4. Verify with curl (optional)

You can hit the endpoint directly without any client. Health check:

curl https://mcp.keyvex.com/

Returns server version, tool count, and the full tool list as JSON. List all tools via MCP:

curl -X POST https://mcp.keyvex.com/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

No Authorization header is needed. The response is a JSON-RPC envelope containing the full schema of every tool.

Authentication, accounts & tiers

The free endpoint stays open because every tool serves data already public by federal mandate (SEC filings, USAspending records, congressional disclosures, etc.) — there's nothing user-specific to gate on, and skipping auth removes a setup step for the agent developer.

Abuse prevention. Because the free endpoint is open, two mechanisms protect it from runaway use:

• A per-IP rate limit caps each calling IP at 60 requests per 60-second sliding window. Exceed it and the endpoint returns HTTP 429 with a Retry-After header.
• A Cloud Run instance cap bounds the worst-case server load even under a coordinated flood.

Accounts & higher tiers. You can create a free account at keyvex.com (email, Google, or phone) and we'll issue you an API key — keys are stored only as a hash, never in the clear. Your account's plan (Free / Pro / Premium) sets your daily call quota and history window on both the REST API and the /pro MCP endpoint below. The free public endpoint at mcp.keyvex.com stays authless and free.

Use your plan in Claude — the /pro connector

To use your KeyVex account's tier through Claude (or any OAuth-capable MCP client), connect to the account-aware endpoint instead of the public one:

https://mcp.keyvex.com/pro

Here's the flow, step by step:

• 1. Add the connector. In Claude's Connectors settings, add a custom connector pointing at https://mcp.keyvex.com/pro. It connects immediately — the tool list loads without signing in.
• 2. Sign in on first use. The first time Claude actually calls a tool, it shows an inline Connect card. Click it, sign in with your KeyVex account (the same login as keyvex.com), and Claude retries the call automatically. One-time step per client.
• 3. Your plan applies live. Every call is metered at your account's current tier — daily quota and history window (Free: 1 year · Pro: 5 years · Premium: full archive). Upgrades and downgrades take effect on your very next call; there's nothing to reconnect or refresh.

Prefer your API key? Header-capable clients — Claude Code, Cursor, scripts — can skip OAuth entirely and send the same kvx_live_ key you use on the REST API, as either header:

# Claude Code
claude mcp add --transport http keyvex https://mcp.keyvex.com/pro \
  --header "Authorization: Bearer kvx_live_YOUR_KEY"

# or raw HTTP — x-api-key works too
curl -X POST https://mcp.keyvex.com/pro \
  -H "x-api-key: kvx_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_congressional_trades","arguments":{"ticker":"NVDA"}}}'

An expired or invalid credential returns 401 — Claude responds by refreshing its token or re-showing the Connect card, so a stale session heals itself. The tool surface is identical on both endpoints; the only differences are quota and history depth.

REST API (HTTP)

Besides the MCP connector, KeyVex exposes the same data as a plain REST API at https://api.keyvex.com — for AI-generated scripts, agents, and apps that make ordinary HTTP requests instead of speaking MCP. If you ask an AI to "build me something with KeyVex," this is the surface its code calls.

Base URL & OpenAPI spec

The machine-readable OpenAPI 3.1 spec lists every endpoint and parameter — point any AI at it and it can write correct code on the first try:

https://api.keyvex.com/openapi.json

Authentication

The REST API is key-only (unlike the free MCP endpoint). Create a free account at keyvex.com, generate a key, and send it on every request in the x-api-key header:

curl "https://api.keyvex.com/v1/congressional-trades?ticker=NVDA" \
  -H "x-api-key: YOUR_KEY"

Endpoints

All 60+ tools are exposed as GET /v1/<name> — the tool name without the get_ prefix, hyphenated. A few examples:

GET /v1/congressional-trades?ticker=NVDA
GET /v1/insider-transactions?ticker=AAPL
GET /v1/institutional-holdings
GET /v1/federal-contracts
GET /v1/lobbying-filings
GET /v1/material-events

Responses are JSON — { "results": [...], "count": N, "has_more": bool }. See the OpenAPI spec for the full list of all 54 endpoints and their parameters.

Tool reference

KeyVex exposes 60+ tools. All are read-only. Every tool's full schema (parameters, filters, response shape) is returned by the MCP tools/list method. The table below is a one-line summary.

SEC filings & market structure

Congressional activity

Campaign finance & influence

Federal awards

Regulatory & compliance

Macroeconomic & markets

Innovation & IP

Reference & market data

unified_search

unified_search is the cross-source meta-tool. Pass one or more identifiers (ticker, company_name, cusip, company_cik, bioguide_id, recipient_uei) and it fans out across every applicable tool in parallel, returning a unified envelope.

Useful when you want a full picture of an entity without manually calling 10 tools:

{
  "method": "tools/call",
  "params": {
    "name": "unified_search",
    "arguments": { "ticker": "NVDA" }
  }
}

The fan-out hits insider transactions, congressional trades, institutional holdings, activist stakes, federal contracts, material events, fundamentals, and more — whichever tools match the identifier you passed. get_lobbying_filings is the one collection deliberately excluded from the fan-out (substring scans on 51K+ filings are too slow to parallelize); call it directly for lobbying queries.

Rate limits

How KeyVex meters usage depends on how you connect.

Authless public endpoint. The open mcp.keyvex.com endpoint needs no account or key — it exists so MCP clients and connectors (for example the Claude Connector, where users can't sign up to test) can call it immediately. Access is restricted, and it's rate-limited per IP at 60 requests per 60-second sliding window. Exceed the window and the endpoint returns HTTP 429 with a Retry-After header indicating how long to wait.

Authenticated tiers. Create an account and send an API key for a higher, per-account daily quota that resets at midnight Eastern:

• Free — 60 calls / day, all datasets, 1 year of history.
• Pro — 10,000 calls / day, all datasets, 5 years of history.
• Premium — 100,000 calls / day, all datasets, full historical archive.

History windows. Time-series datasets return records within your tier's window (Free/keyless: 1 year · Pro: 5 years · Premium: full archive). Every response subject to a window carries a history_floor field plus a history_note so agents always know the range they're seeing. Reference datasets (member profiles, sanctions & screening lists, OIG exclusions, foreign-agent registrations, economic indicators) are always served in full — capping a current-state compliance list would make it wrong, so we don't.

Exceed your daily quota and calls return HTTP 429 with a Retry-After header until the next reset. A server-side concurrent instance cap additionally bounds worst-case load under coordinated traffic — you should never see it unless you're actively trying to flood the server.

For most agent workflows (a few tool calls per user question, the occasional batch catch-up) you'll never hit a limit. To raise your quota or extend your history window, see Accounts & tiers or compare plans.

Data freshness

Two different clocks govern how current a record is, and it helps to keep them separate.

1. Poll cadence — how often KeyVex re-checks each source. KeyVex caches normalized data in Firestore and refreshes it on this schedule:

• SEC filings (most types): hourly
• SEC Form 4: every 30 minutes
• 13F: every 4 hours
• Congressional trades: daily, 6 AM ET
• FEC contributions, federal contracts, lobbying: daily
• Bills, votes, member profiles: daily
• XBRL fundamentals: weekly
• FARA, OFAC, screening lists, recalls: daily
• Economic indicators: daily

2. Source-publication lag — how recent the data itself can be. Several agencies publish in batches well after the events they describe, so the newest record a tool can return is bounded by the source's own release schedule — not by how often KeyVex polls. Polling every 30 minutes cannot surface data the SEC has not published yet. The main lagged sources:

• Fails-to-deliver (get_sec_fails_to_deliver): SEC publishes a half-month batch ~2-4 weeks after that half-month closes, so the latest settlement date typically trails today by 2-4 weeks.
• Product recalls (get_product_recalls): FDA / CPSC datasets commonly post 4-6 weeks after a recall is initiated.
• 13F institutional holdings (get_institutional_holdings): funds file quarterly, up to 45 days after quarter-end — a quarterly snapshot, never intraday.
• N-PORT fund holdings (get_fund_holdings, get_nport_filings): monthly filings released on a ~30-60 day public-availability delay.
• Congressional PTRs (get_congressional_trades): members may file up to 30-45 days after a trade, so the disclosure date lags the trade date.

So a record from a few weeks ago on a lagged tool is the source operating normally, not a stale cache. Each tool response includes a scraped_at or last_modified_date field showing exactly when KeyVex last polled, and lagged tools restate their own publication cadence in the tool description.

Troubleshooting

Support

For privacy, terms, and data-handling questions, see the privacy policy. For status and version, see the public health check at https://mcp.keyvex.com/ (returns server version and current tool list as JSON, no authentication required).