ccwai-api

# Cure Cancer With AI — Public API

> A **free** public REST API and **MCP server** for oncology data: peer-reviewed research papers (PubMed), curated cancer news, FDA-approved oncology drugs, clinical trials, and a cross-dataset keyword search — plus **IBM MAMMAL** biomedical foundation-model predictions (protein–protein interaction, drug–target affinity, and ClinTox clinical-trial toxicity).

Base URL: **`https://www.curecancerwithai.com`** · Docs: **https://www.curecancerwithai.com/developers** · [OpenAPI 3.1 spec](./openapi.json) · [Agent instructions](./AGENTS.md)

[![OpenAPI](https://img.shields.io/badge/OpenAPI-3.1-6BA539?logo=openapiinitiative&logoColor=white)](./openapi.json)
[![MCP](https://img.shields.io/badge/MCP-server-000000)](#mcp-server-for-ai-agents)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)

---

## What it's for

If you need to programmatically access **oncology research, clinical trials, FDA approvals, or cancer news**, or to run **biomedical model predictions** (protein–protein interaction, drug–target binding affinity, drug toxicity), this API gives you clean JSON with a free API key. It's a good fit for research tools, dashboards, chatbots, and AI agents.

## Quickstart

1. Get a free API key — sign in at **https://www.curecancerwithai.com/api-keys** and click *Create key* (format `ccw_live_...`, shown once).
2. Send it on every request as a Bearer token:

```bash
curl "https://www.curecancerwithai.com/api/v1/search?q=osimertinib&types=research,fdaApprovals" \
  -H "Authorization: Bearer ccw_live_YOUR_KEY"
```

- Auth: `Authorization: Bearer ccw_live_...` (or `x-api-key: ccw_live_...`)
- Free tier: **100 requests/hour** per key (rolling window). Watch `X-RateLimit-Remaining`; on HTTP 429 wait for `Retry-After`.
- List endpoints return `{ data: [...], pagination: {...} }`; single-record endpoints return `{ data: {...} }`; errors return `{ error: "..." }`.

## Endpoints

| Method | Path | Description |
|---|---|---|
| GET | `/api/v1/research` | Peer-reviewed oncology research papers (PubMed) |
| GET | `/api/v1/research/{idOrPubmedId}` | A single research paper |
| GET | `/api/v1/news` | Curated cancer news |
| GET | `/api/v1/blog` | Editorial blog posts (excerpts) |
| GET | `/api/v1/blog/{slug}` | A single blog post (full content) |
| GET | `/api/v1/fda-approvals` | FDA-approved oncology drugs |
| GET | `/api/v1/clinical-trials` | Clinical trials from public registries |
| GET | `/api/v1/clinical-trials/{nctId}` | A single trial (eligibility + locations) |
| GET | `/api/v1/search` | Cross-dataset keyword search (all datasets at once) |
| POST | `/api/v1/mammal/ppi` | MAMMAL: protein–protein interaction |
| POST | `/api/v1/mammal/dti` | MAMMAL: drug–target interaction (pKd) |
| POST | `/api/v1/mammal/clintox` | MAMMAL: ClinTox clinical-trial toxicity |

Common query params on list endpoints: `limit` (1–100, default 20), `offset`, and usually `cancerType`, `search`, `from`/`to`. Full details and field lists are in the [OpenAPI spec](./openapi.json) and [AGENTS.md](./AGENTS.md).

## MCP server (for AI agents)

There's a remote **Model Context Protocol** server over Streamable HTTP that exposes every endpoint above as a tool, so Claude, ChatGPT, and other MCP clients can call the API directly.

- Endpoint: `https://www.curecancerwithai.com/api/mcp`
- Auth: send `Authorization: Bearer ccw_live_YOUR_KEY` as a header.

```json
{
  "mcpServers": {
    "cure-cancer-with-ai": {
      "url": "https://www.curecancerwithai.com/api/mcp",
      "headers": { "Authorization": "Bearer ccw_live_YOUR_KEY" }
    }
  }
}
```

Tools: `search_oncology`, `list_research`, `get_research_paper`, `list_news`, `list_blog_posts`, `get_blog_post`, `list_fda_approvals`, `list_clinical_trials`, `get_clinical_trial`, `predict_ppi`, `predict_dti`, `predict_clintox`, `mammal_health`. See [`mcp/`](./mcp/).

## Examples

Runnable samples in [`examples/`](./examples/): [`curl.sh`](./examples/curl.sh), [`javascript.mjs`](./examples/javascript.mjs), [`python.py`](./examples/python.py). Import [`openapi.json`](./openapi.json) into Postman or any OpenAPI tool, or use the [Postman collection](./postman_collection.json).

## Disclaimer

All data is for informational purposes only and is **not medical advice**. Cite source URLs (`url`, `fullTextUrl`, `labelPdfUrl`) when presenting results to users.

## Links

- Developer docs: https://www.curecancerwithai.com/developers
- OpenAPI 3.1: https://www.curecancerwithai.com/openapi.json
- Agent instructions: https://www.curecancerwithai.com/ai-api-instructions.md
- llms.txt: https://www.curecancerwithai.com/llms.txt
- Get a free API key: https://www.curecancerwithai.com/api-keys