{
  "markdown": "# Cure Cancer With AI — Public API\n\n> 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).\n\nBase URL: **`https://www.curecancerwithai.com`** · Docs: **https://www.curecancerwithai.com/developers** · [OpenAPI 3.1 spec](./openapi.json) · [Agent instructions](./AGENTS.md)\n\n[![OpenAPI](https://img.shields.io/badge/OpenAPI-3.1-6BA539?logo=openapiinitiative&logoColor=white)](./openapi.json)\n[![MCP](https://img.shields.io/badge/MCP-server-000000)](#mcp-server-for-ai-agents)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)\n\n---\n\n## What it's for\n\nIf 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.\n\n## Quickstart\n\n1. Get a free API key — sign in at **https://www.curecancerwithai.com/api-keys** and click *Create key* (format `ccw_live_...`, shown once).\n2. Send it on every request as a Bearer token:\n\n```bash\ncurl \"https://www.curecancerwithai.com/api/v1/search?q=osimertinib&types=research,fdaApprovals\" \\\n  -H \"Authorization: Bearer ccw_live_YOUR_KEY\"\n```\n\n- Auth: `Authorization: Bearer ccw_live_...` (or `x-api-key: ccw_live_...`)\n- Free tier: **100 requests/hour** per key (rolling window). Watch `X-RateLimit-Remaining`; on HTTP 429 wait for `Retry-After`.\n- List endpoints return `{ data: [...], pagination: {...} }`; single-record endpoints return `{ data: {...} }`; errors return `{ error: \"...\" }`.\n\n## Endpoints\n\n| Method | Path | Description |\n|---|---|---|\n| GET | `/api/v1/research` | Peer-reviewed oncology research papers (PubMed) |\n| GET | `/api/v1/research/{idOrPubmedId}` | A single research paper |\n| GET | `/api/v1/news` | Curated cancer news |\n| GET | `/api/v1/blog` | Editorial blog posts (excerpts) |\n| GET | `/api/v1/blog/{slug}` | A single blog post (full content) |\n| GET | `/api/v1/fda-approvals` | FDA-approved oncology drugs |\n| GET | `/api/v1/clinical-trials` | Clinical trials from public registries |\n| GET | `/api/v1/clinical-trials/{nctId}` | A single trial (eligibility + locations) |\n| GET | `/api/v1/search` | Cross-dataset keyword search (all datasets at once) |\n| POST | `/api/v1/mammal/ppi` | MAMMAL: protein–protein interaction |\n| POST | `/api/v1/mammal/dti` | MAMMAL: drug–target interaction (pKd) |\n| POST | `/api/v1/mammal/clintox` | MAMMAL: ClinTox clinical-trial toxicity |\n\nCommon 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).\n\n## MCP server (for AI agents)\n\nThere'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.\n\n- Endpoint: `https://www.curecancerwithai.com/api/mcp`\n- Auth: send `Authorization: Bearer ccw_live_YOUR_KEY` as a header.\n\n```json\n{\n  \"mcpServers\": {\n    \"cure-cancer-with-ai\": {\n      \"url\": \"https://www.curecancerwithai.com/api/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer ccw_live_YOUR_KEY\" }\n    }\n  }\n}\n```\n\nTools: `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/).\n\n## Examples\n\nRunnable 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).\n\n## Disclaimer\n\nAll data is for informational purposes only and is **not medical advice**. Cite source URLs (`url`, `fullTextUrl`, `labelPdfUrl`) when presenting results to users.\n\n## Links\n\n- Developer docs: https://www.curecancerwithai.com/developers\n- OpenAPI 3.1: https://www.curecancerwithai.com/openapi.json\n- Agent instructions: https://www.curecancerwithai.com/ai-api-instructions.md\n- llms.txt: https://www.curecancerwithai.com/llms.txt\n- Get a free API key: https://www.curecancerwithai.com/api-keys\n",
  "bytes": 4724,
  "sha": "17eaa1d1bf1e11cab1d627291dc52746b6c7a8c01a9e10e9692dc6b62174f3c5",
  "repo_slug": "hifarrer/ccwai-api",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_hifarrer_cure_cancer_with_ai_07bfcb14/readme"
}