{
  "markdown": "# FinBridge — DART + SEC + FRED + prices + screeners. One MCP.\n\n**The finance MCP for AI stock analysis.** FinBridge is a hosted data service that collects official financial data for **Korea, the United States, Japan and Taiwan** (plus European statements) every night, normalises it to one schema, and serves it to ChatGPT, Claude, Cursor or any MCP client — and to everything else over a REST API.\n\n- **MCP endpoint (Streamable HTTP):** `https://mcp.gronox.kr/mcp`\n- **REST API:** `https://mcp.gronox.kr/api/v1` · OpenAPI 3.1: `https://mcp.gronox.kr/api/v1/openapi.json`\n- **Free plan, no card:** 200 calls/day, every tool, the last 4 fiscal years and 130 trading sessions. Paid plans buy history depth, not attempts.\n\nOfficial sources only, and only sources we may redistribute: OpenDART, SEC EDGAR, EDINET, TWSE/TPEx OpenAPI, data.go.kr (Financial Services Commission), Databento (US daily prices), FRED public series, exchange public data via ccxt. Every answer names its source and as-of date, and every company carries a `page_url` to a public page with the filing behind each number.\n\n## Coverage\n\n| Market | Source | Statements & filings | Daily prices | Segments | Screeners / backtests |\n|---|---|---|---|---|---|\n| Korea (KRX) | OpenDART · data.go.kr | ✅ K-IFRS, normalised, revisions kept | ✅ corporate-action adjusted, 2020– | ✅ | ✅ |\n| United States | SEC EDGAR · Databento | ✅ US-GAAP, as-filed (point-in-time) history | ✅ from 2023-03, split-adjusted | ✅ (SEC DERA) | ✅ |\n| Taiwan | TWSE / TPEx OpenAPI | ✅ TW-IFRS | ✅ 2004– | — | ✅ |\n| Japan | EDINET | ✅ J-GAAP / IFRS | — (no redistributable source) | ✅ | — |\n| Europe | ESEF / IFRS | ✅ statements | — | — | — |\n\nPublic pages for every listed operating company: `https://www.gronox.kr/companies/{kr|us|jp|tw}/{symbol}` (e.g. [Samsung Electronics](https://www.gronox.kr/companies/kr/005930)).\n\n## What you get\n\n| Area | Tools |\n|---|---|\n| Statements & filings | DART / EDGAR financials (with the five nearest peers attached), filings, major events, insider trades (DART · Form 4), 13F institutional holdings, disclosure feed |\n| Prices & technicals | Daily OHLCV (KR · US · TW), technical indicators, valuation snapshots with market percentiles |\n| Screeners | Minervini trend template, CAN SLIM, Kell and Schwartz playbooks, technical screens, ETF screens — nightly over every listing |\n| Peers & segments | `get_peers` by industry group and size, or by business-mix similarity from reported segments |\n| Research | Portfolio backtests with trading costs (KR · US · TW), point-in-time factor studies, saved runs, read-only SQL over the database |\n| Macro & crypto | FRED series and snapshots, crypto tickers / OHLCV / exchange premium |\n| Account | Watchlist, portfolio import |\n\nTool reference (rendered from the live registry): https://www.gronox.kr/docs\n\n## Quick start\n\n### Claude (claude.ai / Desktop)\nSettings → Connectors → Add custom connector → `https://mcp.gronox.kr/mcp` — sign in with Google, no key needed. Then, in each new chat, open **+ → FinBridge** to turn it on (connectors are off per conversation until you do) and ask.\n\n### Claude Code\n```bash\nclaude mcp add --transport http finbridge https://mcp.gronox.kr/mcp --header \"Authorization: Bearer smcp_...\"\n```\nGet a key at https://www.gronox.kr/login (Google sign-in, issued instantly).\n\n### ChatGPT (developer mode)\nSettings → Apps & Connectors → Advanced → Developer mode → Create connector with the URL above and your `smcp_` key as the access token.\n\n### Any MCP client (Gemini CLI, Cursor, …)\n```json\n{\"mcpServers\": {\"finbridge\": {\"httpUrl\": \"https://mcp.gronox.kr/mcp\",\n  \"headers\": {\"Authorization\": \"Bearer smcp_...\"}}}}\n```\n\n### REST (no MCP client)\n```bash\ncurl -H \"Authorization: Bearer smcp_...\" https://mcp.gronox.kr/api/v1/companies/kr/005930/financials\ncurl -H \"Authorization: Bearer smcp_...\" \"https://mcp.gronox.kr/api/v1/companies/us/AAPL/peers?limit=5\"\ncurl -H \"Authorization: Bearer smcp_...\" \"https://mcp.gronox.kr/api/v1/companies/eu/NL0010273215/peers?limit=5\"   # Europe by ISIN: statements-based peers, no prices (EU groups all IT/electronics together, so treat the list as a starting point)\n```\nEndpoints: `/companies/{market}/{symbol}` (profile) · `/financials` · `/valuation` · `/peers` · `/prices`. Same key, same quota, same depth as MCP.\n\n## Built-in prompts\n\nFinBridge registers three MCP prompts, so you can start without typing a question. In Claude.ai or Claude Desktop, turn FinBridge on in the chat (**+ → FinBridge**), then open **+ → FinBridge** again and pick a prompt; in Claude Code type the slash command. Clients that don't list prompts (Cursor, ChatGPT developer mode): paste the one-liner.\n\n| Prompt | What it does | Claude Code | Paste instead |\n|---|---|---|---|\n| This week's watchlist | What passed the trend, CAN SLIM, VCP and RS screens this week (KR/US/TW), then a closer look at the strongest three | `/mcp__finbridge__weekly_watchlist kr` | \"Run this week's FinBridge watchlist for Korea and check the strongest three with get_valuation and get_technicals.\" |\n| Company check-up | One company end to end: four annual statements, valuation vs five peers, technicals, latest filings, every number dated | `/mcp__finbridge__company_checkup 005930` | \"Give me a FinBridge check-up of Samsung Electronics (005930) with data_as_of dates.\" |\n| First three questions | A one-minute tour: peers, a screen, four years of statements | `/mcp__finbridge__first_questions` | \"I just connected FinBridge — answer its three starter questions and show which tool you used.\" |\n\n## Good first questions\n\n1. \"Compare Samsung Electronics with its five nearest peers on P/E, ROE and revenue growth.\"\n2. \"Screen KOSDAQ for names above RS 90 that pass the trend template.\"\n3. \"Pull Apple's last four annual statements and summarise margin trends.\"\n\n## Links\n\n- Product, keys and pricing: https://www.gronox.kr · https://www.gronox.kr/pricing\n- Connect guide: https://www.gronox.kr/connect\n- Where to get each market's data for free (guides): https://www.gronox.kr/guides\n- Data sources and licences: https://www.gronox.kr/sources\n- Status: https://mcp.gronox.kr/status\n- Registry: `kr.gronox/finbridge` in the official MCP Registry · Smithery `red0920/finbridge` · mcp.so\n- 한국어: https://www.gronox.kr/ko · 日本語: https://www.gronox.kr/ja\n\n## Notes\n\n- Data is a nightly snapshot (the filings feed refreshes every 5 minutes); not real-time quotes.\n- Statements follow the local accounting standard (K-IFRS, US-GAAP, J-GAAP/IFRS, TW-IFRS), so cross-market ratios are approximations.\n- Information only, not investment advice. FinBridge is not affiliated with any trader whose published criteria it implements.\n- This repository is the public listing (registry manifest `server.json`) for the hosted service; the server itself is not open source.\n\nContact: 4y.changemaker@gmail.com\n\n## License\n\nThe contents of this repository (listing metadata and documentation) are released under the [MIT License](./LICENSE). The hosted FinBridge service and its source code are not part of this repository and are provided under the [FinBridge Terms of Service](https://www.gronox.kr/terms).\n",
  "bytes": 7146,
  "sha": "a620d4d8a393ba23f360b1c0312f1b6bee3ff59b940ef0e6d4703a898f6e29e0",
  "repo_slug": "jakechj/finbridge-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_kr_gronox_finbridge_f93c12c0/readme"
}