{"version":"2026-01","endpoint":"https://api.storyflo.com/mcp/v1","auth":{"type":"oauth2","discovery":"https://storyflo.com/.well-known/oauth-authorization-server","free_tier":["search_articles","get_article","list_subscriptions"],"paid_tier_x402":["get_audio_url","subscribe_topic","digest"]},"tools":[{"type":"function","function":{"name":"search_articles","description":"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).","parameters":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"vertical":{"type":"string","enum":["tech","finance","science","media","sports","culture"]},"limit":{"type":"integer","minimum":1,"maximum":100,"default":20}}}}},{"type":"function","function":{"name":"get_article","description":"Fetch the full record for an article by slug, including body_text + audio_url.","parameters":{"type":"object","required":["slug"],"properties":{"slug":{"type":"string"}}}}},{"type":"function","function":{"name":"get_audio_url","description":"Resolve the playable audio URL for an article. Returns a stitched-with-ad URL on free tier or the bare audio for plus/pro.","parameters":{"type":"object","required":["slug"],"properties":{"slug":{"type":"string"}}}}},{"type":"function","function":{"name":"subscribe_topic","description":"Update the human's listener feed to the given verticals. Returns a podcast feed URL the listener can paste into Spotify, Apple Podcasts, etc.","parameters":{"type":"object","required":["verticals"],"properties":{"verticals":{"type":"array","items":{"type":"string","enum":["tech","finance","science","media","sports","culture"]}}}}}},{"type":"function","function":{"name":"list_subscriptions","description":"Return the listener feed(s) this agent has minted on the human's behalf.","parameters":{"type":"object","properties":{}}}},{"type":"function","function":{"name":"digest","description":"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.","parameters":{"type":"object","properties":{"verticals":{"type":"array","items":{"type":"string","enum":["tech","finance","science","media","sports","culture"]}},"window":{"type":"string","enum":["24h","7d","30d"],"default":"24h"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":5}}}}}],"revenue_share":{"publisher_pct":70,"agent_recommender_pct":20,"platform_pct":10,"settlement":"USDC on Base via x402"}}