Storyflo MCP Server

Storyflo MCP Server

Official Model Context Protocol server for Storyflo — a curated audio-news platform that narrates trending articles + listener-forwarded newsletters and exposes them as a callable surface for any LLM agent.

This repository contains a zero-dependency stdio bridge (src/index.js) that relays MCP JSON-RPC between a local stdio client and the hosted streamable-http endpoint, plus discovery + install references. The Storyflo platform itself is proprietary; agent integration through the public API is the supported surface.

Run the stdio bridge

npx storyflo-mcp            # or: node src/index.js

Or via Docker:

docker build -t storyflo-mcp .
docker run -i --rm storyflo-mcp

Environment variables:

Claude Desktop / any stdio-only MCP client config:

{
  "mcpServers": {
    "storyflo": {
      "command": "npx",
      "args": ["-y", "storyflo-mcp"],
      "env": { "STORYFLO_TOKEN": "<optional bearer>" }
    }
  }
}

What you can do

• Search Storyflo's article corpus by vertical (tech, finance, science, media, sports, culture, + 30 more)
• Fetch full articles + audio URLs
• Resolve playable audio (free tier) or premium-quality audio (Plus tier)
• Subscribe topic feeds on the listener's behalf
• Aggregate top-N daily briefings

Endpoints

One-click install

Cursor

cursor://anysphere.cursor-deeplink/mcp/install?name=storyflo&config=eyJ1cmwiOiAiaHR0cHM6Ly9hcGkuc3RvcnlmbG8uY29tL21jcC92MSJ9

Add Storyflo to Cursor

Claude Desktop / claude.ai

Settings → Connectors → Add custom connector → URL:

https://api.storyflo.com/mcp/v1

Any MCP-compatible client (Continue, Cline, Zed, Windsurf, ChatGPT Custom Connectors)

{
  "mcpServers": {
    "storyflo": {
      "url": "https://api.storyflo.com/mcp/v1",
      "transport": "streamable-http"
    }
  }
}

Tools

Storyflo exposes 7 tools. Free-tier tools require OAuth only. Premium tools settle per-call via x402 over USDC on Base mainnet — the agent's payment shim runs before the tool is invoked.

The live tool manifest (with full JSON Schema for every parameter) is at /v1/agents/openai-tools.json — the source of truth Glama, OpenAI, and Anthropic introspect.

search_articles · free

Search Storyflo's curated article corpus by query and/or vertical. Use this when the agent needs to find articles matching a topic before deciding which one to read or play.

Parameters

Returns — array of { slug, title, publisher, vertical, snippet, audio_url, listen_seconds, published_at }.

---

get_article · free

Fetch the full record for a single article by slug. Use after search_articles when the agent needs the full body text or full audio URL.

Parameters

Returns — { slug, title, body_text, audio_url, publisher, vertical, sources[], published_at }.

---

get_audio_url · free

Resolve the playable audio URL for an article without fetching the body. Use when the agent wants to hand off audio playback to the user. Free tier returns a stitched-with-ad URL; Plus/Pro returns the bare audio.

Parameters

Returns — { slug, audio_url, listen_seconds, tier }.

---

subscribe_topic · paid (x402)

Mint or update the listener's personal podcast feed for a set of verticals. Persistent side effect: a feed row is created or updated server-side and the listener gets an RSS URL to paste into Spotify / Apple Podcasts / Pocket Casts. Subsequent calls overwrite the previous vertical selection on the same listener.

Parameters

Returns — { feed_url, verticals, listener_token }.

Cost — single x402 charge (~$0.005 USDC), no per-item cost.

---

list_subscriptions · free

Return the listener feeds this agent has minted on the human's behalf. Use before subscribe_topic to avoid creating duplicate feeds.

Parameters — none.

Returns — array of { feed_url, verticals, created_at }.

---

get_vertical_briefing · paid (x402)

Fetch a stitched audio briefing of the top-25 trending articles in a single vertical from the last 24h. Use when the agent wants a "today's headlines for X" experience for the user. Read-only — no listener state mutated.

Parameters

Returns — { vertical, audio_url, item_count, listen_seconds, articles[] }.

Cost — single x402 charge; covers the full stitched briefing audio.

---

digest · paid (x402, heaviest)

Aggregate the top-N articles across one or more verticals for a window (24h / 7d / 30d). The heaviest action — counts most against per-agent rate limit. Use for "read me today's tech + finance news" prompts where the agent wants a curated cross-vertical roll-up rather than a single vertical's briefing.

Parameters

Returns — { window, verticals, items: [{ slug, title, vertical, audio_url, snippet }] }.

Cost — single x402 charge; counts as one heavy action against the agent's rate limit.

Authentication

OAuth 2.1 + PKCE. Public clients (Claude/ChatGPT/Cursor's MCP connectors) auto-register via Dynamic Client Registration (RFC 7591) at /oauth/register. No manual API key needed.

x402 micropayments

Premium tools are metered via x402 over USDC on Base mainnet. Agents pay per call, no upfront contract. Free-tier tools (search_articles, list_topics, get_daily_briefing) require no payment.

70/20/10 revenue split: 70% to the publisher, 20% to the recommending agent, 10% to Storyflo. On-chain and deterministic.

SDK

Native client libraries for TypeScript and Python:

npm install storyflo-sdk      # https://www.npmjs.com/package/storyflo-sdk
pip install storyflo          # https://pypi.org/project/storyflo/

Install via Smithery

npx -y @smithery/cli install storyflo

Logo

The Storyflo brand mark for client UIs: https://storyflo.com/icon-512.png

Support

• Developer questions: api@storyflo.com
• Bug reports: open an issue on this repo
• Discord: TBD

License

MIT for this repository's content (README + manifest references). The Storyflo platform itself is proprietary; agent integration through the public API is the supported integration surface.