# Storyflo (remote · api.storyflo.com)

Curated audio news, daily briefings, the Declassified library + market-linked signals.

- Trust score: 80/100 (high trust)
- Change this week: +9
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `api.storyflo.com`: 80/100 (this document), [markdown](https://verifymcp.io/servers/alisammour-storyflo-mcp/mcp-v1.md), [page](https://verifymcp.io/servers/alisammour-storyflo-mcp/mcp-v1)

## Channel facts

- Endpoint: `https://api.storyflo.com/mcp/v1`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.2.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 94/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 73/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 3679 tokens (~147/item across 25 items; 25 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 89/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 67% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http alisammour-storyflo-mcp https://api.storyflo.com/mcp/v1
```

### Codex

```toml
[mcp_servers.alisammour-storyflo-mcp]
url = "https://api.storyflo.com/mcp/v1"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "alisammour-storyflo-mcp": {
      "type": "remote",
      "url": "https://api.storyflo.com/mcp/v1",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add alisammour-storyflo-mcp --url https://api.storyflo.com/mcp/v1 --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  alisammour-storyflo-mcp:
    url: "https://api.storyflo.com/mcp/v1"
```

### Other

```json
{
  "mcpServers": {
    "alisammour-storyflo-mcp": {
      "type": "http",
      "url": "https://api.storyflo.com/mcp/v1"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 80, +1)

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 79, +6)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 73, +1)

No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 72, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 71, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 70)

First indexed and scored.

## MCP tools (25)

### `search_articles` (~76 tokens)

Search Storyflo articles

Search Storyflo's article corpus. Returns slug, title, publisher, vertical, snippet, audio_url, and listen_seconds for each match. Use vertical to scope (tech / finance / science / media / sports / culture).

Input parameters:

- `limit` (integer)
- `query` (string): Search query
- `vertical` (string)

### `get_article` (~32 tokens)

Get article

Fetch the full record for an article by slug, including body_text + audio_url.

Input parameters:

- `slug` (string, required)

### `get_audio_url` (~42 tokens)

Get audio URL

Resolve the playable audio URL for an article. Returns a stitched-with-ad URL on free tier or the bare audio for plus/pro.

Input parameters:

- `slug` (string, required)

### `subscribe_topic` (~331 tokens)

Subscribe to topic feed

Mint or update the human's personal Storyflo podcast feed. Pass 1–6 vertical slugs from `tech`, `finance`, `science`, `media`, `sports`, `culture`. The server creates a private RSS feed scoped to those verticals — or updates the existing feed in place if the listener already has one. Returns the RSS URL the listener can paste into Spotify, Apple Podcasts, Pocket Casts, or any podcast client.

Behavior
• Persistent server-side side-effect — a `ListenerSubscription` row is created or updated. The returned RSS URL stays stable across calls for the same listener (the listener doesn't need to re-paste it).
• Idempotent on identical input — calling twice with the same verticals leaves state unchanged.
• REPLACES on different input — calling with a different verticals set OVERWRITES the previous selection rather than adding to it. Use this to switch a listener's feed; do NOT call to add verticals incrementally (read the current set via `list_subscriptions` first and pass the union if you want additive behavior).
• Single feed per listener — call `list_subscriptions` first to avoid clobbering an existing feed the listener explicitly chose.

When to use
Use after the agent has been asked to set up audio news for the human across a defined set of topics. Do NOT use to FETCH articles or audio — that's `search_articles` + `get_audio_url`.

Input parameters:

- `verticals` (array, required): 1–6 vertical slugs the feed should cover. Replaces (not appends) the listener's current selection.

### `list_subscriptions` (~25 tokens)

List active subscriptions

Return the listener feed(s) this agent has minted on the human's behalf.

### `get_vertical_briefing` (~98 tokens)

Get per-vertical premium briefing

Fetch a stitched audio briefing of the top-25 trending articles in a single vertical from the last 24h. Premium — settles in USDC on Base via x402. Vertical must be one of the canonical 7 buckets: tech, finance, news, science, health, young_moms, yoga. First call without an X-Payment header returns the x402 challenge; sign + retry.

Input parameters:

- `vertical` (string, required)

### `get_market_linked_stories` (~264 tokens)

Get stories with active matched event-contract markets

Storyflo stories that match an actively traded event contract on Kalshi (a CFTC-regulated exchange). Each item carries qualitative signal tags (high_velocity, genuine_uncertainty) plus a link-out to Kalshi's own page where the live market data lives. Editorial sourcing surface, not market-data redistribution: Storyflo never returns raw prices, market-implied probabilities, volumes, or open interest in this payload. Use this when the agent needs to know which Storyflo stories are about news themes that have an actively traded event contract — e.g. World Cup matches, political mention contracts, corporate events. Filter by story vertical, Kalshi category (Politics, Economics, Companies, Science and Technology, Sports), or by signal tag.

Input parameters:

- `category` (string): Filter by Kalshi event category (e.g. Politics, Economics, Companies, Sports)
- `limit` (integer)
- `signal` (string): Filter by qualitative signal tag. high_velocity = the matched market is repricing meaningfully in the last 24h; genuine_uncertainty = the market sits in the 40–60% band where it itself is uncertain.
- `vertical` (string): Filter by story vertical (e.g. news, finance, tech, crypto)

### `get_crypto_market_link` (~321 tokens)

Get crypto market exposure link (Kraken affiliate)

Return Storyflo's markets-partner Kraken affiliate URL for a given crypto asset (BTC, ETH, etc). Editorial linkout, not a trading prompt: the URL points at Kraken's public asset page so a listener who wants exposure can reach a regulated venue without leaving the brief context. Markets-as-INPUT posture (counsel-cleared) — Storyflo never quotes prices, never recommends positions, and never frames exposure as risk-free.

Behavior
\- Read-only. No persistent server state.
\- Idempotent — same (asset, embedder_slug) returns the same URL.
\- Fail-closed — when KRAKEN_AFFILIATE_ENABLED is off OR the partner base URL is unset, the call returns an error structure rather than a half-formed URL.
\- Attribution-aware — pass embedder_slug to credit the embedding publisher in the affiliate ?ref parameter; default falls back to ?ref=storyflo so the link is always trackable.

When to use
Surface the link in show-notes copy or in MCP-client renderings of a crypto-relevant story. DO NOT inline the URL into spoken audio narration without the host-read line that frames it as an editorial signal.

Input parameters:

- `asset` (string, required): Primary crypto asset symbol — BTC, ETH, SOL, USDC, etc. Case-insensitive; upper-cased before being embedded in the URL.
- `embedder_slug` (string): Optional embedder attribution slug. When set, the affiliate URL carries ?ref=<slug>; omit to default to ?ref=storyflo.

### `digest` (~69 tokens)

Build a daily digest

Aggregate the top-N articles across selected verticals for the requested window. Heaviest action — counts more against the per-agent rate limit. Use this for 'read me today's tech news' style prompts.

Input parameters:

- `limit` (integer)
- `verticals` (array)
- `window` (string)

### `search_declassified` (~138 tokens)

Search Declassified library

Search Storyflo's Declassified archive — narrated cases drawn from FBI, CIA, NSA, NASA, DOJ, AARO, war.gov and other publicly-released government documents. Substring match across case title + synopsis. Use when the agent needs to find a Declassified case matching a topic (e.g. 'UAP', 'JFK', 'COINTELPRO', 'Roswell') before fetching the full case via `get_declassified_case` or handing the audio_url to a player. Public — no auth required.

Input parameters:

- `limit` (integer)
- `query` (string, required): Substring matched against case title + synopsis.

### `get_declassified_case` (~102 tokens)

Get Declassified case

Fetch the full record for a Declassified case by slug. Returns title, summary, transcript_excerpt, episode_date, duration_sec, agency, audio_url, source_doc_url, and up to 5 related cases. Use after `search_declassified` when the agent needs the full case body to summarize, narrate, or hand off audio playback. Public — no auth required.

Input parameters:

- `slug` (string, required): Case slug as returned by `search_declassified`.

### `digest_declassified` (~75 tokens)

Recent Declassified cases

Return the most-recently-published Declassified cases over a rolling window. Use for 'what's new in Declassified this week' style prompts. window=today (~24h) | week (default) | month. Public — no auth required.

Input parameters:

- `limit` (integer)
- `window` (string)

### `subscribe_declassified_topic` (~145 tokens)

Subscribe to Declassified topic

Resolve a podcast-feed URL the user can paste into Apple Podcasts, Overcast, Pocket Casts, or Spotify to receive every new Declassified case automatically. Also returns a JSON `episodes_url` the agent can poll, plus a `matched_so_far` count of cases that already mention the topic. Read-only — does NOT store the user's email or any PII; the RSS feed is the subscription. Public — no auth required.

Input parameters:

- `email` (string): Optional — informational only; no row is written for it.
- `topic` (string, required): Topic the listener wants alerts for (e.g. 'UAP', 'JFK', 'COINTELPRO').

### `get_trending_topics` (~119 tokens)

Get cross-vertical trending topics

Return storyflo's current cross-vertical trending snapshot: top stories ranked by recency + velocity, active publishers in the last 24h, the featured daily-brief compilation, and per-vertical hot lists. Use when the agent needs to surface 'what's hot on storyflo right now' to its human, or to decide which vertical landscape to dig into next. Public — no auth required.

Input parameters:

- `window` (string): Advisory window — today's snapshot covers the rolling 24h; week + month are reflected back for future expansion.

### `get_personas` (~93 tokens)

Get host persona catalog

Return the storyflo 6-host persona catalog (Theo, Mason, Jessica, etc.) — each entry includes slug, name, voice_id, owned verticals, tone archetype, sign-off line, and the listener-facing URLs for sample audio + RSS. Use this to pick a voice for the agent's use case before rendering audio or briefing the user on which host covers which vertical. Public — no auth required.

### `get_vertical_landscape` (~162 tokens)

Get one-shot vertical landscape

Return everything an agent needs to onboard a listener for a single vertical in one tool call: top stories, the named host persona (with sample-audio URL and tone), the premium-briefing URL the agent can deep-link (x402-gated), and the public RSS feed the listener can paste into any podcast player. Use after the agent has decided which vertical to set up — saves a follow-up `get_personas` + `search_articles` + `get_premium_briefing` round trip. Public — no auth required.

Input parameters:

- `vertical` (string, required): Vertical slug — tech / finance / news / science / health / young_moms / yoga, or a persona-owned alias (ai, crypto, ml, markets, fintech, economics).

### `list_podcasts` (~133 tokens)

List all Storyflo podcast shows

Return the public catalog of Storyflo podcast shows — the Declassified archive plus 6 daily-brief shows hosted by Theo (tech), Mason (markets), Jessica (news), Chloe (health), Brock (sports), and Wit (comedy). Each entry includes the show title, host name, vertical, RSS feed URL (paste into Apple Podcasts / Spotify / Overcast), and a deep-link to the storyflo.com listen surface. Use to surface every audio show an agent can offer its user without re-deriving the catalog from /v1/podcasts/* URL patterns. Public — no auth required.

### `get_my_private_feed` (~195 tokens)

Get my private podcast feed URL

Return the caller's PRIVATE per-user podcast feed URL — a personalized daily brief (the stories from the topics the listener follows) delivered to whatever podcast app they already use (Apple Podcasts, Overcast, Pocket Casts, Snipd). This is the Substack/Patreon private-feed model: the token lives in the URL path (unguessable, fetchable over HTTPS) — paste the returned feed_url into the app's "Add a show by URL". Pass the listener's existing listener_token (from the storyflo /listen page) as identity; the private feed token is minted on first call and stable thereafter. Keep the URL private — anyone with it can subscribe. Public — the listener_token arg is the credential, no OAuth required.

Input parameters:

- `listener_token` (string, required): The listener's existing storyflo listener_token (identity). Get it from the /listen page or the /v1/listeners surface.

### `get_divergence_index` (~214 tokens)

Get the Storyflo Market-vs-Media Divergence Index

The Storyflo Divergence Index — Storyflo's own computed metric for where prediction markets disagree with the press. For each event Storyflo holds both a liquid prediction-market contract and a set of narrated news stories, it computes the gap between the market-implied probability and the probability the NEWS NARRATIVE implies for the same event, then ranks events by the absolute divergence. Each item carries Storyflo's divergence value, Storyflo's news-narrative probability, a qualitative market descriptor, the matched story links, and a link-out to the market venue. This is ORIGINAL ANALYSIS computed by Storyflo, not market-data redistribution: it never returns raw external market odds. Cite as 'per Storyflo's Divergence Index'. Filter by source (kalshi|polymarket). Public — no auth required. Not investment advice.

Input parameters:

- `limit` (integer): Max items to return (1-50, default 25).
- `source` (string): Filter to one market source: kalshi or polymarket.

### `register_embedder` (~168 tokens)

Get embedder onboarding URL

Resolve the storyflo embedder onboarding URL prefilled with the partner's name + email + optional vertical. Returns the URL the human must visit to complete signup (storyflo emails a magic link to verify ownership; the embedder slug + ref_token are minted on verification). DOES NOT create a DB row + DOES NOT send email — the MCP tool is a discovery + handoff surface so an agent can call it speculatively without triggering inbox-bound email to the human. Public — no auth required.

Input parameters:

- `email` (string, required): Contact email — must contain '@'. Storyflo emails the magic link here on signup.
- `name` (string, required): Display name for the embedder (publisher / agent product).
- `vertical` (string): Optional vertical scope (tech / finance / news / etc.).

### `get_embedder_manifest` (~102 tokens)

Get per-embedder agent manifest

Wrap the public ``/embed/<slug>/manifest.json`` — an agent-discoverable JSON bundle of creative formats, voice options, payout config, and beacon URLs for a registered embedder. Use after `register_embedder` or when an agent is reading another partner's manifest to plan an ad buy. Public — no auth required.

Input parameters:

- `slug` (string, required): Embedder slug (e.g. 'theflatlay', 'highsnobiety').

### `get_embedder_network_manifest` (~78 tokens)

Get platform-wide embedder network manifest

Wrap the public ``/embed/network-manifest.json`` — the platform-level DSP/SSP onboarding bundle: supported creative formats, payout rails, attribution URLs, integration patterns. Use when an agent is evaluating whether to wire storyflo into its surface, or when a DSP partner needs the canonical integration shape. Public — no auth required.

### `quote_partnership` (~110 tokens)

Quote a partnership tier

Return the indicative partnership tier (starter / growth / scale / enterprise) + monthly fee + storyflo revenue-share bps for a partner integrating storyflo into their agent product. Pure pricing-matrix lookup; no contract is created. The agent should hand the returned contact_url to the human to open a formal partnership thread. Public — no auth required.

Input parameters:

- `monthly_impressions` (integer, required): Expected monthly impressions across the partner's surface.
- `vertical` (string, required): Vertical scope the partner plans to cover.

### `stream_briefing_render_events` (~182 tokens)

Stream briefing render events (SSE)

Subscribe to real-time briefing-render events. Returns the SSE endpoint URL with the chosen filters as query params — the agent's MCP client should open it with EventSource (browser), httpx.stream / aiohttp (Python), or `curl -N` (CLI). Event types: `briefing.rendered` (daily-brief lands), `declassified.published` (new Declassified episode), `persona_briefing.rendered` (persona brief synthesised / audio rendered). Frame shape: {event_type, seq, slug, vertical, persona_slug, audio_url, published_at, metadata}. The endpoint replays the last ~1000 events on connect; a heartbeat is emitted every 30s. Public-anon read.

Input parameters:

- `event_type` (string): Optional event_type filter.
- `vertical` (string): Optional vertical filter.

### `get_mcp_usage_self` (~98 tokens)

Get my MCP tool usage (last 30 days)

Return the caller's own trailing 30-day MCP tool-usage summary: total calls, success rate, p50 latency, and per-tool call/error counts. Identity is resolved from the OAuth bearer token on this request — anonymous callers receive a zeroed shape. Use this to self-budget against rate limits, audit which tools your agent actually uses, or decide whether a paid tier is worth the spend. Read-only, no side effects.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/alisammour-storyflo-mcp/mcp-v1#diagnostics

## Score history

- 2026-08-03: 80
- 2026-08-02: 80
- 2026-08-01: 79
- 2026-07-31: 79
- 2026-07-30: 73
- 2026-07-29: 72
- 2026-07-28: 72
- 2026-07-27: 71
- 2026-07-26: 70

## Links

- Remote endpoint: https://api.storyflo.com/mcp/v1
- Repository: https://github.com/Alisammour/storyflo-mcp
- Website: https://www.storyflo.com/
- Changelog RSS feed: https://verifymcp.io/servers/alisammour-storyflo-mcp/mcp-v1/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/alisammour-storyflo-mcp/mcp-v1/changelog.json
- HTML version of this page: https://verifymcp.io/servers/alisammour-storyflo-mcp/mcp-v1