Welcome to the technical documentation for the Otto AI Agent Swarm on MPP. MPP is Otto’s blessed read-only/query storefront: it gives agents and developers an IETF-standard payment rail for market intelligence, research, creative query tools, and wallet-scoped resource reads.
MPP intentionally does not expose principal-moving or order-executing POST routes. For swaps, bridges, deposits, withdrawals, Hyperliquid order execution, dynamic video pricing, or autonomous sub-wallet actions, use x402, ACP, or Otto X.
Base URL: https://mpp.ottoai.services
Protocol: Machine Payments Protocol (MPP) — IETF standard (paymentauth.org)
Payment: Tempo USDC.e on Tempo blockchain (Chain ID: 4217). Every endpoint in this catalog answers an unpaid request with a 402 whose challenge advertises method="tempo" and no other method, so a Tempo stablecoin account is what you need to call it. Card payment is not among the methods this storefront advertises.
SDK: npm install mppx — TypeScript SDK docs
Discovery:
What is MPP?
The Machine Payments Protocol is an open IETF standard for machine-to-machine payments, developed by Tempo Labs and Stripe. It standardizes HTTP 402 “Payment Required” with an extensible framework that works with any payment network.
Key properties:
- Open standard — built on an IETF specification, not a proprietary API
- Method-agnostic — the payment method is carried inside the challenge rather than fixed by the protocol, so each server advertises what it takes. Otto’s storefront advertises Tempo stablecoins.
- Agent-native — designed for programmatic access with idempotency, security, and receipts as first-class primitives
MPP vs x402
Otto AI runs multiple pay-per-request storefronts on top of the same underlying agents. MPP is deliberately scoped to GET/read-only and query-style calls.
Which should I use? If you need the broadest HTTP catalog or any execution route, use x402. If you want Tempo stablecoins for read-only/query access, use MPP. For exact counts and capability coverage, see Access Paths & Coverage.
Pricing Overview
Market Intelligence (Market Alpha Agent)
Data Intelligence (Market Alpha Agent)
Trading Resources (Trade Execution Agent)
Data Endpoints (aggregate-cache market data)
Otto’s data endpoints are aggregate-cache reads refreshed on a schedule and fanned out cheaply. MPP lists a curated warm-only subset: a cold or long-tail key returns 503 (unpaid — MPP never charges Tempo for data it cannot immediately serve). Arbitrary token-price, top-holder, wallet-holdings, and pool-search keys remain available on x402, where on-demand long-tail coverage is supported.
How to Make a Request (MPP Flow)
Step 1: Initial Request (Returns 402)
The server responds with HTTP 402 Payment Required and a WWW-Authenticate: Payment header containing the payment challenge:
Step 2: Pay and Retry with Credential
The mppx SDK handles this automatically:
Step 3: Receive Response with Receipt
Using the CLI
mppx keeps account keys in the operating system keychain, and both mppx account create and any paid request need that keychain present. On a headless Linux host without it, mppx 0.8.12 exits non-zero with code: KEYCHAIN_UNAVAILABLE and tells you to install libsecret-tools for secret-tool. Set that up before running the commands above, or use the TypeScript SDK shown earlier, which is handed an account key in code.
No payment or account is needed to look at an endpoint’s payment challenge — an unpaid request returns the 402 and its WWW-Authenticate header, which names the payment method and the challenge the SDK settles. Prices are in the tables above.
Run mppx --help for the full command and flag list on your installed version.
Endpoint Details
Market Intelligence Endpoints
/crypto-news
Real-time crypto market news with sentiment analysis and top headlines.
/filtered-news
AI-filtered crypto news by topic.
/token-details
Token price, market cap, volume, and basic metrics.
/token-alpha
Premium token intelligence with news, sentiment, derivatives data.
/token-security
Token contract security audit powered by GoPlus.
/funding-rates
Derivatives intelligence: funding rates, open interest, long/short ratios, whale positions.
All endpoints return JSON with a consistent structure:
On error:
Support