putty
API ReferenceTools

What each metered tool costs

The credit price of each metered MCP tool, so an agent can decide whether a call is worth making before it makes it. These are the same numbers `POST /agents/{id}/calls` charges: both read `CREDIT_PRICES` in `billing/pricing.ts` through the one mapping the meter owns. A tool that is not listed is billed at the `runStep` floor rather than free, so the table is a floor and not an exhaustive list of what could cost money. Every tool is listed, including the ones that cost the floor, because a caller that has to guess whether a call is free is a caller that will not make it.

GET
/agents/pricing

The credit price of each metered MCP tool, so an agent can decide whether a call is worth making before it makes it.

These are the same numbers POST /agents/{id}/calls charges: both read CREDIT_PRICES in billing/pricing.ts through the one mapping the meter owns. A tool that is not listed is billed at the runStep floor rather than free, so the table is a floor and not an exhaustive list of what could cost money.

Every tool is listed, including the ones that cost the floor, because a caller that has to guess whether a call is free is a caller that will not make it.

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/agents/pricing"
{  "tools": [    {      "toolName": "string",      "credits": 0    }  ]}