# Prices and price discovery

The price of every paid Munition tool, per call, and how agents read current prices from the free GET /v1/tools/prices discovery endpoint.

Every paid tool has one fixed price per call, in USDC, and the amount you sign is that price on every network. A test compares these tables with the server's price list on every change, so they show the prices the API charges.

## Reading the tables

- **Tool id** is the key in `GET /v1/tools/prices`. Most services come in up to three variants, one per way to pay, at the same price.
- **Paid with** says how: `x402` for the per-call HTTP routes (ids ending in `_direct`), `MPP` for the `/v1/mpp/*` routes (ids ending in `_mpp`), and `Account balance` for the MCP tools and account routes, charged to an [account balance (current)](/docs/payments#account-balance-current).
- **Price (USDC)** is the price of one call. **Atomic units** is the same price as it appears in the `amount` of a `402` (USDC has 6 decimals).

## Web research

Search and page reading through Exa, Firecrawl and Serper (Google). Routes and inputs are on [Web research API](/docs/services/web-research).

| Tool id | Paid with | Price (USDC) | Atomic units |
| --- | --- | --- | --- |
| `exa_search_direct` | x402 | 0.01 | 10000 |
| `exa_search_mpp` | MPP | 0.01 | 10000 |
| `exa_search` | Account balance | 0.01 | 10000 |
| `exa_contents_direct` | x402 | 0.002 | 2000 |
| `exa_contents_mpp` | MPP | 0.002 | 2000 |
| `exa_contents` | Account balance | 0.002 | 2000 |
| `exa_find_similar_direct` | x402 | 0.01 | 10000 |
| `exa_find_similar_mpp` | MPP | 0.01 | 10000 |
| `exa_find_similar` | Account balance | 0.01 | 10000 |
| `exa_answer_direct` | x402 | 0.01 | 10000 |
| `exa_answer_mpp` | MPP | 0.01 | 10000 |
| `exa_answer` | Account balance | 0.01 | 10000 |
| `firecrawl_scrape_direct` | x402 | 0.015 | 15000 |
| `firecrawl_scrape_mpp` | MPP | 0.015 | 15000 |
| `firecrawl_scrape` | Account balance | 0.015 | 15000 |
| `firecrawl_search_direct` | x402 | 0.03 | 30000 |
| `firecrawl_search_mpp` | MPP | 0.03 | 30000 |
| `firecrawl_search` | Account balance | 0.03 | 30000 |
| `serper_search_direct` | x402 | 0.004 | 4000 |
| `serper_search_mpp` | MPP | 0.004 | 4000 |
| `serper_search` | Account balance | 0.004 | 4000 |
| `serper_news_direct` | x402 | 0.004 | 4000 |
| `serper_news_mpp` | MPP | 0.004 | 4000 |
| `serper_news` | Account balance | 0.004 | 4000 |
| `serper_images_direct` | x402 | 0.004 | 4000 |
| `serper_images_mpp` | MPP | 0.004 | 4000 |
| `serper_images` | Account balance | 0.004 | 4000 |
| `serper_shopping_direct` | x402 | 0.004 | 4000 |
| `serper_shopping_mpp` | MPP | 0.004 | 4000 |
| `serper_shopping` | Account balance | 0.004 | 4000 |

## HTML to PDF

Render self-contained HTML to an A4 PDF with a public link, eligible for deletion after 7 days. See [HTML to PDF API](/docs/services/pdf).

| Tool id | Paid with | Price (USDC) | Atomic units |
| --- | --- | --- | --- |
| `render_pdf_direct` | x402 | 0.02 | 20000 |
| `render_pdf` | Account balance | 0.02 | 20000 |

## Upload

Temporary public file URLs: up to 10 MiB per file, kept 7 days; each renewal adds 7 days. See [Upload API](/docs/services/upload).

| Tool id | Paid with | Price (USDC) | Atomic units |
| --- | --- | --- | --- |
| `upload` | Account balance | 0.005 | 5000 |
| `upload_mpp` | MPP | 0.005 | 5000 |
| `renew` | Account balance | 0.005 | 5000 |
| `renew_upload_direct` | x402 | 0.005 | 5000 |
| `renew_upload_mpp` | MPP | 0.005 | 5000 |
| `delete_upload_direct` | x402 | 0.001 | 1000 |
| `delete_upload_mpp` | MPP | 0.001 | 1000 |

The x402 upload route, `POST /v1/uploads`, has no id of its own in the price list: it charges the `upload` price, 0.005 USDC.

## Flights

Live flight offers, airport reference data and offer details. See [Flight search API](/docs/services/flights).

| Tool id | Paid with | Price (USDC) | Atomic units |
| --- | --- | --- | --- |
| `search_flights_direct` | x402 | 0.05 | 50000 |
| `search_flights_mpp` | MPP | 0.05 | 50000 |
| `search_flights` | Account balance | 0.05 | 50000 |
| `airports_search_direct` | x402 | 0.001 | 1000 |
| `airports_search` | Account balance | 0.001 | 1000 |
| `flight_offer_details_direct` | x402 | 0.01 | 10000 |
| `flight_offer_details` | Account balance | 0.01 | 10000 |

## Forms

Hosted forms: a form closes after 100 responses or 30 days, and its answers stay readable 7 days after it closes. See [Forms API](/docs/services/forms). The price list includes these tools only while the forms service is enabled on the server.

| Tool id | Paid with | Price (USDC) | Atomic units |
| --- | --- | --- | --- |
| `create_form_direct` | x402 | 0.01 | 10000 |
| `create_form_mpp` | MPP | 0.01 | 10000 |
| `create_form` | Account balance | 0.01 | 10000 |

Free tools, such as flight booking links (`POST /v1/tools/flight-booking-links`), are not in the price list.

## Price discovery: GET /v1/tools/prices

`GET https://api.munition.io/v1/tools/prices` is free and needs no account or payment:

```bash
curl -sS https://api.munition.io/v1/tools/prices
```

It returns every paid tool, keyed by tool id. An excerpt, with two of the tools:

```json
{
  "version": "v2",
  "validUntil": "2026-12-03T12:00:00.000Z",
  "tools": {
    "serper_search_direct": { "amountUsd": 0.004, "amountUsdcAtomic": "4000", "currency": "USDC", "network": "base" },
    "upload": {
      "amountUsd": 0.005,
      "amountUsdcAtomic": "5000",
      "currency": "USDC",
      "network": "base",
      "retentionDays": 7,
      "maxBytes": 10485760
    }
  }
}
```

- `version` is the price list's version. It is also sent as the `x-price-version: v2` response header, so an agent can tell when prices change.
- `validUntil` is 30 days after the request. The response is cacheable: `cache-control: public, max-age=600`.
- Each tool has `amountUsd` (the price in USDC), `amountUsdcAtomic` (the same price in atomic units), `currency` (always `USDC`) and `network`, the API's main network. x402 routes accept every network in their `402`, listed on [Networks and assets](/docs/payments/networks).
- Some tools add their limits: `retentionDays` for uploads and PDFs, `maxBytes` for uploads, `extensionDays` for renewals, and `maxResponses`, `maxOpenDays` and `readableDaysAfterClose` for forms.

The `402` of each call remains the final word: its `amount` is what you sign. Other machine-readable descriptions of the same routes and prices are at `https://api.munition.io/.well-known/x402.json`, `https://api.munition.io/.well-known/mpp.json` and `https://api.munition.io/openapi.json`. For the payment headers, follow [Pay per call with x402](/docs/payments/x402): the server reads `PAYMENT-SIGNATURE` and answers with `PAYMENT-REQUIRED` and `PAYMENT-RESPONSE`.
