# get-top-drugs

`station__api-fda-gov__get-top-drugs` · external (needs EXECUTION_BACKEND_URL configured) · domain `api-fda-gov` · pv-relevance `pv-core`

Get top N drugs by FAERS adverse event report count in a date range. Answers 'which drugs had the most reports last quarter?' without requiring a specific drug name. Date format: YYYYMMDD.

> **Note:** This tool routes through an external execution backend. If `EXECUTION_BACKEND_URL` is unset on the server, calls return JSON-RPC error `-32603 "Tool execution backend not configured"`. Tools with `backend: native` execute in-process and are always callable.

## Agent metadata

- `idempotent`: unknown
- `read_only`: unknown
- `expected_latency_ms`: unknown (not yet contract-tested)
- `cost_tokens_estimate`: unknown

## Input schema

- `date_start` *string* — Start date (YYYYMMDD, e.g. 20240101)
- `date_end` *string* — End date (YYYYMMDD, e.g. 20240331)
- `limit` *integer* — Number of drugs to return (default 10, max 100)

## Example call

```json
POST /api/mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "station__api-fda-gov__get-top-drugs",
    "arguments": {}
  }
}
```

## Related

- [/tools](/tools) — all 3062 tools
- [/tools/api-fda-gov__get-top-drugs](/tools/api-fda-gov__get-top-drugs) — HTML page
- [/tools/api-fda-gov__get-top-drugs/json](/tools/api-fda-gov__get-top-drugs/json) — JSON form (agent-friendly)
- [/api/mcp](/api/mcp) — endpoint
- [/AGENTS.md](/AGENTS.md) — agent guide