Back to Browse

The13f MCP Server

Developer ToolsModerate5.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

Institutional 13F intelligence: 8,600+ managers, holdings, peer search, sector flows.

About

Institutional 13F intelligence: 8,600+ managers, holdings, peer search, sector flows.

Security Report

5.2
Moderate5.2Moderate Risk

This is a well-structured MCP server for accessing SEC 13F institutional holdings data. It properly implements authentication via API key, uses environment variables for secrets, has appropriate input validation, and includes comprehensive error handling and compliance messaging. No security vulnerabilities were identified. Minor code quality observations around error handling patterns do not materially affect the score. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.

6 files analyzed · 7 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Free pf13f_ key from https://the13f.com/developers/. 100 calls/day, no credit card. Without it, every tool returns a structured free-signup-required response with the signup URL.Required

Environment variable: THE13F_API_KEY

Override API base URL. Defaults to https://api.the13f.com. Used for local development against a running copy of the13f's gui_server.Optional

Environment variable: THE13F_API_BASE_URL

Per-request HTTP timeout in seconds. Minimum 5.Optional

Environment variable: THE13F_MCP_TIMEOUT

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "com-the13f-mcp": {
      "env": {
        "THE13F_API_KEY": "your-the13f-api-key-here",
        "THE13F_MCP_TIMEOUT": "your-the13f-mcp-timeout-here",
        "THE13F_API_BASE_URL": "your-the13f-api-base-url-here"
      },
      "args": [
        "the13f-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

the13f-mcp

Model Context Protocol server for the13f. Brings institutional 13F intelligence into Claude Desktop, Cursor, VS Code + Continue, and any MCP-compatible host — no HTTP code required on your side.

Important limitations

Research data only. Sourced from publicly disclosed SEC Form 13F filings, which lag quarter-end by up to 45 days. Past institutional positioning does not predict future performance. Nothing here constitutes investment advice. Every tool's response includes a disclaimer field; the host LLM should surface it alongside any analysis it produces.

Install

uvx the13f-mcp

Or pip install the13f-mcp if you prefer to manage Python environments yourself. Python 3.11+ required.

Get a free API key

Free, no payment, no credit card:

  1. Visit https://the13f.com/developers/
  2. Enter your email and solve the Cloudflare Turnstile challenge
  3. Copy your pf13f_ key — shown once
  4. Paste it into your MCP host's config as THE13F_API_KEY (see below)
  5. Restart the host

Free tier: 100 read calls per day; quota rolls at UTC midnight. Signal and report tools arrive in later minor versions when paid tiers launch.

Configure your MCP host

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "the13f": {
      "command": "uvx",
      "args": ["the13f-mcp"],
      "env": {
        "THE13F_API_KEY": "pf13f_..."
      }
    }
  }
}

Restart Claude Desktop. The13f tools should appear in the MCP tool list.

Cursor

Settings → MCP → Add Server. Paste the same JSON block into the "Custom" field.

VS Code with Continue

Settings → experimental.modelContextProtocolServers → add a stdio transport running uvx the13f-mcp with THE13F_API_KEY in env. The key reveal page at https://the13f.com/developers/signup-success shows a copy-paste-ready snippet with the key already filled in.

Available tools — v0.1.0 (Read tier, free)

ToolWhat it does
list_quartersAll quarters with holdings data + the latest quarter
search_managersAutocomplete 13F filers by name
get_manager_holdingsFull positions for a CIK + quarter
get_manager_holdings_bulkUp to 25 (cik, quarter) pairs in one call
list_all_managersUniverse of 8,600+ filers with per-manager summary stats
find_similar_managersMatch a portfolio against the universe
get_consensus_portfolioMost-widely-held securities per quarter
get_market_regimeInstitutional regime snapshot (IIOI composite, state, transition)
get_sector_flowsPer-sector capital flows and risk posture

Planned tools — later versions

VersionToolsRequires
v0.2.0get_security_signals, get_security_signals_bulk, get_portfolio_signalsStandard tier subscription
v0.3.0generate_manager_report, generate_security_report, generate_sector_report, check_report_status, wait_and_download_reportStandard tier + stored card; two-step confirm

The free-tier Read tools are enough to explore the data and build prompts against it. Signal and report tools deliberately wait on the paid-tier billing plumbing.

Example prompts

"Pull Berkshire Hathaway's top 20 positions as of Q4 2025 and summarize what grew the most quarter-over-quarter."

"I own AAPL, MSFT, and NVDA equal-weight. Find the 5 institutional managers whose portfolios most closely resemble mine."

"What sector did 13F filers most aggressively reduce last quarter? Show me the top three managers leading the reduction."

The MCP host's LLM picks the right tool, fills in arguments, surfaces the disclaimer, and returns the result as structured JSON.

Environment variables

VarDefaultWhat it controls
THE13F_API_KEY(none)Your pf13f_ key. Without it, tools return a structured "free signup required" response with a link to the signup page.
THE13F_API_BASE_URLhttps://api.the13f.comOverride for local development against a running copy of the13f's gui_server.
THE13F_MCP_TIMEOUT30Per-request HTTP timeout in seconds. Minimum 5.

Source

Public source: https://github.com/pickelfintech/the13f-mcp. This is the snapshot that PyPI, Glama.ai, and the MCP community list point at. The GitHub repo is a push-mirror of the GitLab one at gitlab.com/pickel-fintech/the13f-mcp; GitLab remains the primary and also carries the release CI. Bug reports and PRs are accepted on either side.

License

MIT — see LICENSE. The hosted api.the13f.com API that this client calls is a separate service. A free API key (100 calls/day) is required; sign up at https://the13f.com/developers/.

Support

tom@pickelfintech.com — quote the request_id field returned by any failing tool call for fastest triage.

License

MIT. See LICENSE. The MCP server source is MIT-licensed; use of the the13f API itself is governed by the Terms of Service at https://the13f.com/terms.html.

Reviews

No reviews yet

Be the first to review this server!