FinVector MCP server

SEC filing search for AI agents. Every answer cites the filing it came from.

FinVector is a hosted Model Context Protocol server and REST API. Ask a question in plain English and your agent gets back the passages from SEC filings, such as 10-Ks and 10-Qs, that answer it, best first, each with its company, form, filing date, section and a link to the filing on sec.gov.

• Cited, not summarised. Your agent quotes the filing, and verify_quote checks a quote word for word against its source.

• Search by meaning. Hybrid keyword and semantic search with reranking, so "dependence on one supplier" finds "single-source components".

• Screen by theme. screen_theme lists which companies discuss a theme, quarter by quarter, with who is new and who dropped out.

• One line to connect. Works in Claude Code, Cursor, Claude Desktop, VS Code, Codex, Gemini CLI, Zed, Cline and any client that speaks Streamable HTTP.

• Pay as you go. 1 cent a search, 2 cents a screen. New accounts get 500 free credits.

MCP endpoint   https://api.finvector.ai/v1/mcp
REST API       https://api.finvector.ai/v1   (OpenAPI: https://api.finvector.ai/v1/openapi.json)
Docs           https://app.finvector.ai/api-docs

Get started

1. Sign up at app.finvector.ai and create an API key on the Keys page. It is shown once, so copy it.

2. Put the key in your environment: export FINVECTOR_API_KEY=fv_prod_...

3. Add FinVector to your tool (below), then try one of the example prompts.

The key goes in a header, Authorization: Bearer <key> or X-API-Key: <key>. Never put it in a URL: FinVector refuses a key sent as a query parameter.

Related MCP server: Signal8 MCP Server

Connect your tool

Claude Code

claude mcp add --transport http finvector https://api.finvector.ai/v1/mcp --header "Authorization: Bearer $FINVECTOR_API_KEY"

Or share it with your team through a project .mcp.json, which reads each person's own key: examples/claude-code.mcp.json.

Cursor

Save as ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project): examples/cursor.mcp.json

{
  "mcpServers": {
    "finvector": {
      "url": "https://api.finvector.ai/v1/mcp",
      "headers": { "Authorization": "Bearer ${env:FINVECTOR_API_KEY}" }
    }
  }
}

Claude Desktop

Claude Desktop connects through mcp-remote, a small bridge that runs on your computer. Open Settings > Developer > Edit Config and add: examples/claude_desktop_config.json

{
  "mcpServers": {
    "finvector": {
      "command": "npx",
      "args": ["mcp-remote", "https://api.finvector.ai/v1/mcp", "--transport", "http-only", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer <your API key>" }
    }
  }
}

Restart Claude Desktop after saving. It needs Node.js for npx.

VS Code (GitHub Copilot)

Run MCP: Open User Configuration and add: examples/vscode.mcp.json. VS Code asks for the key once and stores it securely.

More clients

Claude.ai and ChatGPT connect through sign-in (OAuth), which is coming soon.

Check that your key works:

curl -s https://api.finvector.ai/v1/search \
  -H "Authorization: Bearer $FINVECTOR_API_KEY" -H 'content-type: application/json' \
  -d '{"query":"tariff exposure","filters":{"date_from":"2025-01-01","date_to":"2026-12-31"},"limit":3}'

Tools

Every tool is read-only. Filing text is returned as untrusted third-party content, with invisible characters neutralised and instruction-like text flagged, so an agent can treat it as data.

Example prompts

• What does Apple say about its dependence on single-source suppliers in its latest 10-K? Quote the passage and verify the quote against the filing.

• Which companies discussed tariff exposure in their 10-K risk factors over the past year? Show who is new each quarter.

• Compare how NVIDIA and AMD describe export controls in their most recent annual reports, with a citation for each point.

• Summarize the liquidity discussion in Microsoft's latest 10-Q, section by section, and link the filing.

Use get_coverage (or ask "what companies does FinVector cover?") to see what is in the index.

Pricing

1 USD = 100 credits. A search costs 1 credit, a theme screen 2; lookups, section reads and quote checks are free. Each new verified account gets 500 free credits. When the balance runs out, calls return 402 usage_limit_reached.

Support and legal

• Docs: app.finvector.ai/api-docs

• Support: app.finvector.ai/support

• Privacy · Terms

• Issues with this guide: open an issue in this repository.

FinVector returns text from public SEC filings, with a link to each source. It is a research tool, not investment, legal or tax advice. Check important facts against the filing itself before you rely on them.

This repository holds setup guides and configuration examples, under the MIT license; the FinVector service itself is hosted. FinVector is built by Midas.