Skip to main content
plugin CX Codex

storyflo-codex-plugin — Codex and Claude Code plugin: what it does

storyflo-codex-plugin is a plugin for Codex and Claude Code that connects an agent to storyflo's hosted MCP server, an agentic newsroom.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install storyflo-codex-plugin@awesome-codex-plugins
Open on GitHub

What storyflo-codex-plugin does

The plugin runs on Codex and Claude Code and wraps storyflo's remote MCP server at https://api.storyflo.com/v1/mcp/sse over HTTPS Server-Sent Events, configured in .mcp.json. Installing it also brings a bundled skill, skills/storyflo/SKILL.md, that teaches the agent when to call the newsroom. The server exposes five tool groups: briefings (get_daily_briefing, get_vertical_briefing, digest, list_podcasts, get_audio_url), the Divergence Index (get_divergence_index, get_market_linked_stories), article discovery (search_articles, get_article, get_trending_topics, subscribe_topic), the declassified archive (search_declassified, get_declassified_case, digest_declassified), and vertical intelligence (get_vertical_landscape).

The Divergence Index is a qualitative signal showing where the news narrative drifts away from prediction-market sentiment. It does not return raw odds or probabilities, so it works as editorial context, not a price feed.

Access comes in two tiers, worth knowing before the first call. get_trending_topics, get_divergence_index, list_podcasts, and the whole declassified library run with no credential at all. search_articles, get_article, get_audio_url, and get_vertical_briefing need an OAuth bearer token with scope articles:read; without it the server answers 401 with a WWW-Authenticate header.

What it helps with

  • pull the daily narrated briefing and recap the top stories
  • check where news coverage diverges from prediction-market sentiment
  • search the declassified archive and open a relevant case
  • map a topic area: entities, threads, and momentum
  • subscribe the agent to a topic with subscribe_topic

Example prompts for the agent

  • 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

How to install storyflo-codex-plugin

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install storyflo-codex-plugin@awesome-codex-plugins

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about storyflo-codex-plugin

How do I install storyflo-codex-plugin in Claude Code?

First add the marketplace: /plugin marketplace add hashgraph-online/awesome-codex-plugins, then install the plugin: /plugin install storyflo-codex-plugin@awesome-codex-plugins. The storyflo MCP server and its bundled skill become available to the agent.

What does storyflo-codex-plugin do?

It connects your agent to storyflo's hosted MCP server, an agentic newsroom: narrated briefings with audio, a Divergence Index comparing news coverage to prediction-market sentiment, full-text article search, and a declassified intelligence archive.

Does storyflo need an API key?

Part of it does not: get_divergence_index, get_trending_topics, and the full declassified library work with no credential. search_articles, get_article, and briefings require an OAuth token with scope articles:read; the server supports dynamic client registration, so there is no key to request or paste.

Source text

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

Similar plugins

All plugins for Agent setup: memory, context, orchestration →

From the same set391

The whole set →
tablejourney The plugin wires TableJourney's food travel data into Claude Code: checked places to eat, food festival dates and ready-made itineraries across 200+ cities. CX Codex ★ 1,596repo stars sysknife sysknife turns plain-English sysadmin requests into typed Linux actions with risk ratings. Runs operations through a privileged daemon only after explicit terminal approval. CX Codex ★ 1,596repo stars n8n-mcp-synta-codex n8n-mcp-synta-codex is a Claude Code plugin for building, editing, and checking n8n workflows. It connects to workflow debugging and repair tasks. CX Codex ★ 1,596repo stars swarmmemo Wires your assistant to the hosted SwarmMemo MCP server: a public board, questions to other agents, text screening, private threads and notes between runs. CX Codex ★ 1,596repo stars story-skills Plan and draft fiction in Markdown, then use the companion CLI to check continuity. Useful when story details need to hold together across chapters. CX Codex ★ 1,596repo stars solidworks-gpt-plugin The solidworks-gpt-plugin plugin for Claude Code uses five skills to take SolidWorks work from requirements through modeling to a measured, validated model and session report. CX Codex ★ 1,596repo stars solidping Connects Claude Code to SolidPing through a remote MCP server to monitor service uptime, inspect incidents, and update status pages. CX Codex ★ 1,596repo stars svatlas svatlas is a Claude Code plugin that searches profiles of AI startups and founders, then matches companies to a product. It also manages prospect lists. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open