{
  "markdown": "# Tengu FIRM — MCP Server\n\n**One API key. 336 market & quant data tools. Built for AI agents.**\n\nTengu FIRM is a **hosted [Model Context Protocol](https://modelcontextprotocol.io) server**\nthat exposes real-time and historical market data, SEC filings, insider/institutional/\ncongressional trades, fundamentals, quant signals, cited verdicts, private markets, and\nmacro data — as native agent tools over **MCP Streamable HTTP**.\n\n- **Endpoint:** `https://firm.tengu.co/mcp`\n- **Transport:** MCP Streamable HTTP (JSON-RPC 2.0) — `initialize`, `tools/list`, `tools/call`\n- **Auth:** send your key as the `X-API-Key` header (or `Authorization: Bearer <key>`)\n- **Server:** `tengu-firm` · manifest `2.114`\n- **Get a key (free, no card):** https://tengu.co/api\n\nEvery `tools/call` proxies to a `firm.tengu.co` REST endpoint, so tier gating and credit\nmetering apply exactly as on REST. *Data and structured signals — not investment advice.*\n\n---\n\n## Connect\n\n### claude.ai (recommended for a hosted server)\nSettings → **Connectors** → **Add custom connector** → URL `https://firm.tengu.co/mcp`,\nand set the **`X-API-Key`** header to your key.\n\n### Claude Desktop / Cursor (via `mcp-remote`)\nDesktop clients launch MCP servers as local processes, so bridge to the remote endpoint\nwith [`mcp-remote`](https://www.npmjs.com/package/mcp-remote):\n\n```json\n{\n  \"mcpServers\": {\n    \"tengu-firm\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://firm.tengu.co/mcp\",\n               \"--header\", \"X-API-Key:YOUR_TENGU_API_KEY\"]\n    }\n  }\n}\n```\n\n### Any remote-capable MCP client\n```json\n{\n  \"mcpServers\": {\n    \"tengu-firm\": {\n      \"url\": \"https://firm.tengu.co/mcp\",\n      \"headers\": { \"X-API-Key\": \"YOUR_TENGU_API_KEY\" }\n    }\n  }\n}\n```\n\n### Verify it's reachable\n```bash\ncurl -s -X POST https://firm.tengu.co/mcp \\\n  -H 'Content-Type: application/json' \\\n  -H 'X-API-Key: YOUR_TENGU_API_KEY' \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}' | jq '.result.tools | length'\n```\n\n---\n\n## Tool catalogue\n\nLive discovery (no auth required):\n- Capabilities: `https://firm.tengu.co/api/capabilities`\n- OpenAPI 3.1: `https://firm.tengu.co/api/openapi.json`\n\n| Group | Prefix | Count | Surface |\n|------|--------|------:|---------|\n| legacy | `tengu_*` | 10 | EC2-compat core data |\n| v2 | `tengu_v2_*` | 15 | FIRM upgrades |\n| v3 | `tengu_v3_*` | 301 | Expert: agents, decision, execution, strategies, memory, lab |\n| copilot | `tengu_copilot_*` | 20 | Chat-copilot aggregations |\n| ml | `tengu_ml_*` | 5 | Direct ML model surface |\n\n**Example tools**\n- `tengu_snapshot` — live price snapshot for a ticker\n- `tengu_crypto` — real-time crypto quote (439 pairs)\n- `tengu_insider_clusters` — companies where multiple insiders bought around the same time\n- `tengu_v3_fundamentals_full` — full fundamentals (income, balance sheet, cash flow, 100+ metrics)\n\n**Data surfaces:** real-time + 30yr OHLCV (stocks & crypto) · 100+ fundamentals · SEC\nfilings (10-K/10-Q/8-K) · insider trades (Form 4) · institutional holdings (13F) ·\ncongressional trades (STOCK Act) · news sentiment (57 sources) · quant factor scores ·\ncited verdicts · private markets (10.5M companies / 3M deals / 646K investors) · macro\n(CPI, rates, employment).\n\n---\n\n## Pricing\n\n| Tier | Price | Credits / mo | Rate limit |\n|------|------:|-------------:|-----------:|\n| Free | $0 | 1,000 | 30 req/min |\n| Starter | $99 | 250,000 | 120 req/min |\n| Pro | $499 | 2,000,000 | 600 req/min |\n| Expert | $999 | 5,000,000 | 1,200 req/min |\n\nStart free (no card): **https://tengu.co/api**\n\n## Links\n- Homepage: https://tengu.co/api\n- Capabilities: https://firm.tengu.co/api/capabilities\n- OpenAPI: https://firm.tengu.co/api/openapi.json\n\n## License\nMIT — see [LICENSE](./LICENSE). \"Tengu\" and \"FIRM\" are marks of Tengu, Inc.\n",
  "bytes": 3784,
  "sha": "2308fdde5d30be17f0295a5c74613f61ae4d7839e6bbbd0abe646639db80e7f4",
  "repo_slug": "hlobo-dev/tengu-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_hlobo_dev_tengu_firm_9f886c75/readme"
}