Developer Platform

Build with the AI Briefing API

A full REST API, an MCP server for AI agents, real-time webhooks, and typed SDKs for TypeScript and Python โ€” everything you need to embed AI-generated audio briefings into your app, workflow, or agent.

Everything you need to build

๐Ÿ”Œ

REST API

20 endpoints for profiles, sources, briefings, schedules, and webhooks. Full OpenAPI 3.1 spec.

View API reference โ†’
๐Ÿค–

MCP Server

10 tools for AI agents over JSON-RPC 2.0. Drop into Claude Desktop, Continue, or any MCP client.

MCP quickstart โ†’
๐Ÿ”’

Auth & Security

Bearer API keys with fine-grained scopes. HMAC-signed webhooks. Full audit log.

Auth guide โ†’
โšก

TypeScript SDK

Typed client for Node.js and Cloudflare Workers. Covers all 20 endpoints.

TypeScript SDK โ†’
๐Ÿ

Python SDK

Sync + async client with Pydantic models. Works with FastAPI, Django, scripts.

Python SDK โ†’
๐Ÿ“–

Example Projects

4 ready-to-run projects: personal assistant, business agent, website embed, Discord bot.

See use cases โ†’

Start in 5 minutes

1

Create an API key

Sign in at listenbrief.com, then go to Settings โ†’ API Keys to generate your first key.

POST https://listenbrief.com/api/v1/me/keys
Authorization: Bearer <session_token>

{"name":"My App","scopes":["read","write"]}
2

Add a source

Register an RSS feed or website to pull content from.

curl -X POST https://listenbrief.com/api/v1/sources \
  -H "Authorization: Bearer lb_api_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"rss","url":"https://techcrunch.com/feed/","name":"TechCrunch","profile_id":"prof_..."}'
3

Generate a briefing

Trigger an on-demand AI briefing and poll for the audio URL.

curl -X POST https://listenbrief.com/api/v1/briefings \
  -H "Authorization: Bearer lb_api_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"profile_id":"prof_..."}'

Ready to build?

Follow the full quickstart to go from zero to a generated AI audio briefing in under five minutes.

Get started โ†’