Skip to content

docs: add MPP (Machine Payments Protocol) page#2217

Merged
GigaHierz merged 4 commits into
celo-org:mainfrom
viral-sangani:docs/add-mpp-page-v2
Jul 16, 2026
Merged

docs: add MPP (Machine Payments Protocol) page#2217
GigaHierz merged 4 commits into
celo-org:mainfrom
viral-sangani:docs/add-mpp-page-v2

Conversation

@viral-sangani

Copy link
Copy Markdown
Collaborator

Summary

Adds an MPP (Machine Payments Protocol) page under Build with AI → Agent Infrastructure, documenting how to accept and make MPP payments on Celo.

MPP (mpp.dev) is an open standard for HTTP-native machine payments. On Celo, a service can charge USDC per request via the mppx SDK; the buyer pays no gas — settlement is handled on-chain by the hosted facilitator at x402.celo.org.

What's included

  • How MPP works — the Challenge → Credential → Receipt flow, with a sequence diagram.
  • Seller + buyer code using the mppx SDK (evm.charge), verified end-to-end on Celo testnet and mainnet (real on-chain settlement).
  • Runnable example — links to celo-org/mpp-celo-example, a minimal seller + buyer you can clone and run.
  • A note on the one Celo-specific gotcha (the buyer must supply the token decimals + EIP-712 domain).

Scope

This page documents only what MPP supports on Celo today: one-time charge (a fixed price per request). MPP's session (metered) and subscription intents are not available on the EVM/Celo path, so they are intentionally not documented here.

Changes

  • build-on-celo/build-with-ai/mpp.mdx — new page
  • docs.json — adds the page to the Agent Infrastructure nav

Validation

  • docs.json is valid JSON; page registered in the nav.
  • All internal links resolve; <Note>/<Card> and icons used are already in use elsewhere in the docs.
  • The seller/buyer code was run against the live Celo facilitator and settled real payments on both testnet and mainnet.

Add a Build with AI > Agent Infrastructure page for MPP on Celo:
- what MPP is (HTTP-native machine payments) and how the charge flow works
- seller + buyer code examples using the mppx SDK, verified end-to-end on Celo
- links to the runnable example repo celo-org/mpp-celo-example
- scoped to MPP's one-time charge intent (what Celo supports today)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@viral-sangani
viral-sangani requested a review from a team as a code owner July 14, 2026 04:09
GigaHierz and others added 2 commits July 15, 2026 20:20
Add an MPP card to the "AI Agent Infrastructure" grid on the home page,
and mention x402 + MPP on the Build with AI overview — both inline in the
intro and in a new "Agent Payments with x402 and MPP" section.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@GigaHierz
GigaHierz requested review from a team as code owners July 15, 2026 19:37
@GigaHierz
GigaHierz requested review from palango and piersy and removed request for a team July 15, 2026 19:37
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@GigaHierz

Copy link
Copy Markdown
Contributor

Heads up: because this PR is from a fork, Mintlify's GitHub App doesn't post the required Mintlify Deployment preview check, so it can't merge (it sits at BLOCKED). I've opened #2220 with the identical content on a branch inside celo-org/docs so the Mintlify check runs — original authorship is preserved in the commit history. Once #2220 merges, this one can be closed.

@GigaHierz
GigaHierz merged commit c95b8e0 into celo-org:main Jul 16, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants