# DosePlot Agent API

A pharmacokinetic and reconstitution calculator for agents: published compound
data as free reads, and paid compute endpoints -- three capabilities (a serum
curve, reconstitution math for one vial, ranked reconstitution suggestions)
across five paid paths; /v1/recon/plan and /v1/recon/options are aliases of
the two reconstitution paths.

Disclaimer: Mathematical planning aid. Not medical advice. DosePlot is an informational tool, not a healthcare provider, and using it creates no provider-patient relationship. Do not start, stop, or change any protocol without the approval of a licensed healthcare professional.
Intended use: Outputs are for relay to a human decision-maker; not for autonomous administration.

## Base URL

https://api.doseplot.com

## Free (REST, no key, no payment)

GET /                       index: endpoints, price, configured chain
GET /openapi.json           OpenAPI 3.1 description of this API
GET /terms                  terms of service, plain text
GET /v1/compounds           published compounds, one summary each
GET /v1/compounds/{idOrSlug}  one compound, by id, slug or alias

## Paid (REST)

POST /v1/simulate           serum curve for one compound, dose and cadence
POST /v1/recon/calc         reconstitution math for one vial and target dose
POST /v1/recon/suggest      ranked reconstitution suggestions for one
                            reconstitutable compound
POST /v1/recon/plan         alias of /v1/recon/calc (identical request and
                            answer)
POST /v1/recon/options      alias of /v1/recon/suggest (identical request
                            and answer)

Price: $0.01 USD per call, paid over the x402 rail (HTTP 402
flow, scheme "exact", asset USDC). No accounts and no API keys: an unpaid call
answers 402 with the x402 payment-requirements document in the PAYMENT-REQUIRED
header, and the payment comes back in PAYMENT-SIGNATURE.
Settlement: USDC on Base (eip155:8453).

## MCP

Endpoint: https://api.doseplot.com/mcp (Streamable HTTP, stateless, JSON responses).
Free tools: list_compounds, get_compound
Paid tools: simulate, recon_calc, recon_suggest
Every compute call needs an x402 payment, supplied in the tool call's _meta under the key
"x402/payment"; an unpaid call answers 402. No free compute on REST or MCP. Call
tools/list for the live tool list, schemas and prices.

## Terms you are agreeing to

Every response carries a disclaimer and an intended-use line. Relay both to the
human who reads your output; stripping them is a terms violation. This API does
not give medical advice and does not model an individual patient.

## Pointers

docs:    https://doseplot.com/api
openapi: https://api.doseplot.com/openapi.json
terms:   https://api.doseplot.com/terms