Developers

Build on the research database

The API and the MCP server are two faces of the same data and the same permissions. An API/MCP or Enterprise plan gives you both.

MCP server

Point any MCP client at the endpoint below and sign in. Your assistant receives exactly the tools your plan allows, and every answer comes back with citations.

https://oppodb.online/mcp

Claude Desktop / Cursor config

{
  "mcpServers": {
    "oppodb": {
      "url": "https://oppodb.online/mcp"
    }
  }
}

Available tools

Tool	Description
search_all	Search every subscribed corpus at once.
get_rb_candidate	Fetch a candidate research book and its issue pages.
get_maga_file	Fetch an executive-branch appointee vetting report.
get_local_impact	Fetch a state impact report by state name or code.
get_narrative_report	Fetch an issue-based narrative policy report.
wiki_search	Search the research wiki and return page paths.

REST API

Issue a token from your account, then call the public API with it. Responses are JSON and include source citations.

curl -H "Authorization: Bearer $OPPODB_TOKEN" \
  "https://oppodb.online/api/search?q=housing+affordability&limit=10"

GET /search

Full-text search across subscribed corpora.

GET /candidates/:id

A candidate research book with sub-pages.

GET /impacts/:state

State impact report by name or code.

Tokens, limits and support

Tokens are issued and revoked from your OppoDB account.
Rate limits are per plan; API/MCP and Enterprise get the higher tier.
Webhooks notify you when subscribed content is revised.
Breaking API changes ship behind a version and are announced in News.

API plan pricing Talk to an engineer