Authoritative FDA drug label (Structured Product Labeling). Give a drug name (brand, generic, or substance), or an exact NDC, RxCUI, or SPL set_id, and get back the FDA-approved label split into the sections agents need: boxed warning, indications and usage, dosage and administration, contraindications, warnings, adverse reactions, drug interactions, use in specific populations, pregnancy, mechanism of action, and active/inactive ingredients. Each record also carries identity metadata (brand/generic names, manufacturer, NDCs, RxCUIs, route, DEA schedule, OTC vs prescription) plus a hasBoxedWarning flag. Free, public-domain US government data. Point-in-time public records, not medical advice. Use for prescribing-support, pharmacy, and clinical agents that must read the real label rather than guess it.
/api/medical/drug-labelPAYMENT-SIGNATURE.The drug label API is a pay-per-call medical endpoint built for AI agents and autonomous software. Authoritative FDA drug label (Structured Product Labeling).
There is no signup and no API key. An agent (or any HTTP client) hits the endpoint, receives an x402 "402 Payment Required" challenge, signs a sub-cent USDC payment on Base or Solana, and retries — the data comes back on the paid request. That makes it a drop-in drug label data source for an agent tool-use loop, an MCP host, or a backend that needs medical data on demand without onboarding to yet another vendor portal.
| Name | Type | Description |
|---|---|---|
drug | string | Drug name — brand, generic, or substance. min 2 chars · max 120 chars |
ndc | string | Exact product NDC. min 3 chars · max 20 chars |
rxcui | string | Exact RxNorm RxCUI. match ^\d{1,9}$ |
setId | string | Exact SPL set_id. min 8 chars · max 80 chars |
limit | integer | Max labels returned. min 1 · max 25 |
# 1. Probe with no auth → 402 envelope with PaymentRequirements curl -sS 'https://2s.io/api/medical/drug-label?drug=xx&ndc=xxx&rxcui=12345&setId=xxxxxxxx&limit=1' # 2. Sign + retry with PAYMENT-SIGNATURE: curl -sS 'https://2s.io/api/medical/drug-label?drug=xx&ndc=xxx&rxcui=12345&setId=xxxxxxxx&limit=1' \ -H 'PAYMENT-SIGNATURE: <base64-json-payload>' # Or use the canonical runner (handles probe → sign → retry): # EVM_PRIVATE_KEY=0x... node --env-file=.env.local \ # --experimental-strip-types scripts/x402-pay.ts \ # 'https://2s.io/api/medical/drug-label?drug=xx&ndc=xxx&rxcui=12345&setId=xxxxxxxx&limit=1'
import { TwoS } from '@2sio/sdk'
const client = new TwoS({
privateKey: process.env.EVM_PRIVATE_KEY as `0x${string}`,
})
const result = await client.medical.drugLabel({
"drug": "xx",
"ndc": "xxx",
"rxcui": "12345",
"setId": "xxxxxxxx",
"limit": 1
})
console.log('endpoint:', result.endpoint)
console.log('cost:', result.costUsd, 'USDC')
console.log('tx:', result.settlement?.txHash)
console.log('data:', result.data)import os
from twosio import TwoS
client = TwoS(private_key=os.environ["EVM_PRIVATE_KEY"])
result = client.medical.drug_label(drug="xx", ndc="xxx", rxcui="12345", setId="xxxxxxxx", limit=1)
print("endpoint:", result.endpoint)
print("cost:", result.cost_usd, "USDC")
print("tx:", (result.settlement or {}).get("tx_hash"))
print("data:", result.data)// 1. Add @2sio/mcp to your MCP host config (Claude Desktop example below).
// EVM_PRIVATE_KEY funds x402 payments per call.
// claude_desktop_config.json
{
"mcpServers": {
"2sio": {
"command": "npx",
"args": ["-y", "@2sio/mcp"],
"env": { "EVM_PRIVATE_KEY": "0x..." }
}
}
}
// 2. Once the server is running, agents call this tool via standard MCP:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "medical.drug-label",
"arguments": {
"drug": "xx",
"ndc": "xxx",
"rxcui": "12345",
"setId": "xxxxxxxx",
"limit": 1
}
}
}| Field | Type | Description |
|---|---|---|
query | object | |
totalCount | number | |
returned | number | |
hasBoxedWarning | boolean | |
labels | array | |
source | object |
{
"query": {
"drug": "example",
"ndc": "example",
"rxcui": "example",
"setId": "example",
"limit": 1
},
"totalCount": 1,
"returned": 1,
"hasBoxedWarning": false,
"labels": [
{
"setId": "example",
"splId": "example",
"effectiveTime": "example",
"brandNames": [
"example"
],
"genericNames": [
"example"
],
"substanceNames": [
"example"
],
"manufacturerNames": [
"example"
],
"productNdc": [
"example"
],
"routes": [
"example"
],
"productType": "example",
"rxcui": [
"example"
],
"deaSchedule": "example",
"isOtc": false,
"boxedWarning": "example",
"indicationsAndUsage": "example",
"dosageAndAdministration": "example",
"contraindications": "example",
"warnings": "example",
"adverseReactions": "example",
"drugInteractions": "example",
"useInSpecificPopulations": "example",
"pregnancy": "example",
"mechanismOfAction": "example",
"activeIngredient": "example",
"inactiveIngredient": "example",
"purpose": "example",
"doNotUse": "example",
"whenUsing": "example",
"stopUse": "example",
"description": "example"
}
],
"source": {
"provider": "example",
"url": "example",
"license": "example"
}
}