Storyflo

Storyflo MCP 服务

Storyflo 的官方模型上下文协议服务：Storyflo 提供精选音频新闻、每日简报、公开的解密档案库（FBI/CIA/NSA/NASA/DOJ/AARO 发布内容）以及与市场关联的故事信号，所有内容均可供任何大模型 Agent 调用。

**Claude Desktop 一键安装 .mcpb：**如需免配置安装 Claude Desktop，请参阅配套扩展仓库 Alisammour/storyflo-mcp-extension。

此仓库包含一个零依赖的 stdio 桥接程序（src/index.js），可在本地 stdio 客户端与托管的 streamable-http 端点之间转发 MCP JSON-RPC，还提供发现和安装参考。Storyflo 平台本身为专有平台；通过公共 API 集成 Agent 是受支持的接入方式。

安装 — 一键安装

Claude Code： claude mcp add --transport http storyflo https://api.storyflo.com/mcp/v1 任何远程客户端： https://api.storyflo.com/mcp/v1（streamable-http） · stdio： npx storyflo-mcp

最实用的工具免费且无需身份验证——几秒钟内即可试用 search_declassified（FBI/CIA/NSA/NASA 的真实案例），然后通过集成 register_embedder 赚取收入分成。

运行 stdio 桥接程序

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

或者通过 Docker 运行：

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

环境变量：

变量	默认值	用途
STORYFLO_MCP_URL	https://api.storyflo.com/mcp/v1	上游 MCP 端点
STORYFLO_TOKEN	(unset)	用于 tools/call 的 OAuth bearer；发现功能（initialize、ping、tools/list、resources/list）可匿名使用

Claude Desktop / 任何仅支持 stdio 的 MCP 客户端配置：

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

你可以做什么

• 音频新闻 — 按垂直领域（tech、finance、science、media、sports、culture 等）搜索 Storyflo 精选内容库、获取完整文章并解析可播放音频
• 每日简报 — 汇总跨领域精选内容（digest），或生成串接的单一领域音频简报（get_vertical_briefing，高级功能）
• 解密档案库 — 播报 FBI/CIA/NSA/NASA/DOJ/AARO 发布内容，公开且无需身份验证
• 市场关联信号 — 将 Storyflo 故事与 Kalshi 事件合约匹配，并提供 Kraken 加密货币市场外链（仅供编辑参考，不构成投资建议）
• 发现 — 热门话题、主播角色、各垂直领域概况、完整播客目录
• 订阅 — 代表听众为文章或解密档案创建个人播客订阅源
• 合作伙伴集成 — 注册为嵌入方，并了解合作层级和收入分成的付款渠道

端点

接口	URL
MCP 传输	https://api.storyflo.com/mcp/v1
发现清单	https://api.storyflo.com/.well-known/mcp.json
OAuth（RFC 8414）	https://api.storyflo.com/.well-known/oauth-authorization-server
OpenAI 工具规范	https://api.storyflo.com/v1/agents/openai-tools.json
API 文档	https://www.storyflo.com/developers

一键安装

Cursor

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

将 Storyflo 添加到 Cursor

Claude Desktop / claude.ai

设置 → 连接器 → 添加自定义连接器 → URL：

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

任何兼容 MCP 的客户端（Continue、Cline、Zed、Windsurf、ChatGPT 自定义连接器）

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

工具

Storyflo 提供 21 个工具（20 个免费 + 1 个高级），分为三个身份验证层级：

公开（无需身份验证，无需 OAuth 流程） — 专为任何大模型 Agent 设计，让其无需 OAuth 握手，即可在全新安装的客户端中浏览并推荐内容：

工具	功能
search_articles	按查询词/垂直领域搜索精选文章库
get_article	按 slug 获取完整记录、正文和音频 URL
get_audio_url	获取文章可播放的音频 URL
get_trending_topics	查看 Storyflo 当前热门内容
get_personas	主持人声音（Theo / Mason / Riley / Iris / Brock / Wit）
get_vertical_landscape	一次性获取各垂直领域的背景信息，用于引导听众
list_podcasts	音频节目完整目录（各主持人节目 + Declassified）
digest	按时间范围汇总各垂直领域排名前 N 的文章
get_market_linked_stories	获取与 Kalshi 事件合约匹配的故事（编辑内容，不构成建议）
get_crypto_market_link	获取与加密货币相关故事的 Kraken 联盟市场外链
search_declassified	在 Declassified 案件档案中进行子串搜索
get_declassified_case	按 slug 获取完整的 Declassified 案件记录
digest_declassified	获取指定时间范围内最近发布的 Declassified 案件
subscribe_topic	创建/更新按垂直领域筛选的个人播客 RSS 订阅源
subscribe_declassified_topic	获取 Declassified 播客订阅源 URL（只读）
list_subscriptions	列出此 Agent 为用户创建的订阅源
register_embedder	返回合作伙伴入驻 URL（不会创建电子邮件或数据库记录）
get_embedder_manifest	嵌入方集成清单
get_embedder_network_manifest	嵌入方网络清单
quote_partnership	了解合作伙伴层级、创意形式和付款渠道

注意：subscribe_topic、subscribe_declassified_topic 和 list_subscriptions 为便于发现而列为公开工具；创建/列出听众订阅源的调用会在 OAuth bearer 存在时通过它解析身份。

高级（通过 Base 主网上的 USDC 使用 x402） — get_vertical_briefing：汇集过去 24 小时内某个垂直领域排名前 25 的热门文章，生成音频简报。

实时工具清单（含每个参数的完整 JSON Schema）位于 /v1/agents/openai-tools.json — 这是 Glama、OpenAI 和 Anthropic 检索信息时的权威来源。

Declassified 资料库 · 公开 · 无需身份验证（新增，2026-06-20）

Declassified 资料库是 Storyflo 对 FBI、CIA、NSA、NASA、DOJ、AARO、war.gov 及其他机构公开发布的政府文件进行讲述的档案。每个案件都附有讲述版音频、文字稿摘录和源文件链接。下方的 4 个工具可浏览同一档案库，该档案库也为 /declassified FE 栏目和公开的 Declassified RSS 订阅源提供数据支持。

search_declassified · public

按案件标题和简介进行子串搜索。每个匹配项返回 {slug, title, dek, episode_date, duration_sec, agency, category, era, audio_url}。

参数：query（字符串，必填）、limit（整数，1-50，默认值为 10）。

get_declassified_case · public

按 slug 获取完整案件记录。返回 {slug, title, dek, summary, transcript_excerpt, episode_date, duration_sec, agency, category, era, cover_url, audio_url, source_doc_url, related_cases:[{slug, title}]}。

参数：slug（字符串，必填）。

digest_declassified · public

获取滚动时间范围内最近发布的案件。返回与 search_declassified 相同的卡片格式。

参数：window（today | week（默认值）| month）、limit（整数，1-50，默认值为 10）。

subscribe_declassified_topic · public

解析播客源 URL，用户可将其粘贴到 Apple Podcasts、Overcast、Pocket Casts 或 Spotify，以自动接收所有新发布的 Declassified 案件。返回 {topic, rss_feed_url, archive_url, episodes_url, matched_so_far, note}。此功能按设计为只读：不会写入 DB 行，不会存储电子邮件，RSS 源本身就是订阅。

参数：topic（字符串，必填）、email（字符串，可选——仅供参考，绝不存储）。

search_articles · free

按查询词和／或垂直领域搜索 Storyflo 精选文章库。当 Agent 需要先查找符合主题的文章，再决定阅读或播放哪一篇时使用。

参数

name	type	required	description
query	string	no	根据标题、正文和摘要进行全文查询。不填则可在垂直领域内浏览，不受关键词筛选。
vertical	enum	no	可选值：tech、finance、science、media、sports、culture。将结果限定在单个垂直领域内。
limit	int	no	结果数量上限（默认值为 10，最多 25）。

返回值 — { slug, title, publisher, vertical, snippet, audio_url, listen_seconds, published_at } 数组。

---

get_article · free

按 slug 获取单篇文章的完整记录。当 Agent 需要完整正文或完整音频 URL 时，在调用 search_articles 后使用。

参数

name	type	required	description
slug	string	yes	文章 slug，与 search_articles 返回的值相同。

返回值 — { slug, title, body_text, audio_url, publisher, vertical, sources[], published_at }。

---

get_audio_url · free

解析文章的可播放音频 URL，无需获取正文。当 Agent 想要将音频播放交给用户时使用。免费套餐返回拼接广告后的 URL；Plus/Pro 返回原始音频。

参数

name	type	required	description
slug	string	yes	文章 slug。

返回值 — { slug, audio_url, listen_seconds, tier }。

---

subscribe_topic · 免费

为用户创建或更新个人 Storyflo 播客订阅源。传入 1–6 个垂直领域标识，服务端会创建一个仅涵盖这些领域的私有 RSS 订阅源；如果听众已有订阅源，则会原地更新。返回的 RSS URL 可由听众粘贴到 Spotify、Apple Podcasts、Pocket Casts 或任何播客客户端中。

行为

• 服务端持久化副作用 — 创建或更新一条 ListenerSubscription 记录。对于同一位听众，返回的 RSS URL 在多次调用中保持不变（无需重新粘贴）。
• 相同输入具有幂等性 — 使用相同的垂直领域再次调用，不会改变状态。
• 不同输入会替换原有内容 — 使用不同的垂直领域集合调用时，会覆盖之前的选择，而不是追加。用此操作切换听众的订阅源；请勿用它逐步添加垂直领域。如需追加，请先通过 list_subscriptions 读取当前集合，再传入合并后的集合。
• 每位听众仅有一个订阅源 — 先调用 list_subscriptions，以免覆盖听众明确选择的现有订阅源。

适用于 Agent 受托为用户设置涵盖特定主题的音频新闻订阅。请勿用于获取文章或音频——应使用 search_articles + get_audio_url。

参数

name	type	required	description
verticals	array<enum>	是	从 tech、finance、science、media、sports、culture 中选择 1–6 个不重复的标识。替换（而非追加到）听众当前的选择。

返回值 — { feed_url, verticals, listener_token }。

---

list_subscriptions · 免费

返回此 Agent 代表用户创建的听众订阅源。调用 subscribe_topic 前使用，以避免创建重复订阅源。

参数 — 无。

返回值 — { feed_url, verticals, created_at } 数组。

---

get_vertical_briefing · 付费（x402）

获取单个垂直领域过去 24h 内排名前 25 的热门文章合成的音频简报。当 Agent 想为用户提供“X 的今日头条”体验时使用。只读 — 不会修改听众状态。

参数

name	type	required	description
vertical	enum	是	tech、finance、science、media、sports、culture、news 之一。

返回值 — { vertical, audio_url, item_count, listen_seconds, articles[] }。

费用 — 单次 x402 收费；涵盖完整的合成简报音频。

---

digest · 免费（开销最大）

按时间范围（24h / 7d / 30d）汇总一个或多个垂直领域的前 N 篇文章。这是开销最大的操作，对每个 Agent 的速率限制影响最大。适用于“读给我听今天的科技 + 财经新闻”这类提示词：Agent 需要的是跨垂直领域的精选汇总，而非单个垂直领域的简报。

参数

name	type	required	description
verticals	array	否	1–6 个垂直领域。省略时默认为全部 6 个。
window	enum	否	24h（默认）、7d 或 30d。
limit	int	否	每个垂直领域的文章上限（默认 5，最多 25）。

返回值 — { window, verticals, items: [{ slug, title, vertical, audio_url, snippet }] }。

---

get_market_linked_stories · 免费

Storyflo 中与正在交易的 Kalshi 事件合约匹配的故事——Kalshi 是受 CFTC 监管的指定合约市场。每个条目都附带定性信号标签，以及指向 Kalshi 自有页面的链接，实时市场数据可在该页面查看。

这是一个编辑选材入口，而非市场数据再分发。Storyflo 绝不会在此负载中返回原始价格、市场隐含概率、交易量或未平仓合约数。Agent 或用户可点击链接，在 Kalshi 上查看实时数据。

适用场景：Agent 需要了解哪些 Storyflo 故事涉及存在活跃交易事件合约的新闻主题，例如世界杯赛事、政治人物提及合约、企业事件。形式与新闻编辑室引用 CME 期货相同：市场活动有助于判断哪些故事值得呈现。

参数

名称	类型	必填	描述
vertical	字符串	否	按故事垂直领域筛选（例如 news、finance、tech、crypto）。
category	字符串	否	按 Kalshi 事件类别筛选（例如 Politics、Economics、Companies、Science and Technology、Sports）。
signal	枚举	否	可选值：active、high_velocity、genuine_uncertainty。high_velocity = 匹配的市场在过去 24 小时内出现显著重新定价；genuine_uncertainty = 市场处于 40–60% 区间，表明市场本身存在不确定性。
limit	整数	否	最大条目数（默认值为 10，上限为 50）。

返回值 — 数组：

{
  "story": { "slug", "title", "vertical", "published_at" },
  "matched_market": { "title", "category", "url" },
  "signal_tags": ["active", "high_velocity"?, "genuine_uncertainty"?],
  "match": { "score", "shared_terms" }
}

此外，每个负载的顶层都包含 attribution 和 disclaimer 字符串。

matched_market.url 链接到 Kalshi 自有的事件页面，用户 / Agent 可在数据来源处查看实时市场数据。Storyflo 不会再分发这些数据。

合规措施（经法律顾问审查；在 CI 中进行回归测试）：

• 词汇限制：任何界面中都不得使用 bets、odds、picks 或 wagers
• 每个负载都附带来源标注："Market data: Kalshi, a CFTC-regulated designated contract market"
• 每个负载都附带免责声明：市场隐含概率是交易所价格，并非 Storyflo 预测，也不构成投资建议；故事与市场的链接表示主题相关性，而非因果关系；仅供参考
• 流动性下限（vol24h ≥ 100 或 OI ≥ 1000），用于排除可能被操纵后进入信息流的低流动性市场
• 排除接近结算的市场（隐含概率低于 3% 或高于 97%），仅保留前瞻性信号
• 输入而非输出：原始价格、概率、交易量和未平仓合约数会在内部计算，用于排序，但绝不会公开在负载中。链接是用户在 Kalshi 自有界面查看实时数据的途径。

身份验证

OAuth 2.1 + PKCE。公共客户端（Claude/ChatGPT/Cursor 的 MCP 连接器）通过 /oauth/register 使用动态客户端注册（RFC 7591）自动注册。无需手动提供 API 密钥。

x402 微支付

高级工具（get_vertical_briefing）通过 Base 主网上的 USDC 使用 x402 计量收费。Agent 按调用付费，无需预先签订合约。其余 20 个工具均无需付费——Declassified、发现和合作伙伴工具完全无需身份验证，listener / article 工具仅需 OAuth。

收入按 70/20/10 分成：70% 给发布方，20% 给推荐该内容的 Agent，10% 给 Storyflo。链上执行且具有确定性。

SDK

适用于 TypeScript 和 Python 的原生客户端库：

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

通过 Smithery 安装

npx -y @smithery/cli install storyflo

Logo

Storyflo 品牌标识，供客户端 UI 使用： https://www.storyflo.com/icon-512.png

相关 MCP 服务

如果你发布的 Agent 使用 storyflo，也可以考虑以下服务——它们采用相同的基于 Base 的 x402 变现通道，面向 Agent 的设计理念相似，或是在新闻 / 金融 / 音频类别领域的自然补充。

相同支付通道（Base 上通过 USDC 使用 x402）

• forgemeshlabs/coinopai-mcp — 通过 Base 上的 USDC 小额支付提供付费加密货币情报（交易决策、基于真实价格的审计、信号历史）。
• 8randonpickart5/alderpost-mcp — 通过 Base 上的 x402 提供八个打包的情报端点（安全、公司、威胁、合规、销售、体育、房地产、健康）。

金融 / 市场数据来源

• Yahoo Finance MCP server — 为需要证券级数据的 Agent 提供实时股票报价，可与 storyflo 的市场感知新闻信号配合使用。

新闻 + 文章来源

• angheljf/nyt — 搜索《纽约时报》文章。
• AceDataCloud/MCPSerp — 搜索 Google SERP（网页、图片、新闻、地图）。
• andybrandt/mcp-simple-arxiv — 搜索并阅读 arXiv 论文。
• Aas-ee/open-webSearch — 免费的多引擎网页搜索。

多媒体 / 音频相关工具

• AceDataCloud/MCPSuno — 使用 Suno AI 生成音乐并提取人声。
• bogdan01m/zapcap-mcp-server — 生成视频字幕和 B-roll。

Meta-MCP / 聚合器

• 1mcp/agent — 统一 MCP 服务，将多个 MCP 服务聚合为一个。
• tadas-github/a2asearch-mcp — 发现 4,800 多个 MCP 服务、Agent 和命令行工具。

如果你维护的 MCP 服务与 storyflo 配合自然，但尚未列出，请 提交 PR 或在 issue 中留言。我们每季度整理一次此列表。

支持

• 开发者问题：[email protected]
• Bug 报告：在此代码库中提交 issue
• Discord：待定

许可证

本代码库内容（README + 清单引用）采用 MIT 许可证。Storyflo 平台本身为专有平台；通过公共 API 集成 Agent 是受支持的集成方式。