OneInterface/stormy-cookbook

View on GitHub ↗

Open-source cookbook for the Stormy Social Data API and MCP server (Model Context Protocol) — one REST API for the TikTok API, YouTube API, Instagram API, LinkedIn API, X (Twitter) API and Reddit API. Search creators, resolve profiles, read posts and find verified emails from Claude, Cursor, Codex, ChatGPT or curl. One key, no scrapers.

59 ★0 forksUpdated 1mo ago

What you need to know

Open-source, copy-pasteable recipes for the Stormy Social Data API and Stormy MCP server, providing one REST contract and one MCP endpoint for Instagram, YouTube, TikTok, X, LinkedIn, and Reddit.

Install

Connect the MCP server at https://stormy.ai/mcp with a bearer token
Or call the REST API at https://stormy.ai/api/v1
Get an API key at stormy.ai/account

Usage

  • •Search creators, look up profiles, and find verified emails across six networks
  • •Estimate price before spending with the free pricing endpoint
  • •Start durable jobs for large collections with idempotency keys

Key features

  • ✓10 MCP tools including search_people, lookup_profile, find_emails, estimate_price, and job management
  • ✓One HTTP contract across six social networks
  • ✓Cache-first routing with fresh live data option
  • ✓Durable jobs that never fail on rate limits
  • ✓Per-call usage receipts and outcome-based billing
  • ✓Machine-readable contract at /capabilities and OpenAPI spec

Best for

Teams building influencer research, outreach, and social-data workflows for AI agents.

Caveats

  • ⚠Paid service; free tier limited to 50 cached results per 30 days
  • ⚠Contact emails limited to Instagram, TikTok, and YouTube
  • ⚠Never put the API key in a URL, prompt, or tool argument
Clients: Claude Code · Codex CLI · Cursor · Windsurf · ChatGPT

Reviewed 2026-08-11

Topics

ai-agentsclaudeclaude-desktopcreator-economycursoremail-finderinfluencer-marketinginstagram-apilead-generationlinkedin-apimcpmcp-servermodel-context-protocolreddit-apisocial-mediasocial-media-apitiktoktiktok-apitwitter-apiyoutube-api
Stars
59★
Forks
0
Language
—
License
MIT
Created
2026-07-27
Last push
2026-07-27