BMJ · Experimental service

Governed access to trusted medical evidence, built for machines.

Content Gateway gives licensed partners and AI agents search, retrieval and grounded answers over BMJ content, with every request tied to a versioned access agreement.

Read the documentation View the OpenAPI spec

# Ranked evidence previews from your licensed scope
curl -X POST 'https://dev.bmj-content-hub.com/v1/search' \
  -H "Authorization: Bearer $BMJ_EVIDENCE_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"query": "treatment adherence", "max_results": 5}'

# → evidence ids you can cite and fetch as chunks
{ "results": [ { "evidence_id": "para_…", "score": 0.81,
    "metadata": { "document_id": "doc_…" } } ] }

01 · LEARN

What the service is

How BMJ content is supplied, governed and licensed to partners, and what this prototype is (and isn’t).

How access works → 02 · BUILD

Public API

Find, search, answers, documents, collections and trust markers, described by one OpenAPI contract.

Developer documentation → 03 · CONNECT

Agents & MCP

Connect Claude or any MCP client to /mcp, or install the downloadable agent skill.

MCP guide →

How access works

Every API key is scoped by a customer agreement, which starts from an access package.

Access packageA reusable starting point: which content, which operations, which connection methods and limits.

Customer agreementThe versioned contract for one customer. Changing access creates a new version.

API keyIssued under an agreement. A key can only narrow that access, never widen it.

Public API at a glance

Customer applications authenticate with an API key issued by BMJ. Full documentation.

POST /v1/findFast literal and phrase lookups across articles
POST /v1/searchKeyword, vector or hybrid evidence search
POST /v1/answersGrounded answers that cite their evidence
GET /v1/chunks/:evidence_idEntitled paragraph-level chunks with citations
GET /v1/collectionsCollections and their documents in your scope
GET /v1/trust/markersPeer-review and governance trust markers

Research prototype. Built by BMJ using content from BMJ’s open corpus. It is not a live BMJ product, and interfaces may change.