{
  "markdown": "# the13f-mcp\n\n> Model Context Protocol server for [the13f](https://the13f.com). Brings\n> institutional 13F intelligence into Claude Desktop, Cursor, VS Code +\n> Continue, and any MCP-compatible host — no HTTP code required on your side.\n\n## Important limitations\n\nResearch data only. Sourced from publicly disclosed SEC Form 13F filings,\nwhich lag quarter-end by up to 45 days. Past institutional positioning does\nnot predict future performance. Nothing here constitutes investment advice.\nEvery tool's response includes a `disclaimer` field; the host LLM should\nsurface it alongside any analysis it produces.\n\n## Install\n\n```\nuvx the13f-mcp\n```\n\nOr `pip install the13f-mcp` if you prefer to manage Python environments\nyourself. Python 3.11+ required.\n\n## Get a free API key\n\nFree, no payment, no credit card:\n\n1. Visit <https://the13f.com/developers/>\n2. Enter your email and solve the Cloudflare Turnstile challenge\n3. Copy your `pf13f_` key — **shown once**\n4. Paste it into your MCP host's config as `THE13F_API_KEY` (see below)\n5. Restart the host\n\nFree tier: 100 read calls per day; quota rolls at UTC midnight. Signal and\nreport tools arrive in later minor versions when paid tiers launch.\n\n## Configure your MCP host\n\n### Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json`\n(macOS) or `%APPDATA%/Claude/claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"the13f\": {\n      \"command\": \"uvx\",\n      \"args\": [\"the13f-mcp\"],\n      \"env\": {\n        \"THE13F_API_KEY\": \"pf13f_...\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The13f tools should appear in the MCP tool list.\n\n### Cursor\n\nSettings → MCP → Add Server. Paste the same JSON block into the \"Custom\"\nfield.\n\n### VS Code with Continue\n\nSettings → `experimental.modelContextProtocolServers` → add a `stdio`\ntransport running `uvx the13f-mcp` with `THE13F_API_KEY` in env. The key\nreveal page at <https://the13f.com/developers/signup-success> shows a\ncopy-paste-ready snippet with the key already filled in.\n\n## Available tools — v0.1.0 (Read tier, free)\n\n| Tool | What it does |\n|------|---------------|\n| `list_quarters` | All quarters with holdings data + the latest quarter |\n| `search_managers` | Autocomplete 13F filers by name |\n| `get_manager_holdings` | Full positions for a CIK + quarter |\n| `get_manager_holdings_bulk` | Up to 25 `(cik, quarter)` pairs in one call |\n| `list_all_managers` | Universe of 8,600+ filers with per-manager summary stats |\n| `find_similar_managers` | Match a portfolio against the universe |\n| `get_consensus_portfolio` | Most-widely-held securities per quarter |\n| `get_market_regime` | Institutional regime snapshot (IIOI composite, state, transition) |\n| `get_sector_flows` | Per-sector capital flows and risk posture |\n\n## Planned tools — later versions\n\n| Version | Tools | Requires |\n|---|---|---|\n| v0.2.0 | `get_security_signals`, `get_security_signals_bulk`, `get_portfolio_signals` | Standard tier subscription |\n| v0.3.0 | `generate_manager_report`, `generate_security_report`, `generate_sector_report`, `check_report_status`, `wait_and_download_report` | Standard tier + stored card; two-step confirm |\n\nThe free-tier Read tools are enough to explore the data and build prompts\nagainst it. Signal and report tools deliberately wait on the paid-tier\nbilling plumbing.\n\n## Example prompts\n\n> \"Pull Berkshire Hathaway's top 20 positions as of Q4 2025 and summarize\n> what grew the most quarter-over-quarter.\"\n\n> \"I own AAPL, MSFT, and NVDA equal-weight. Find the 5 institutional\n> managers whose portfolios most closely resemble mine.\"\n\n> \"What sector did 13F filers most aggressively reduce last quarter? Show\n> me the top three managers leading the reduction.\"\n\nThe MCP host's LLM picks the right tool, fills in arguments, surfaces the\n`disclaimer`, and returns the result as structured JSON.\n\n## Environment variables\n\n| Var | Default | What it controls |\n|---|---|---|\n| `THE13F_API_KEY` | (none) | Your `pf13f_` key. Without it, tools return a structured \"free signup required\" response with a link to the signup page. |\n| `THE13F_API_BASE_URL` | `https://api.the13f.com` | Override for local development against a running copy of the13f's gui_server. |\n| `THE13F_MCP_TIMEOUT` | `30` | Per-request HTTP timeout in seconds. Minimum 5. |\n\n## Source\n\nPublic source: <https://github.com/pickelfintech/the13f-mcp>. This is the\nsnapshot that PyPI, Glama.ai, and the MCP community list point at. The\nGitHub repo is a push-mirror of the GitLab one at\n`gitlab.com/pickel-fintech/the13f-mcp`; GitLab remains the primary and\nalso carries the release CI. Bug reports and PRs are accepted on either\nside.\n\n## License\n\nMIT — see [`LICENSE`](./LICENSE). The hosted `api.the13f.com` API that this\nclient calls is a separate service. A free API key (100 calls/day) is\nrequired; sign up at <https://the13f.com/developers/>.\n\n## Support\n\ntom@pickelfintech.com — quote the `request_id` field returned by any failing\ntool call for fastest triage.\n\n## License\n\nMIT. See [LICENSE](../LICENSE). The MCP server source is MIT-licensed; use\nof the the13f API itself is governed by the Terms of Service at\n<https://the13f.com/terms.html>.\n",
  "bytes": 5181,
  "sha": "fadffc0bc7fc849ed5f80642bc0963752b588c02aea8066bf21cd29e466ca11d",
  "repo_slug": "pickelfintech/the13f-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_the13f_mcp_f3f281f2/readme"
}