@flowframe22/mcp-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FlowFrame
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,97 @@
+# @flowframe22/mcp-server
+
+[Model Context Protocol](https://modelcontextprotocol.io) server for [FlowFrame](https://flowframe.xyz) — 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`
+
+```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
+
+```bash
+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](https://github.com/modelcontextprotocol/inspector) is the easiest way to exercise tools manually.
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/client.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Thin HTTP client for the FlowFrame /v1 API.
+ * Handles bearer auth, base URL, JSON parsing, structured error mapping,
+ * and one transparent retry on transient network failures.
+ */
+export interface BrandMeta {
+    source: string;
+    docs: string;
+    attribution: {
+        required: boolean;
+        label: string;
+        url: string;
+        terms?: string;
+        tier: string;
+    };
+}
+export interface Envelope<T> {
+    data: T;
+    meta: {
+        fetchedAt: string;
+        brand?: BrandMeta;
+        [k: string]: unknown;
+    };
+}
+export declare class FlowFrameApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly retryAfterSeconds?: number | undefined;
+    constructor(status: number, code: string, message: string, retryAfterSeconds?: number | undefined);
+}
+export declare class FlowFrameClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor(opts: {
+        apiKey: string;
+        baseUrl?: string;
+    });
+    get<T>(path: string, query?: Record<string, string | number | boolean | undefined | null>): Promise<Envelope<T>>;
+    private errorMessage;
+}

package/dist/client.js

@@ -0,0 +1,104 @@
+/**
+ * Thin HTTP client for the FlowFrame /v1 API.
+ * Handles bearer auth, base URL, JSON parsing, structured error mapping,
+ * and one transparent retry on transient network failures.
+ */
+const DEFAULT_BASE_URL = "https://flowframe.xyz";
+const USER_AGENT = "flowframe-mcp-server/0.1.0";
+export class FlowFrameApiError extends Error {
+    status;
+    code;
+    retryAfterSeconds;
+    constructor(status, code, message, retryAfterSeconds) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.retryAfterSeconds = retryAfterSeconds;
+        this.name = "FlowFrameApiError";
+    }
+}
+export class FlowFrameClient {
+    baseUrl;
+    apiKey;
+    constructor(opts) {
+        if (!opts.apiKey) {
+            throw new Error("FLOWFRAME_API_KEY is required. Generate one at https://flowframe.xyz/account/api-keys " +
+                "and add it to your MCP client config (env.FLOWFRAME_API_KEY).");
+        }
+        this.apiKey = opts.apiKey;
+        this.baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    }
+    async get(path, query) {
+        const url = new URL(`/v1${path}`, this.baseUrl);
+        if (query) {
+            for (const [k, v] of Object.entries(query)) {
+                if (v === undefined || v === null || v === "")
+                    continue;
+                url.searchParams.set(k, String(v));
+            }
+        }
+        const doFetch = () => fetch(url.toString(), {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                Accept: "application/json",
+                "User-Agent": USER_AGENT,
+            },
+        });
+        let res;
+        try {
+            res = await doFetch();
+        }
+        catch (err) {
+            // One retry on transient network failures (DNS hiccup, ECONNRESET, etc.)
+            await new Promise((r) => setTimeout(r, 500));
+            try {
+                res = await doFetch();
+            }
+            catch (err2) {
+                throw new FlowFrameApiError(0, "network_error", `Network error contacting ${url.host}: ${err2.message}`);
+            }
+        }
+        const text = await res.text();
+        let body = null;
+        if (text) {
+            try {
+                body = JSON.parse(text);
+            }
+            catch {
+                // Non-JSON response — surface raw text in the error.
+                throw new FlowFrameApiError(res.status, "invalid_response", `Non-JSON response from FlowFrame API (HTTP ${res.status}): ${text.slice(0, 200)}`);
+            }
+        }
+        if (!res.ok) {
+            const code = body?.error ?? "internal_error";
+            const retryAfter = typeof body?.retryAfterSeconds === "number" ? body.retryAfterSeconds : undefined;
+            throw new FlowFrameApiError(res.status, code, this.errorMessage(res.status, code, body), retryAfter);
+        }
+        return body;
+    }
+    errorMessage(status, code, body) {
+        switch (code) {
+            case "unauthorized":
+                return "FlowFrame API rejected the API key. Generate a new one at https://flowframe.xyz/account/api-keys and update FLOWFRAME_API_KEY in your MCP client config.";
+            case "forbidden":
+                return "This endpoint requires a paid FlowFrame tier. See https://flowframe.xyz/api-docs#pricing.";
+            case "rate_limit_exceeded": {
+                const wait = body?.retryAfterSeconds;
+                const waitStr = typeof wait === "number" ? ` Retry in ${wait} seconds.` : "";
+                return `FlowFrame rate limit hit.${waitStr} Your current key appears to be on the free tier (20 req/hour). See https://flowframe.xyz/api-docs#pricing for higher limits.`;
+            }
+            case "not_found":
+                return "Requested resource not found.";
+            case "validation_error": {
+                const msgs = Array.isArray(body?.details)
+                    ? body.details.map((d) => d?.message).filter(Boolean).join("; ")
+                    : null;
+                return msgs ? `Invalid request: ${msgs}` : "Invalid request parameters.";
+            }
+            default:
+                return `FlowFrame API error (HTTP ${status}, code=${code}).`;
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/formatter.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Convert FlowFrame /v1 envelopes into MCP tool results.
+ *
+ * Every result returns BOTH:
+ *   - a human-readable text block (Claude reasons over labeled prose well),
+ *   - a `structuredContent` block (the raw envelope) so other MCP clients and
+ *     downstream agent steps can consume the data programmatically.
+ *
+ * Attribution is appended unconditionally to every response. If the envelope
+ * also carries a `meta.brand.attribution` block from the API, we use its label
+ * and URL; otherwise we fall back to a generic FlowFrame line.
+ */
+import type { Envelope, FlowFrameApiError } from "./client.js";
+export interface ToolResult {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent?: Record<string, unknown>;
+    isError?: true;
+    [key: string]: unknown;
+}
+interface FormatOptions {
+    /**
+     * Extra attribution line appended after the FlowFrame line.
+     * Use for endpoints that wrap third-party data (e.g., predicting.top).
+     */
+    extraAttribution?: string;
+}
+export declare function formatEnvelope<T>(title: string, envelope: Envelope<T>, body: string, options?: FormatOptions): ToolResult;
+/**
+ * Wrap a non-envelope payload (e.g. a synthetic ping result) the same way:
+ * prose + structured content + attribution.
+ */
+export declare function formatPlain(title: string, body: string, structured: Record<string, unknown>): ToolResult;
+export declare function formatError(err: FlowFrameApiError | Error): ToolResult;
+export declare function fmtPct(n: number | null | undefined, digits?: number): string;
+export declare function fmtUsd(n: number | null | undefined): string;
+export declare function fmtPrice(n: number | null | undefined): string;
+export {};

package/dist/formatter.js

@@ -0,0 +1,84 @@
+/**
+ * Convert FlowFrame /v1 envelopes into MCP tool results.
+ *
+ * Every result returns BOTH:
+ *   - a human-readable text block (Claude reasons over labeled prose well),
+ *   - a `structuredContent` block (the raw envelope) so other MCP clients and
+ *     downstream agent steps can consume the data programmatically.
+ *
+ * Attribution is appended unconditionally to every response. If the envelope
+ * also carries a `meta.brand.attribution` block from the API, we use its label
+ * and URL; otherwise we fall back to a generic FlowFrame line.
+ */
+export function formatEnvelope(title, envelope, body, options = {}) {
+    const parts = [`${title}\n`, body.trim()];
+    const brand = envelope.meta?.brand;
+    const label = brand?.attribution?.label ?? "Data from FlowFrame";
+    const url = brand?.attribution?.url ?? "https://flowframe.xyz";
+    parts.push(`\n— ${label} (${url})`);
+    if (options.extraAttribution) {
+        parts.push(options.extraAttribution);
+    }
+    return {
+        content: [{ type: "text", text: parts.join("\n") }],
+        structuredContent: {
+            data: envelope.data,
+            meta: envelope.meta,
+        },
+    };
+}
+/**
+ * Wrap a non-envelope payload (e.g. a synthetic ping result) the same way:
+ * prose + structured content + attribution.
+ */
+export function formatPlain(title, body, structured) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: `${title}\n\n${body.trim()}\n\n— Data from FlowFrame (https://flowframe.xyz)`,
+            },
+        ],
+        structuredContent: structured,
+    };
+}
+export function formatError(err) {
+    const anyErr = err;
+    return {
+        isError: true,
+        content: [{ type: "text", text: err.message }],
+        structuredContent: {
+            error: {
+                message: err.message,
+                code: anyErr.code ?? "internal_error",
+                status: anyErr.status ?? 0,
+                ...(typeof anyErr.retryAfterSeconds === "number"
+                    ? { retryAfterSeconds: anyErr.retryAfterSeconds }
+                    : {}),
+            },
+        },
+    };
+}
+export function fmtPct(n, digits = 1) {
+    if (n === null || n === undefined || !isFinite(n))
+        return "n/a";
+    return `${n >= 0 ? "+" : ""}${n.toFixed(digits)}%`;
+}
+export function fmtUsd(n) {
+    if (n === null || n === undefined || !isFinite(n))
+        return "n/a";
+    if (Math.abs(n) >= 1e9)
+        return `$${(n / 1e9).toFixed(2)}B`;
+    if (Math.abs(n) >= 1e6)
+        return `$${(n / 1e6).toFixed(2)}M`;
+    if (Math.abs(n) >= 1e3)
+        return `$${(n / 1e3).toFixed(1)}K`;
+    return `$${n.toFixed(0)}`;
+}
+export function fmtPrice(n) {
+    if (n === null || n === undefined || !isFinite(n))
+        return "n/a";
+    // Polymarket prices are 0..1 probabilities — show as percentage.
+    return `${(n * 100).toFixed(1)}%`;
+}
+//# sourceMappingURL=formatter.js.map

package/dist/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/**
+ * FlowFrame MCP Server
+ *
+ * Exposes the FlowFrame /v1 prediction-market intelligence API as Model
+ * Context Protocol tools so Claude (Desktop, Code, etc.) can call them
+ * directly during a conversation.
+ *
+ * Transport: stdio. Configure in Claude Desktop via:
+ *
+ *   {
+ *     "mcpServers": {
+ *       "flowframe": {
+ *         "command": "npx",
+ *         "args": ["-y", "@flowframe22/mcp-server"],
+ *         "env": { "FLOWFRAME_API_KEY": "flowframe_live_..." }
+ *       }
+ *     }
+ *   }
+ *
+ * Get a free API key at https://flowframe.xyz/account/api-keys
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+/**
+ * FlowFrame MCP Server
+ *
+ * Exposes the FlowFrame /v1 prediction-market intelligence API as Model
+ * Context Protocol tools so Claude (Desktop, Code, etc.) can call them
+ * directly during a conversation.
+ *
+ * Transport: stdio. Configure in Claude Desktop via:
+ *
+ *   {
+ *     "mcpServers": {
+ *       "flowframe": {
+ *         "command": "npx",
+ *         "args": ["-y", "@flowframe22/mcp-server"],
+ *         "env": { "FLOWFRAME_API_KEY": "flowframe_live_..." }
+ *       }
+ *     }
+ *   }
+ *
+ * Get a free API key at https://flowframe.xyz/account/api-keys
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { FlowFrameClient } from "./client.js";
+import { registerTools } from "./tools.js";
+const SERVER_NAME = "flowframe";
+const SERVER_VERSION = "0.1.0";
+async function main() {
+    const apiKey = process.env.FLOWFRAME_API_KEY;
+    const baseUrl = process.env.FLOWFRAME_API_BASE;
+    if (!apiKey) {
+        // Write to stderr so MCP clients surface this in their server logs.
+        // Stdout is reserved for the MCP protocol — never log there.
+        process.stderr.write("[flowframe-mcp] FLOWFRAME_API_KEY environment variable is required.\n" +
+            "[flowframe-mcp] Generate a free API key at https://flowframe.xyz/account/api-keys\n" +
+            "[flowframe-mcp] then add it to your MCP client config under env.FLOWFRAME_API_KEY.\n");
+        process.exit(1);
+    }
+    const client = new FlowFrameClient({ apiKey, baseUrl });
+    const server = new McpServer({
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+    });
+    registerTools(server, client);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write(`[flowframe-mcp] Server v${SERVER_VERSION} ready (base=${baseUrl ?? "https://flowframe.xyz"}).\n`);
+}
+main().catch((err) => {
+    process.stderr.write(`[flowframe-mcp] Fatal error: ${err.stack ?? err}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,GAAG,WAAW,CAAC;AAChC,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAE/C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,oEAAoE;QACpE,6DAA6D;QAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,uEAAuE;YACrE,qFAAqF;YACrF,sFAAsF,CACzF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IAEH,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2BAA2B,cAAc,gBAAgB,OAAO,IAAI,uBAAuB,MAAM,CAClG,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAiC,GAAa,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC,CAAC;IACtF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tool registrations for the FlowFrame MCP server.
+ *
+ * Each tool maps 1:1 to a /v1/* endpoint. Descriptions are written for the
+ * model — they explain WHEN to call the tool, WHAT it returns, and WHAT it
+ * does NOT do. Keeping these tight is the difference between a useful MCP
+ * server and one Claude ignores.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { FlowFrameClient } from "./client.js";
+export declare function registerTools(server: McpServer, client: FlowFrameClient): void;

package/dist/tools.js

@@ -0,0 +1,418 @@
+/**
+ * Tool registrations for the FlowFrame MCP server.
+ *
+ * Each tool maps 1:1 to a /v1/* endpoint. Descriptions are written for the
+ * model — they explain WHEN to call the tool, WHAT it returns, and WHAT it
+ * does NOT do. Keeping these tight is the difference between a useful MCP
+ * server and one Claude ignores.
+ */
+import { z } from "zod";
+import { formatEnvelope, formatError, fmtPct, fmtPrice, fmtUsd } from "./formatter.js";
+const SPEAKER_SLUGS = [
+    "donald-trump",
+    "jd-vance",
+    "karoline-leavitt",
+    "pete-hegseth",
+    "marco-rubio",
+    "jerome-powell",
+];
+const WindowEnum = z.enum(["1h", "4h", "12h", "24h"]);
+const DirectionEnum = z.enum(["up", "down", "both"]);
+export function registerTools(server, client) {
+    // ─────────────────────────────────────────────────────────────────────────
+    // Ping — install/health check
+    // ─────────────────────────────────────────────────────────────────────────
+    server.tool("flowframe_ping", "Health check for the FlowFrame MCP server. Confirms that FLOWFRAME_API_KEY is " +
+        "configured correctly and that the FlowFrame API is reachable. Returns the key id " +
+        "and tier on success. Use this first if any other FlowFrame tool is failing.", {}, async () => {
+        try {
+            const env = await client.get("/_ping");
+            const d = env.data;
+            const body = [
+                `OK — FlowFrame API is reachable.`,
+                `Key id: ${d.keyId}`,
+                `Tier:   ${d.tier}`,
+            ].join("\n");
+            return formatEnvelope("FlowFrame ping:", env, body);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ─────────────────────────────────────────────────────────────────────────
+    // Pulse — FlowFrame's own market analysis feed
+    // ─────────────────────────────────────────────────────────────────────────
+    server.tool("flowframe_list_pulse", "List recent FlowFrame Pulse items — short-form analysis written by FlowFrame about " +
+        "specific Polymarket and Kalshi markets. Use when the user asks 'what's new on FlowFrame', " +
+        "'what is FlowFrame saying about prediction markets lately', or wants original analysis " +
+        "rather than raw market data. Returns title, source, publish date, content, the underlying " +
+        "Polymarket conditionId (if any), and a permalink. Sorted newest first. " +
+        "Do NOT use for market price data — use flowframe_polymarket_movers for that.", {
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(50)
+            .optional()
+            .describe("Number of items to return (default 10, max 50)."),
+        source: z
+            .string()
+            .optional()
+            .describe("Filter by source name (e.g., 'Polymarket', 'Kalshi'). Optional."),
+        since: z
+            .string()
+            .optional()
+            .describe("ISO 8601 timestamp; only return items published after this time."),
+    }, async ({ limit, source, since }) => {
+        try {
+            const env = await client.get("/pulse", { limit: limit ?? 10, source, since });
+            if (env.data.length === 0) {
+                return formatEnvelope("No FlowFrame Pulse items match those filters.", env, "");
+            }
+            const body = env.data
+                .map((item, i) => {
+                const date = new Date(item.publishedAt).toISOString().slice(0, 10);
+                const snippet = (item.content ?? "").replace(/\s+/g, " ").trim().slice(0, 280);
+                return [
+                    `${i + 1}. ${item.subject}`,
+                    `   Published: ${date} | Source: ${item.source}${item.conditionId ? ` | conditionId: ${item.conditionId}` : ""}`,
+                    `   ${snippet}${snippet.length === 280 ? "…" : ""}`,
+                    `   ${item.permalink}`,
+                ].join("\n");
+            })
+                .join("\n\n");
+            return formatEnvelope(`FlowFrame Pulse — ${env.data.length} most recent item(s):`, env, body);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool("flowframe_get_pulse_item", "Fetch a single FlowFrame Pulse item by its slug or uuid. Use after flowframe_list_pulse " +
+        "when the user says 'open that one', 'show me the full text', or 'summarize the second " +
+        "item' — the slug from the list result goes here. Returns the full content (not truncated), " +
+        "title, source, publish date, conditionId, and permalink.", {
+        identifier: z
+            .string()
+            .min(1)
+            .describe("The Pulse item slug (preferred — looks like 'trump-china-tariff-2026-04-01') or its uuid."),
+    }, async ({ identifier }) => {
+        try {
+            const env = await client.get(`/pulse/${encodeURIComponent(identifier)}`);
+            const item = env.data;
+            const date = new Date(item.publishedAt).toISOString().slice(0, 10);
+            const body = [
+                `${item.subject}`,
+                `Published: ${date} | Source: ${item.source}${item.conditionId ? ` | conditionId: ${item.conditionId}` : ""}`,
+                `Permalink: ${item.permalink}`,
+                ``,
+                (item.content ?? "").trim(),
+            ].join("\n");
+            return formatEnvelope("FlowFrame Pulse item:", env, body);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool("flowframe_get_pulse_for_market", "Get all FlowFrame Pulse items written about a specific Polymarket market, identified by " +
+        "its conditionId (a 0x-prefixed hex string from polymarket.com URLs or any Polymarket API). " +
+        "Use when the user references a specific market and asks 'what does FlowFrame say about this'. " +
+        "Returns up to 100 items, newest first. Returns an empty list if FlowFrame hasn't covered " +
+        "that market or if it's a Kalshi-only market (Kalshi markets aren't matched by conditionId).", {
+        conditionId: z
+            .string()
+            .min(3)
+            .describe("Polymarket conditionId, e.g. '0x1234...'. Required."),
+    }, async ({ conditionId }) => {
+        try {
+            const env = await client.get(`/pulse/by-market/${encodeURIComponent(conditionId)}`);
+            if (env.data.length === 0) {
+                return formatEnvelope(`No FlowFrame Pulse coverage for market ${conditionId}.`, env, "");
+            }
+            const body = env.data
+                .map((item, i) => {
+                const date = new Date(item.publishedAt).toISOString().slice(0, 10);
+                const snippet = (item.content ?? "").replace(/\s+/g, " ").trim().slice(0, 400);
+                return `${i + 1}. ${item.subject} (${date})\n   ${snippet}\n   ${item.permalink}`;
+            })
+                .join("\n\n");
+            return formatEnvelope(`FlowFrame Pulse coverage for market ${conditionId} (${env.data.length} item(s)):`, env, body);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ─────────────────────────────────────────────────────────────────────────
+    // Movers — Polymarket / Kalshi
+    // ─────────────────────────────────────────────────────────────────────────
+    server.tool("flowframe_polymarket_movers", "Top Polymarket markets by recent price change. Use when the user asks 'what's moving on " +
+        "Polymarket', 'biggest movers in the last X hours', or wants to find markets where " +
+        "consensus has shifted. Returns market title, current price, price at start of window, " +
+        "delta in percentage points, 24h volume, and the polymarket.com URL. Sorted by " +
+        "abs(delta) descending.", {
+        window: WindowEnum.optional().describe("Lookback window: 1h, 4h, 12h, or 24h. Default 24h."),
+        direction: DirectionEnum.optional().describe("'up' = only markets that moved up, 'down' = only down, 'both' = either direction (default)."),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(50)
+            .optional()
+            .describe("Number of markets to return (default 10, max 50)."),
+    }, async ({ window, direction, limit }) => {
+        try {
+            const env = await client.get("/movers/polymarket", {
+                window: window ?? "24h",
+                direction: direction ?? "both",
+                limit: limit ?? 10,
+            });
+            if (env.data.length === 0) {
+                return formatEnvelope("No Polymarket movers match those filters.", env, "");
+            }
+            const body = env.data
+                .map((m, i) => {
+                return [
+                    `${i + 1}. ${m.marketTitle ?? "(untitled)"}`,
+                    `   ${fmtPrice(m.priceFrom)} → ${fmtPrice(m.currentPrice)}  (${fmtPct(m.deltaPct)}, vol24h ${fmtUsd(m.volume24h)})`,
+                    `   ${m.polymarketUrl ?? ""}`,
+                ].join("\n");
+            })
+                .join("\n\n");
+            return formatEnvelope(`Top ${env.data.length} Polymarket movers (${env.meta.window ?? window ?? "24h"} window):`, env, body);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool("flowframe_kalshi_movers", "Top Kalshi markets by recent price change. Use when the user asks 'what's moving on " +
+        "Kalshi'. Returns market title, current price, delta, volume, and Kalshi URL. " +
+        "Use flowframe_polymarket_movers for Polymarket — Kalshi and Polymarket are separate venues " +
+        "with separate markets.", {
+        window: WindowEnum.optional().describe("Lookback window. Default 24h."),
+        direction: DirectionEnum.optional().describe("Direction filter. Default 'both'."),
+        limit: z.number().int().min(1).max(50).optional().describe("Default 10, max 50."),
+    }, async ({ window, direction, limit }) => {
+        try {
+            const env = await client.get("/movers/kalshi", {
+                window: window ?? "24h",
+                direction: direction ?? "both",
+                limit: limit ?? 10,
+            });
+            if (env.data.length === 0) {
+                return formatEnvelope("No Kalshi movers match those filters.", env, "");
+            }
+            // Kalshi prices are in cents (1..99). Convert to fraction for fmtPrice.
+            const centsToFrac = (n) => typeof n === "number" ? n / 100 : null;
+            const body = env.data
+                .map((m, i) => {
+                return [
+                    `${i + 1}. ${m.title ?? m.eventTitle ?? "(untitled)"}`,
+                    `   ${fmtPrice(centsToFrac(m.previousPrice))} → ${fmtPrice(centsToFrac(m.currentPrice))}  (${fmtPct(m.priceChangePercent)}, vol24h ${fmtUsd(m.volume24h)})`,
+                    `   ${m.kalshiUrl ?? ""}`,
+                ].join("\n");
+            })
+                .join("\n\n");
+            const note = env.meta.windowNote ? ` ${env.meta.windowNote}` : "";
+            return formatEnvelope(`Top ${env.data.length} Kalshi movers (24h since previous_yes_bid reset).${note}`, env, body);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ─────────────────────────────────────────────────────────────────────────
+    // Smart Money Skew
+    // ─────────────────────────────────────────────────────────────────────────
+    server.tool("flowframe_smart_money_skew", "Find Polymarket markets where the top 30 most-profitable traders (last 30d, ranked by P&L " +
+        "from predicting.top) are positioned disproportionately on one side compared to the market " +
+        "price. Use this to find markets where 'smart money' disagrees with the consensus. " +
+        "Returns: market title, current market price, smart-money implied fair value, edge (in " +
+        "percentage points), composite skew score, and per-tier dollar positions (Sharp = top 10, " +
+        "Profitable = 11-20, Recreational = 21-30). Sorted by composite score descending. " +
+        "For a single market's full breakdown by conditionId, use flowframe_smart_money_skew_for_market.", {
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(50)
+            .optional()
+            .describe("Number of markets to return (default 10, max 50)."),
+        minScore: z
+            .number()
+            .optional()
+            .describe("Filter to markets with composite skew score ≥ this value. Optional."),
+    }, async ({ limit, minScore }) => {
+        try {
+            const env = await client.get("/smart-money/skew", {
+                limit: limit ?? 10,
+                minScore,
+            });
+            if (env.data.length === 0) {
+                return formatEnvelope("No smart-money skew signals match those filters.", env, "");
+            }
+            const body = env.data
+                .map((m, i) => {
+                return [
+                    `${i + 1}. ${m.marketTitle ?? "(untitled)"}  [conditionId: ${m.conditionId}]`,
+                    `   Market price ${fmtPrice(m.marketPrice)} | Smart-money fair value ${fmtPrice(m.impliedFairValue)} | Edge ${fmtPct(m.edgePct)}`,
+                    `   Composite skew score: ${typeof m.compositeSkewScore === "number" ? m.compositeSkewScore.toFixed(2) : "n/a"}`,
+                ].join("\n");
+            })
+                .join("\n\n");
+            return formatEnvelope(`Top ${env.data.length} smart-money skew signal(s):`, env, body);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool("flowframe_smart_money_skew_for_market", "Get the full smart-money skew breakdown for a single Polymarket market by conditionId, " +
+        "including per-tier (Sharp / Profitable / Recreational) dollar positions and which side " +
+        "each tier is on. Use after flowframe_smart_money_skew when the user wants to drill into " +
+        "one specific market.", {
+        conditionId: z.string().min(3).describe("Polymarket conditionId. Required."),
+    }, async ({ conditionId }) => {
+        try {
+            const env = await client.get(`/smart-money/skew/${encodeURIComponent(conditionId)}`);
+            const m = env.data;
+            const tiers = m.tiers ?? {};
+            const tierLine = (name, t) => {
+                if (!t)
+                    return `   - ${name}: no data`;
+                const yes = Number(t.yesDollars ?? 0);
+                const no = Number(t.noDollars ?? 0);
+                const total = yes + no;
+                if (total === 0)
+                    return `   - ${name}: no positions`;
+                const side = yes >= no ? "YES" : "NO";
+                const dom = Math.max(yes, no);
+                const sharePct = (dom / total) * 100;
+                const skewStr = typeof t.skew === "number" ? `, skew ${t.skew.toFixed(2)}` : "";
+                return `   - ${name}: ${fmtUsd(dom)} on ${side} (${sharePct.toFixed(0)}% of tier capital${skewStr})`;
+            };
+            const body = [
+                `${m.marketTitle ?? "(untitled)"}  [conditionId: ${m.conditionId}]`,
+                `Market price ${fmtPrice(m.marketPrice)} | Smart-money fair value ${fmtPrice(m.impliedFairValue)} | Edge ${fmtPct(m.edgePct)}`,
+                `Composite skew score: ${typeof m.compositeSkewScore === "number" ? m.compositeSkewScore.toFixed(2) : "n/a"}`,
+                "Tier breakdown:",
+                tierLine("Sharp (top 10)", tiers.sharp),
+                tierLine("Profitable (11-20)", tiers.profitable),
+                tierLine("Recreational (21-30)", tiers.recreational),
+                m.lastUpdated ? `Last updated: ${m.lastUpdated}` : "",
+            ]
+                .filter(Boolean)
+                .join("\n");
+            return formatEnvelope("Smart-money skew detail:", env, body);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ─────────────────────────────────────────────────────────────────────────
+    // Mentions Hub — political speech transcripts
+    // ─────────────────────────────────────────────────────────────────────────
+    server.tool("flowframe_list_speakers", "List the political speakers (US politicians + Fed chair) whose public-domain transcripts " +
+        "are searchable via flowframe_search_political_mentions and flowframe_mention_frequency. " +
+        "Use when the user asks 'who can I search', 'which politicians are indexed', or before " +
+        "calling search/frequency tools to confirm the speaker slug. Returns slug (use this in " +
+        "other tools), display name, title, party, transcript count, and date range covered.", {}, async () => {
+        try {
+            const env = await client.get("/mentions/speakers");
+            const body = env.data
+                .map((s) => {
+                const range = s.earliestDate && s.latestDate
+                    ? ` (${s.earliestDate} → ${s.latestDate})`
+                    : "";
+                return `- ${s.slug} — ${s.name}${s.title ? `, ${s.title}` : ""}${s.party ? ` (${s.party})` : ""} — ${s.transcriptCount} transcripts${range}`;
+            })
+                .join("\n");
+            return formatEnvelope("Indexed political speakers:", env, body);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool("flowframe_search_political_mentions", "Search transcripts of US political speeches and Fed press conferences for a keyword or " +
+        "phrase. Returns transcripts (newest first) with snippet excerpts showing the keyword in " +
+        "context. Use when the user asks 'when did X talk about Y', 'has Powell mentioned tariffs', " +
+        "or wants verbatim quotes. Each result includes the transcript title, date, source, event " +
+        "format (rally / press conference / interview / etc.), the number of times the keyword " +
+        "appears in that transcript, and up to several snippets. Call flowframe_list_speakers first " +
+        "if you don't know the available speaker slugs.", {
+        q: z
+            .string()
+            .min(2)
+            .max(80)
+            .describe("Keyword or short phrase to search for, 2-80 chars. Case-insensitive. Slashes are OK " +
+            "(e.g. 'us/china' matches 'US/China' and 'US-China')."),
+        speaker: z
+            .enum(SPEAKER_SLUGS)
+            .optional()
+            .describe("Restrict to one speaker slug. Omit to search across all indexed speakers. " +
+            `Allowed: ${SPEAKER_SLUGS.join(", ")}.`),
+        limit: z.number().int().min(1).max(50).optional().describe("Default 10, max 50."),
+    }, async ({ q, speaker, limit }) => {
+        try {
+            const env = await client.get("/mentions/search", {
+                q,
+                speaker,
+                limit: limit ?? 10,
+            });
+            const meta = env.meta;
+            if (env.data.length === 0) {
+                return formatEnvelope(`No matches for "${q}"${speaker ? ` by ${speaker}` : ""}.`, env, "");
+            }
+            const body = env.data
+                .map((r, i) => {
+                const snippets = (r.snippets ?? [])
+                    .slice(0, 3)
+                    .map((s) => `      "${s.trim()}"`)
+                    .join("\n");
+                return [
+                    `${i + 1}. ${r.speakerName} — ${r.title} (${r.date})`,
+                    `   Source: ${r.source}${r.eventFormat ? ` | Format: ${r.eventFormat}` : ""} | Mentions: ${r.mentionCount}`,
+                    snippets,
+                    r.url ? `   ${r.url}` : "",
+                ]
+                    .filter(Boolean)
+                    .join("\n");
+            })
+                .join("\n\n");
+            const summary = `Found ${meta.totalMentions ?? "?"} mention(s) across ${meta.totalDocuments ?? env.data.length} transcript(s) for "${q}"${speaker ? ` by ${speaker}` : ""}. Showing ${env.data.length}:`;
+            return formatEnvelope(summary, env, body);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool("flowframe_mention_frequency", "Time-series of how often a keyword appears in a speaker's transcripts, grouped by day, " +
+        "week, month, or year. Use when the user asks 'how often does X mention Y over time', " +
+        "'is Trump talking about China more lately', etc. Returns periods with mention counts and " +
+        "transcript counts. If no speaker is given, aggregates across all indexed speakers.", {
+        q: z.string().min(2).max(80).describe("Keyword or phrase, 2-80 chars."),
+        speaker: z
+            .enum(SPEAKER_SLUGS)
+            .optional()
+            .describe(`Speaker slug. Allowed: ${SPEAKER_SLUGS.join(", ")}.`),
+        granularity: z
+            .enum(["day", "week", "month", "year"])
+            .optional()
+            .describe("Bucket size. Default 'month'."),
+    }, async ({ q, speaker, granularity }) => {
+        try {
+            const env = await client.get("/mentions/frequency", {
+                q,
+                speaker,
+                granularity: granularity ?? "month",
+            });
+            if (env.data.length === 0) {
+                return formatEnvelope(`No mentions of "${q}"${speaker ? ` by ${speaker}` : ""}.`, env, "");
+            }
+            const body = env.data
+                .map((row) => `  ${row.period}: ${row.mentionCount} mention(s) across ${row.transcriptCount} transcript(s)`)
+                .join("\n");
+            return formatEnvelope(`Mention frequency for "${q}"${speaker ? ` by ${speaker}` : ""} (${granularity ?? "month"}):`, env, body);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@flowframe22/mcp-server",
+  "version": "0.1.0",
+  "description": "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.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "flowframe-mcp-server": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "anthropic",
+    "polymarket",
+    "kalshi",
+    "prediction-markets",
+    "flowframe"
+  ],
+  "homepage": "https://flowframe.xyz/api-docs",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flowframe/mcp-server"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.4.0"
+  }
+}