MPP Integration

Pay for CAPTCHA solves using the Machine Payments Protocol on Tempo

What is MPP?

The Machine Payments Protocol (MPP) is an open standard for machine-to-machine payments over HTTP. It adds inline payments to any API endpoint — agents pay as part of their request, and the server verifies payment before returning the response.

Built on the Tempo blockchain (incubated by Stripe & Paradigm), MPP offers sub-cent fees, ~500ms finality, and stablecoin-native gas.

Endpoint

POST /api/mpp/solve

Same request body as /api/solve, but payment is handled via MPP instead of x402 headers.

How It Works

1

Agent sends request

POST to /api/mpp/solve with type, siteKey, pageUrl

2

Server responds with 402 + Challenge

Includes amount, currency, and recipient in WWW-Authenticate header

3

Agent pays on Tempo

Signs transaction using Tempo wallet or mppx client

4

CAPTCHA solved, token returned

Server verifies payment, solves CAPTCHA, returns solution token

Quick Start

Using Tempo CLI

# Install Tempo CLI
curl -fsSL https://tempo.xyz/install | bash

# Create a wallet (one-time)
tempo wallet create

# Make a paid CAPTCHA solve request
tempo request POST https://gatesolve.dev/api/mpp/solve \
  -d '{"type":"cloudflare-turnstile","siteKey":"0x...","pageUrl":"https://example.com"}'

Using mppx (TypeScript)

import { Mppx, tempo } from 'mppx'

const mppx = await Mppx.create({
  methods: [tempo.charge()],
})

const response = await mppx.fetch(
  'https://gatesolve.dev/api/mpp/solve',
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      type: 'cloudflare-turnstile',
      siteKey: '0x...',
      pageUrl: 'https://example.com',
    }),
  }
)

const { token } = await response.json()
console.log('Solved:', token)

Using pympp (Python)

from pympp import MppClient

client = MppClient()

response = client.post(
    "https://gatesolve.dev/api/mpp/solve",
    json={
        "type": "cloudflare-turnstile",
        "siteKey": "0x...",
        "pageUrl": "https://example.com",
    },
)

print("Solved:", response.json()["token"])

Pricing

CAPTCHA TypePrice (USDC)
Cloudflare Turnstile$0.02
reCAPTCHA v2$0.03
reCAPTCHA v3$0.02
hCaptcha$0.03

Prices are in USDC on Tempo. Transaction fees are sub-cent.