About storyflo
storyflo is an MCP server published by Alisammour in the Blockchain category: **The audio-news + Declassified MCP that pays your agent to integrate.** Give your users narrated news and a viral library of real **FBI / CIA / NSA / NASA / AARO** declassified cases — plus market-linked story signal. The best tools are **free and no-auth**, so you wire it in and ship in seconds. **Why integrate** - 💸 **Earn** — `register_embedder` enrolls your agent in revenue share; every attributed impression pays out (fiat or USDC on Base). Almost no MCP pays you back. - ⚡ **Free, no-auth** — Declassified + discovery + narrated audio need zero signup. Try `search_declassified` in 30 seconds. - 🎧 **Content your users want** — narrated audio for any article, daily briefings, and an evergreen Declassified archive. **23 tools** across declassified, discovery, audio news, market signal, premium briefings (metered per-call via x402/USDC), and partner/earn. Remote endpoint: `https://api.storyflo.com/mcp/v1` · OAuth + Dynamic Client Registration (auto).
The repository has 2 stars and 0 forks, with the last commit 3 months ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/Alisammour/storyflo-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (20)
digesttop-N articles aggregated across verticals for a window
Parameters not published.
digest_declassifiedmost-recently-published Declassified cases over a window
Parameters not published.
get_articlefetch the full record + body text + audio URL by slug
Parameters not published.
get_audio_urlresolve the playable audio URL for an article
Parameters not published.
get_crypto_market_linkKraken affiliate markets link-out for crypto-relevant stories
Parameters not published.
get_declassified_casefull Declassified case record by slug
Parameters not published.
get_embedder_manifestthe embedder integration manifest
Parameters not published.
get_embedder_network_manifestthe embedder network manifest
Parameters not published.
get_market_linked_storiesstories matched to Kalshi event contracts (editorial, not advice)
Parameters not published.
get_personasthe host voices (Theo / Mason / Riley / Iris / Brock / Wit)
Parameters not published.
Show all 20 tools
get_trending_topicswhat's hot on Storyflo right now
Parameters not published.
get_vertical_landscapeone-shot per-vertical context for onboarding a listener
Parameters not published.
list_podcaststhe full catalog of audio shows (per-host + Declassified)
Parameters not published.
list_subscriptionslist feeds this agent has minted for the human
Parameters not published.
quote_partnershipexplore partnership tiers, creative formats + payout rails
Parameters not published.
register_embedderreturns a partner onboarding URL (no email/row created)
Parameters not published.
search_articlessearch the curated article corpus by query/vertical
Parameters not published.
search_declassifiedsubstring search across the Declassified case archive
Parameters not published.
subscribe_declassified_topicresolve a Declassified podcast-feed URL (read-only)
Parameters not published.
subscribe_topicmint/update a personal podcast RSS feed scoped to verticals
Parameters not published.
Ask AI
Ask AI about storyflo
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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 is a discovery + install reference. The Storyflo platform itself is proprietary; this README is what agents and humans need to integrate.
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
| Surface | URL |
|---|---|
| MCP transport | https://api.storyflo.com/mcp/v1 |
| Discovery manifest | https://api.storyflo.com/.well-known/mcp.json |
| OAuth (RFC 8414) | https://api.storyflo.com/.well-known/oauth-authorization-server |
| OpenAI tool spec | https://api.storyflo.com/v1/agents/openai-tools.json |
| API docs | https://storyflo.com/developers |
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 exposed
| Tool | Description |
|---|---|
search_articles |
Search the corpus, returns slug/title/publisher/snippet/audio_url |
get_article |
Full record + body_text + audio_url for a slug |
get_audio_url |
Resolve playable audio for an article |
subscribe_topic |
Update listener feed verticals; returns RSS feed URL |
list_subscriptions |
Listener feeds the agent has minted |
digest |
Aggregate top-N across selected verticals (heaviest action, paid via x402) |
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.
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.