# Crossfeed

> Crossfeed ranks a podcast network's own shows by how much their listeners overlap a launch's, in Qloo, and drafts the promo plan as an insertion order that a member of the network approves. Programs and assistants drive it for one network through a REST API, a TypeScript SDK, and an MCP server, each reached with one of the network's API keys. None of them can approve.

- Authenticate with `Authorization: Bearer cf_live_…`, a key an owner makes in the network's settings. A key reaches its own network alone.
- No route or tool approves an insertion order or a reply: a member does, in the app. When a run waits on a question, put it to the person as it is and answer with their words.
- Long work answers 202; read the resource until it settles. A refusal is `{ "error": { "code", "message" } }` with a stable code.
- Examples in these docs use made-up shows and IDs.

## Docs

- [Overview](https://crossfeed.m1kuorg.workers.dev/docs): How programs and assistants drive a Crossfeed network: what they can and can’t do, API keys, limits, and errors.
- [REST API](https://crossfeed.m1kuorg.workers.dev/docs/api): Every route of Crossfeed’s REST API under /api/v1, generated from its OpenAPI document.
- [TypeScript SDK](https://crossfeed.m1kuorg.workers.dev/docs/sdk): How to install Crossfeed’s TypeScript SDK from the repo, make a client, wait for long work, and handle errors.
- [MCP server](https://crossfeed.m1kuorg.workers.dev/docs/mcp): The tools Crossfeed’s MCP server offers at /mcp, and how to connect Claude Code, Claude, Cursor, VS Code, Codex or another MCP client to it.
- [Skills and plugin](https://crossfeed.m1kuorg.workers.dev/docs/agents): Two Agent Skills, for planning launch promos and triaging guest pitches, and the Claude Code plugin that installs them with Crossfeed’s MCP server.

## Reference

- [OpenAPI document](https://crossfeed.m1kuorg.workers.dev/api/v1/openapi.json): the API's OpenAPI 3.1 contract
- [The plan-launch-promos skill](https://crossfeed.m1kuorg.workers.dev/docs/agents/plan-launch-promos/SKILL.md): Plan a podcast launch's promos across a network's own shows with Crossfeed's MCP tools, which rank the roster by listener overlap in Qloo and draft an insertion order that a member approves in the app. Use when the user wants to plan, run, or rerun a Crossfeed launch, pick which roster shows promote a new show and how many slots each gets, settle the roster for a launch, change a draft insertion order, understand why a show ranks where it does on a launch's chart, see which of the network's own shows share listeners with each other, or who the network's shows reach by age and gender.
- [The triage-guest-pitches skill](https://crossfeed.m1kuorg.workers.dev/docs/agents/triage-guest-pitches/SKILL.md): Triage a podcast's guest pitches with Crossfeed's MCP tools, which read each pitch for the public work it promotes, rank those works against one of the network's shows by listener overlap in Qloo, and draft Book, Later, or Decline replies that a member approves in the app. Use when the user wants to sort, rank, or answer guest or booking pitches, load a day's pitches or an inbox export into Crossfeed, or decide which pitched guests a show should book.

## Optional

- [Privacy](https://crossfeed.m1kuorg.workers.dev/privacy): What the Crossfeed beta sends to Qloo and to Anthropic, what it keeps, and how it’s deleted.
- [Beta terms](https://crossfeed.m1kuorg.workers.dev/terms): The terms of the free Crossfeed beta: no warranty, the daily limits that keep it running, and acceptable use.