planned, phase 3

Social listening MCP server

discatch ships a remote MCP server so an agent can search, quote, and manage catches from inside its own client. The same server handles social listening queries and brand monitoring queries; one URL, one OAuth flow. MCP is pull-only by design: the agent asks, the server answers. For the other direction, discatch ships push separately. A catch has a destination, and when it fires the destination wakes the agent. MCP pulls, catches push.

20 tools, the full surface

ToolWhat it does
quotePrice a search or catch before running it
searchOne-off search across the sources you name
captureFetch one post or page with thread context
classifyClassify results against caller-defined criteria
create_catchRegister a standing query with a destination
list_catchesList catches with their status
get_catchRead one catch, including its last run
update_catchChange query, sources, interval, or destination
pause_catchPause a running catch
resume_catchResume a paused catch
delete_catchRemove a catch and stop its firings
test_catchFire the destination with a sample payload
get_resultsRead results delivered by a catch so far
get_eventsRead the account event log from a cursor
create_subscriptionRoute filtered events to a target
list_subscriptionsList subscriptions with delivery health
delete_subscriptionRemove a subscription
doctorThe orientation manifest: where to start, prices, sources
list_sourcesSources live now and whether deep coverage is possible
get_usageUnits consumed this period, by kind, with spend
From docs/api.md. The MCP server is planned for phase 3; REST equivalents land in earlier phases.

Connect from any MCP client

The server URL is the same for every client. Add it, approve the OAuth prompt, and the tools appear. Auth discovery is at mcp.discatch.com/.well-known/oauth-protected-resource.

Claude Code (.claude/mcp.json)

{
  "mcpServers": {
    "discatch": { "url": "https://mcp.discatch.com" }
  }
}

Codex

{
  "mcpServers": {
    "discatch": { "url": "https://mcp.discatch.com" }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "discatch": { "url": "https://mcp.discatch.com" }
  }
}

VS Code (.vscode/settings.json)

{
  "mcp": {
    "servers": {
      "discatch": { "url": "https://mcp.discatch.com" }
    }
  }
}

MCP pulls, catches push

MCP is a request and a response. A server cannot start a conversation. Products in this category that ship only MCP leave the agent polling; some say so in their own docs. discatch treats the MCP server as the read and control surface. Delivery is a separate feature: a catch has a destination, and the destination wakes the agent when the catch fires.

An agent that registers a catch from MCP and gives it a webhook destination gets both: control through the session, delivery through the push. The MCP tools let you create the catch, set the query, pick the sources, choose the interval, and point it at a destination. The destination does the waking.

Scoped keys

Keys are scoped: read, search, catches:write, billing:read. The OAuth flow asks for the scopes it needs and nothing else. An agent that only searches never gets catches:write. An agent that manages billing never gets search.

Resources and prompts

  • Resource: discatch://catches/{id}/results for streaming reads where the client supports it.
  • Prompt: write-reply drafts a reply that matches how the user writes, for the user to post. discatch never posts.
  • Prompt: daily-digest summarizes what a catch found in the last 24 hours.

Questions

Is the discatch MCP server live?

Not yet. It is roadmap phase 3, after search and catches. The doctor manifest reports its status. The REST API with a trial key works today.

Does the MCP server push new mentions to my agent?

No. MCP is pull-only by protocol; no MCP server can push. discatch pushes through catch destinations: a signed webhook, a Claude Code or Codex command, a Doozy todo. Register the catch from MCP and get woken by the destination.

Is MCP on the free tier?

Yes. The MCP server is not tier-gated. A trial key with no email and no card can connect and use the free-source allowance.

Which clients work?

Any MCP client that supports remote servers with OAuth: Claude Code, Claude Desktop, Codex, Cursor, VS Code, Windsurf, and others. The config is the same URL everywhere.

How many tools does the server have?

Twenty. The full list is on this page: search, quote, capture, classify, the catch lifecycle, event log, subscriptions, doctor, sources, and usage. Two resources and two prompts round out the surface. It matches the REST API one to one.

Is this also a brand monitoring MCP server?

Yes. Social listening and brand monitoring are the same operations at the API level: a query, sources, and results. The MCP server handles both.

What is the difference between MCP and the REST API?

The same calls, different transports. MCP uses OAuth and runs inside the agent’s client session. REST uses a bearer key and runs from any HTTP client. Both reach the same account and the same data.

Can my agent sign up through MCP?

The OAuth flow creates the account. For a trial key without OAuth, POST /v1/keys/trial on the REST surface, then connect MCP with the claimed account. The doctor manifest explains both paths.

What happens if a source is planned and I request it?

The call fails with source_unavailable and a next_action naming the sources that are live. The list_sources tool reports availability before you search.

Does discatch ever post on my behalf?

No. The write-reply prompt drafts a reply in the voice of the user, for the user to post. discatch catches and delivers. It never publishes anything on any platform.

Last reviewed by , founder, dcouple. Copy from docs/api.md, docs/events.md, docs/vision.md.