Cure Cancer With AI README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Cure Cancer With AI listing page.
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 · Agent instructions
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
- Get a free API key — sign in at https://www.curecancerwithai.com/api-keys and click Create key (format
ccw_live_..., shown once). - Send it on every request as a Bearer token:
- Auth:
Authorization: Bearer ccw_live_...(orx-api-key: ccw_live_...) - Free tier: 100 requests/hour per key (rolling window). Watch
X-RateLimit-Remaining; on HTTP 429 wait forRetry-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 and 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_KEYas a header.
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/.
Examples
Runnable samples in examples/: curl.sh, javascript.mjs, python.py. Import openapi.json into Postman or any OpenAPI tool, or use the Postman collection.
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