Cure Cancer With AI
Free oncology data (research, trials, FDA approvals, news) plus IBM MAMMAL biomedical predictions.
Open source Repository Open in the app JSON README (API)
About
Free oncology data (research, trials, FDA approvals, news) plus IBM MAMMAL biomedical predictions.
Details
- Kind
- MCP servers
- Topic
- Social & content
- Publisher
- hifarrer
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-06-12T20:44:02Z
- Repository state
- ativo
- License
- NOASSERTION
- Added
- 2026-08-29 04:00:07
- Updated
- 2026-08-29 04:00:07
- Origin id
io.github.hifarrer/cure-cancer-with-ai
README
# 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.json)
[](#mcp-server-for-ai-agents)
[](./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