storyflo-codex-plugin — плагин для Codex и Claude Code
Плагин storyflo-codex-plugin для Codex и Claude Code, подключающий агента к hosted MCP-серверу storyflo — «агентной новостной редакции».
MIT ★ 1 596 обновлён 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install storyflo-codex-plugin@awesome-codex-pluginsЧто делает storyflo-codex-plugin
Плагин работает в Codex и Claude Code и оборачивает удалённый MCP-сервер storyflo по адресу https://api.storyflo.com/v1/mcp/sse — конфиг лежит в .mcp.json, соединение по HTTPS SSE. Вместе с сервером ставится скилл skills/storyflo/SKILL.md, который учит агента, когда к нему обращаться. Внутри пять групп инструментов: брифинги (get_daily_briefing, get_vertical_briefing, digest, list_podcasts, get_audio_url), Divergence Index (get_divergence_index, get_market_linked_stories), поиск и статьи (search_articles, get_article, get_trending_topics, subscribe_topic), архив рассекреченных дел (search_declassified, get_declassified_case, digest_declassified) и вертикальная аналитика (get_vertical_landscape).
Divergence Index — качественный сигнал о том, где новостная повестка расходится с настроением рынков предсказаний; сырые коэффициенты и вероятности он не отдаёт, это не ценовая лента.
Доступ разделён на два уровня, и это важно знать до первого вызова. get_trending_topics, get_divergence_index, list_podcasts и весь архив declassified работают без авторизации. А вот search_articles, get_article, get_audio_url и get_vertical_briefing требуют OAuth-токен со scope articles:read — без него сервер отвечает 401 и заголовком WWW-Authenticate. Клиенты с поддержкой MCP OAuth проходят flow автоматически: есть dynamic client registration, ничего вручную запрашивать и никакой ключ вставлять не нужно.
Какие задачи решает
- получить дневной narrated-брифинг и разобрать главные новости
- увидеть, где новости расходятся с настроением prediction markets
- найти и открыть рассекреченное разведдело по теме
- собрать картину по предметной области: сущности, сюжеты, динамику
- подписать агента на тему через
subscribe_topic
Примеры запросов агенту
- Подними сегодняшний daily briefing из storyflo и перескажи главные сюжеты
- Посмотри Divergence Index и скажи, где новости сейчас расходятся с prediction markets
- Найди в архиве storyflo свежие рассекреченные дела по этой теме и открой самое релевантное
Как установить storyflo-codex-plugin
Через маркетплейс плагинов
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install storyflo-codex-plugin@awesome-codex-pluginsПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о storyflo-codex-plugin
Как установить storyflo-codex-plugin в Claude Code?
Сначала добавьте маркетплейс: /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем установите сам плагин: /plugin install storyflo-codex-plugin@awesome-codex-plugins. После этого сервер storyflo и прилагаемый скилл станут доступны агенту.
Что делает storyflo-codex-plugin?
Подключает агента к hosted MCP-серверу storyflo — «агентной новостной редакции»: narrated-брифинги с аудио, индекс расхождения новостей с prediction markets, полнотекстовый поиск статей и архив рассекреченных разведдел.
Нужен ли API-ключ или регистрация для storyflo?
Часть инструментов — get_divergence_index, get_trending_topics, весь declassified-архив — работает вообще без авторизации. Для search_articles, get_article и брифингов нужен OAuth-токен со scope articles:read; сервер поддерживает dynamic client registration, поэтому ключ вручную получать не нужно.
Исходный текст
storyflo-codex-plugin · MIT
# storyflo Codex Plugin
A Codex plugin that wraps [storyflo](https://www.storyflo.com)'s hosted MCP
server — an **agentic newsroom**. Install it to give Codex narrated news
briefings, the news-versus-prediction-market **Divergence Index**, a
**declassified archive** of released intelligence cases, and vertical (topic-area)
intelligence, all as source-grounded editorial context.
storyflo returns editorial signal and narrated context. It does **not** return
raw prediction-market odds or probabilities — the Divergence Index is a
qualitative signal, not a price feed.
## What storyflo is
storyflo is an agentic newsroom: it aggregates and narrates the news, tracks
where the news narrative is diverging from prediction-market sentiment, and
maintains a searchable archive of declassified intelligence cases. This plugin
exposes that newsroom to Codex over a single remote MCP endpoint.
## What the MCP server exposes
- **Narrated briefings** — daily and per-vertical briefings you can read or
listen to (`get_daily_briefing`, `get_vertical_briefing`, `digest`,
`list_podcasts`, `get_audio_url`).
- **Divergence Index** — a qualitative signal of where the news narrative is
diverging from prediction-market sentiment, with the underlying market-linked
stories (`get_divergence_index`, `get_market_linked_stories`).
- **Discovery & articles** — trending topics, full-text search, single-article
fetch, and topic subscriptions (`get_trending_topics`, `search_articles`,
`get_article`, `subscribe_topic`).
- **Declassified archive** — search, open, and digest released intelligence
cases (`search_declassified`, `get_declassified_case`, `digest_declassified`).
- **Vertical intelligence** — the landscape of a topic area: entities, threads,
and momentum (`get_vertical_landscape`).
## Add it to Codex
This plugin connects to storyflo's hosted MCP server over HTTPS
Server-Sent Events. No credentials are bundled in this repo, and none are
needed to install it.
**Two tiers, and it is worth knowing which is which before you call
something.** Measured against the live server on 2026-09-12:
*Callable with no credential at all* — the agent-discovery surface:
`get_trending_topics`, `get_personas`, `get_vertical_landscape`,
`list_podcasts`, `get_divergence_index`, the whole declassified library
(`search_declassified`, `get_declassified_case`, `digest_declassified`,
`subscribe_declassified_topic`), the publisher and fund-manager desk tools
(these carry their own access token in the call arguments), and the
partnership tools (`quote_partnership`, `register_embedder`).
*Require an OAuth bearer token, scope `articles:read`* — `search_articles`,
`get_article`, `get_audio_url`, `digest`, `list_subscriptions`,
`subscribe_topic`, `get_market_linked_stories`, `get_crypto_market_link`,
`get_vertical_briefing`.
A call without a token returns `401` with a `WWW-Authenticate` header
pointing at
`https://api.storyflo.com/.well-known/oauth-protected-resource/mcp/v1`.
Clients that support MCP OAuth complete that flow automatically; the
authorization server supports dynamic client registration, so there is
nothing to request by email and no key to paste.
An earlier version of this file said "No API key is required for the public
tools" without that split, which read as though `search_articles` would just
work. It does not — it 401s — and an agent that is told otherwise fails on
its first useful call.
The server is configured in [`.mcp.json`](./.mcp.json):
```json
{
"mcpServers": {
"storyflo": {
"url": "https://api.storyflo.com/v1/mcp/sse",
"type": "sse"
}
}
}
```
Install this repo as a Codex plugin (via the HOL registry or by pointing a
marketplace source at this repository), and the `storyflo` MCP server plus the
bundled [`storyflo` skill](./skills/storyflo/SKILL.md) become available to your
agent.
## Example prompts
- "Pull today's storyflo daily briefing and summarize the top stories as a
narrated digest."
- "Read the storyflo Divergence Index and tell me where the news narrative is
diverging from prediction-market sentiment right now."
- "Search the storyflo declassified archive for recently released intelligence
cases on this topic and open the most relevant one."
## Contents
```
.codex-plugin/plugin.json # plugin manifest
.mcp.json # remote MCP server (SSE) configuration
skills/storyflo/SKILL.md # skill teaching agents how/when to use storyflo
assets/icon.png # composer icon (512x512)
assets/logo.svg # storyflo mark
SECURITY.md # vulnerability disclosure policy
LICENSE # MIT
```
## Security
See [`SECURITY.md`](./SECURITY.md). Report vulnerabilities privately to
[[email protected]](mailto:[email protected]).
## Links
- Website: [https://www.storyflo.com](https://www.storyflo.com)
- MCP endpoint: `https://api.storyflo.com/v1/mcp/sse`
## License
[MIT](./LICENSE) © 2026 Storyflo
© Storyflo · MIT · hashgraph-online/awesome-codex-plugins