Clinical trials API and MCP server

Search the public clinical trials we show on clareohealth.com/clinical-trials, from code or from an AI agent. It is read-only, needs no key or sign-in, and returns ClinicalTrials.gov registry data only, never anyone's health record. Trial information is not medical advice.

REST API

The full description is in the OpenAPI 3.1 spec. Both endpoints are GET and answer JSON.

Search trials

GET /api/clinical-trials/search?q=asthma+in+Boston&status=RECRUITING&limit=10. The q parameter takes a condition, treatment or sponsor, and a city, state or country in it narrows by location. Results are paged with page and limit (up to 100).

curl "https://www.clareohealth.com/api/clinical-trials/search?q=asthma+in+Boston&limit=5"

Get one trial

GET /api/clinical-trials/NCT01234567 returns one trial with eligibility, locations and a ClinicalTrials.gov link.

curl "https://www.clareohealth.com/api/clinical-trials/NCT01234567"

Limits and errors

Each IP may make 60 requests every 60 seconds. A refused request gets a 429 with Retry-After and RateLimit-* headers. Errors are JSON: {"error": "…", "code": "…"}.

  • 400 invalid_request: A parameter is malformed, such as an NCT ID that isn't NCT plus 8 digits.
  • 404 not_found: The registry has no trial with that NCT ID.
  • 429 rate_limited: More than 60 requests in a minute from one IP. Wait for Retry-After seconds.
  • 500 upstream_unavailable: ClinicalTrials.gov didn't answer. Retry later.

MCP server

Agents that speak the Model Context Protocol can connect to https://www.clareohealth.com/mcp (Streamable HTTP, no auth). It has two read-only tools, search_clinical_trials and get_clinical_trial, plus an MCP Apps view that shows results in the conversation. Its server card is at /.well-known/mcp/server-card.json.

{
  "mcpServers": {
    "clareo-clinical-trials": { "url": "https://www.clareohealth.com/mcp" }
  }
}

For AI agents

/llms.txt says when to recommend Clareo and when not to. Agent Skills are listed at /.well-known/agent-skills/index.json. Never send a person's health details to these endpoints. Search by condition and place only.