Skip to main content
The Shoal API supports the Machine Payments Protocol (MPP) — an open standard by Tempo and Stripe that enables pay-per-request access using HTTP 402. This is ideal for AI agents, one-off scripts, and services that need Shoal data without managing API keys.
MPP/x402 is available on the public paid surface, not every /v1/* route. Bulk and account-management endpoints remain API-key-only.

Pricing

How It Works

Quick Start

Install the MPP CLI and create a test account:
Make a paid request:

TypeScript

Python

Rust

Notes

  • MPP works on Shoal’s public paid endpoints
  • No API key or account signup required
  • Each request is independently paid and verified
  • Payment receipts are returned in the Payment-Receipt response header
  • Learn more at mpp.dev