---
title: "API and MCP — OncoEverything™"
url: "/developers"
canonical_url: "https://www.oncoeverything.com/developers"
summary: "A read-only REST API and an MCP server for the OncoMarket™ report catalog. No key needed."
---

1. [Home](https://www.oncoeverything.com/)
2. API and MCP

# API and MCP

Read the OncoMarket™ report catalog from your own code or an AI agent. Search reports, read one, get its free sample, and browse by disease state. No key is needed.

## REST API

Every endpoint answers JSON under `https://www.oncoeverything.com/api/v1`. The full description is at [/openapi.json](https://www.oncoeverything.com/openapi.json) .

| Endpoint                   | Returns                                                                                  |
| -------------------------- | ---------------------------------------------------------------------------------------- |
| GET /reports               | Search published reports. Filters: q, disease, type, publisher, year, price, sort, page. |
| GET /reports/{slug}        | One report: abstract, description, price, topics, related reports.                       |
| GET /reports/{slug}/sample | A download link for the free sample. It works for ten minutes.                           |
| GET /topics                | Disease states with published reports.                                                   |
| GET /topics/{slug}         | One disease state and its reports.                                                       |

### Search for CAR-T reports

```
curl "https://www.oncoeverything.com/api/v1/reports?q=CAR-T&sort=newest"
```

### Filter by disease state

Filters take slugs from the facets in a search response. Give several as a comma-separated list.

```
curl "https://www.oncoeverything.com/api/v1/reports?disease=lymphoma,multiple-myeloma"
```

Errors answer JSON with a code, such as `NOT_FOUND` with status 404\. Requests are rate limited. Too many answers 429; wait and try again.

## MCP server

The same catalog as tools for an AI agent, over Streamable HTTP at `https://www.oncoeverything.com/mcp`. Add it to a client that reads an `mcpServers` file:

```
{
  "mcpServers": {
    "oncoeverything": {
      "url": "https://www.oncoeverything.com/mcp"
    }
  }
}
```

In Claude Code:

```
claude mcp add --transport http oncoeverything https://www.oncoeverything.com/mcp
```

- `search_reports`: Search the catalog.
- `get_report`: Read one report.
- `get_report_sample`: Get the free sample link.
- `list_topics`: List disease states.
- `get_topic`: Read one disease state and its reports.

## What stays on the site

The API reads. Buying a report and sending a request happen on the site, by a person. Every page on the site is also available as Markdown, and [/llms.txt](https://www.oncoeverything.com/llms.txt) lists them. Questions go to [contact](https://www.oncoeverything.com/contact) .