Sonic MCP

Plug 11,000+ claims, 400+ episodes, and your theses/watchlist into Claude. Every tool returns grounded citations back to usesonicai.com.

Install: Claude Code

HTTP transport. Paste a personal token from /account/mcp:

claude mcp add sonic \
  --transport http \
  --url https://mcp.usesonicai.com/api/mcp \
  --header "Authorization: Bearer $SONIC_MCP_TOKEN"

Install: Claude Desktop (OAuth)

One-click install via OAuth 2.1 + PKCE — no copy-pasting tokens.

{
  "mcpServers": {
    "sonic": {
      "type": "streamable-http",
      "url": "https://mcp.usesonicai.com/api/mcp",
      "oauth": {
        "authorization_endpoint": "https://usesonicai.com/api/mcp/oauth/authorize",
        "token_endpoint": "https://usesonicai.com/api/mcp/oauth/token",
        "registration_endpoint": "https://usesonicai.com/api/mcp/oauth/register"
      }
    }
  }
}

Example prompts

/sonic-brief <topic> — grounded research brief
/sonic-morning — your personalized morning briefing
/sonic-expert <name> — dossier for a speaker
/sonic-diff <topic> — how expert views differ on a topic
/sonic-steelman <thesis> — devils-advocate analysis
/sonic-since <entity> <period> — stance evolution over time
/sonic-deck <topic> — slide-by-slide outline

Tool catalog

25 tools registered.

Tool	Description	Bucket
`search_claims`	Semantic search across Sonic's 11k+ podcast claims. Returns ranked claims with speaker, domain, and evidence strength. Prefer this over ask_sonic for snippet-level lookups.	`retrieval`
`get_claim`	Fetch a single claim with source, episode context, resolved entities, and speaker attribution. Use this after search_claims to drill into a specific finding.	`retrieval`
`get_expert`	Dossier for a person entity: bio, total claim count across the dual-path (entity mentions + speaker path), recent claims, domain breakdown. Use after find_experts.	`retrieval`
`list_episodes`	List episodes in the corpus with sort + domain filter. Cursor-paginated. Use to browse recent content or find episodes on a topic.	`retrieval`
`search_quotes`	Keyword search over quote text (transcript segments pulled from episodes). Optionally filter by speaker. Use when you want exact wording, not paraphrased claims.	`retrieval`
`find_experts`	Find person entities by name fragment or topic. Ranked by dual-path claim count (entity_mentions ∪ source_speakers) so speaker-only entities surface correctly.	`retrieval`
`find_companies`	Find company/organization entities by name fragment or topic. Ranked by dual-path claim count (entity_mentions ∪ source_speakers).	`retrieval`
`list_trending`	Trending subdomains — topics with elevated claim volume in a recent window vs. a 30-day baseline. Useful for seeing what's heating up in the corpus.	`retrieval`
`list_predictions`	List prediction-style claims from the corpus. Filter by speaker, resolution outcome (unresolved/confirmed/busted/evolved), or domain.	`retrieval`
`get_related_claims`	Related claims for a given claim. Uses dual-path (entity_mentions ∪ source_speakers) so co-spoken-by claims surface even when the speaker isn't named in text.	`retrieval`
`get_episode`	Episode dossier: metadata, guest/host, top claims, top quotes, and speaker roster. Use when Claude wants full episode context.	`retrieval`
`get_similar_episodes`	Episodes similar to a given episode (via embedded-chunk cosine similarity, grouped per episode). Excludes self.	`retrieval`
`get_earnings_for_company`	Earnings-call claims for a company entity. Filters to source_type='earnings_call' and intersects with claims mentioning or spoken by the entity.	`retrieval`
`get_evidence_for_thesis`	All pinned evidence for a user's thesis: claims, quotes, entities, notes, saved Ask Sonic syntheses. User-scoped — only returns data the authenticated user owns.	`retrieval`
`ask_sonic`	Ask a research question against Sonic's podcast corpus. Returns a grounded analytical brief with inline [sonic:<id>] citations. Use for questions that warrant synthesis; prefer search_claims for snippet-level lookups.	`synthesis`
`trace_consensus`	Trace consensus on a topic. Buckets retrieved claims into supports / contradicts / neutral and narrates the consensus shape with citations.	`synthesis`
`compare_views`	Compare how 2-5 entities (people or companies) view a topic. Pulls each entity's claims dual-path, ranks by topic relevance, and returns per-entity stances plus tensions and a narrative with inline [sonic:<id>] citations.	`synthesis`
`research_question`	Deep-research a question against Sonic's corpus. Decomposes into sub-questions (when sampling is available), retrieves per sub-q, and synthesizes a grounded brief with [sonic:<id>] citations. Use for analyst-grade briefs; prefer ask_sonic for single-shot synthesis.	`research`
`morning_brief`	Generate a 5-bullet morning briefing aggregating: today's general digest, project digests for active theses, watchlist updates, and predictions coming due. Returns grounded prose with [sonic:<id>] citations.	`research`
`stance_check`	Stress-test a position against Sonic's corpus. Returns corroborating evidence, contradicting evidence, open questions, and a calibrated summary. Use to check whether a hypothesis is supported before pinning it.	`research`
`build_thesis`	Create a new research thesis. Walks the user through a shape form (title, description, horizon, domains) via elicitation. Falls back to direct input when elicitation is unavailable — in that case, the caller MUST pass `title` (and optionally the other fields).	`write`
`devils_advocate`	Steelman the OPPOSITE of your thesis and pull corpus evidence supporting it. Surfaces counter-arguments and blindspots. Use before committing capital or publishing a view.	`research`
`trace_evolution`	Trace how claims about an entity or topic evolved over time. Groups corpus claims by month and narrates inflection points. Use to understand a thesis's maturity or a speaker's changing stance.	`research`
`pin_to_thesis`	Pin a claim, quote, or entity to a thesis as evidence. User-scoped — only pins to theses the caller owns. Will elicit an optional note when one isn't provided.	`write`
`save_note`	Save a freeform note to a thesis. The note text IS the content (no AI-generated commentary appended).	`write`

Troubleshooting

401 Unauthorized — check your token at /account/mcp, it may have been revoked.
Streaming hangs — your proxy may be buffering. The server sends SSE; ensure proxy_buffering off.
Sampling unavailable — some clients don't support server-side sampling. Sonic falls back to Gemini automatically.
Rate limited — retrieval 60/min, synthesis 10/min, research 5/min, writes 20/min per token.