@flowframe22/mcp-server

Model Context Protocol server for FlowFrame — bring prediction‑market intelligence (Polymarket movers, smart‑money skew, FlowFrame Pulse, political mentions) into Claude and any MCP‑compatible client.

Ask Claude things like:

• "What Polymarket markets moved most in the last 4 hours?"
• "Where is smart money disagreeing with the market right now?"
• "When did Powell last mention tariffs in a press conference?"
• "What is FlowFrame saying about the 2026 midterm Senate races?"

Claude calls FlowFrame, you get an answer with sources and a link back to flowframe.xyz.

Setup

1. Get a FlowFrame API key

Free, takes 10 seconds: https://flowframe.xyz/account/api-keys

2. Add the server to Claude Desktop

Edit your Claude Desktop config:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "flowframe": {
      "command": "npx",
      "args": ["-y", "@flowframe22/mcp-server"],
      "env": {
        "FLOWFRAME_API_KEY": "flowframe_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Restart Claude Desktop. You should see a hammer icon indicating tools are available.

3. (Optional) Use with Claude Code or other MCP clients

Any client that speaks MCP over stdio works the same way — point it at npx -y @flowframe22/mcp-server with FLOWFRAME_API_KEY in the environment.

Tools

| Tool | Description | |---|---| | flowframe_ping | Health check — confirm your API key works inside Claude | | flowframe_list_pulse | Recent FlowFrame Pulse analysis items | | flowframe_get_pulse_item | Fetch a single Pulse item by slug or uuid (full content) | | flowframe_get_pulse_for_market | All FlowFrame coverage of a specific Polymarket market (by conditionId) | | flowframe_polymarket_movers | Top Polymarket markets by recent price change (1h/4h/12h/24h) | | flowframe_kalshi_movers | Top Kalshi markets by recent price change | | flowframe_smart_money_skew | Markets where the top 30 profitable traders disagree with the market | | flowframe_smart_money_skew_for_market | Per-tier breakdown for a single market | | flowframe_list_speakers | List indexed political speakers (Trump, Powell, Vance, etc.) | | flowframe_search_political_mentions | Find mentions of a keyword in political speech transcripts | | flowframe_mention_frequency | Time-series of how often a speaker mentions a keyword |

Every tool returns BOTH a human-readable text summary AND a structuredContent block containing the raw { data, meta } envelope, so downstream agent steps and other MCP clients can consume the data programmatically.

Attribution

Every tool response ends with a "Data from FlowFrame (https://flowframe.xyz)" line. Free-tier API consumers must keep this attribution visible in any UI built on top of the API. Paid tiers may suppress it. See https://flowframe.xyz/api-docs#attribution for the full policy.

Rate limits

• Free tier: 20 requests / hour / key
• Paid tiers: 600+ / hour — see https://flowframe.xyz/api-docs#pricing

When you hit the limit, the tool returns a clear error message including how many seconds to wait.

Configuration

| Env var | Default | Description | |---|---|---| | FLOWFRAME_API_KEY | (required) | Bearer token from /account/api-keys | | FLOWFRAME_API_BASE | https://flowframe.xyz | Override for staging / self-hosted |

Development

git clone <repo>
cd packages/mcp
npm install
npm run build
FLOWFRAME_API_KEY=flowframe_test_... node dist/index.js

The server speaks MCP over stdio — for ad-hoc testing, the MCP Inspector is the easiest way to exercise tools manually.

License

MIT — see LICENSE.