Drugs

biologyAvailable on FreeNo success wrapper

Returns a paginated list of drugs with metadata (page, limit, totalItems, totalPages). Call it to browse or filter drugs by approval status, development phase, drug type, disease, or target, and to search by name. Invalid query parameters return HTTP 400; an upstream lookup failure returns HTTP 400 with an error message; unexpected failures return HTTP 500.

When to use it

Search drugs by name
List approved drugs for a disease
Find drugs targeting a specific gene or protein

Getting started

Base URL

https://app.caelrith.com/api/v1/tools

Authentication

Include your API key in the x-api-key header.

Rate limit

Every call counts against your workspace’s daily quota for biology-associations. Exceeding it returns HTTP 429.

Plans and daily limits

Plan	Available	Calls / day
free	yes	10
pro	yes	200
custom (default)	yes	10,000

Plan defaults. A custom workspace may carry per-tenant overrides.

Parameters

Query parameters

Parameter	Type	Required	Description
search	string	No	minimum length 1; maximum length 500
is_approved	boolean	No	booleans arrive as strings - send 'true' or 'false'; value is parsed from the raw query string and coerced server-side
has_black_box	boolean	No	booleans arrive as strings - send 'true' or 'false'; value is parsed from the raw query string and coerced server-side
min_phase	integer	No	Range 0-4 (range 0-4) Range: 0 to 4
max_phase	integer	No	Range 0-4 (range 0-4) Range: 0 to 4
drug_type	string	No	minimum length 1
disease	string	No	minimum length 1
disease_id	string	No	minimum length 1
target	string	No	minimum length 1
target_id	string	No	minimum length 1
sort	string	No	Default max_phase (default max_phase) Allowed values: max_phase, key
order	string	No	Default desc (default desc) Allowed values: asc, desc
page	integer	No	Min 1; default 1 (min 1; default 1) Range: 1 to ∞
limit	integer	No	Range 1-100; default 20 (range 1-100; default 20) Range: 1 to 100

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/tools/biology/drugs"

Response envelope

This endpoint returns an implicit 2xx response - there is no success flag in the body.

{
  "data": { /* payload */ },
  "meta": { /* pagination, totals */ }
}

// No "success" flag on this endpoint - any 2xx JSON is a success.

Catalog version mcp-2026-10-28 · generated from the live MCP catalog