Skip to content

docs: add MPP (Celo-hosted x402 facilitator) page#2216

Closed
viral-sangani wants to merge 1 commit into
celo-org:mainfrom
viral-sangani:docs/add-mpp-page
Closed

docs: add MPP (Celo-hosted x402 facilitator) page#2216
viral-sangani wants to merge 1 commit into
celo-org:mainfrom
viral-sangani:docs/add-mpp-page

Conversation

@viral-sangani

Copy link
Copy Markdown
Collaborator

Summary

Adds a MPP page under Build with AI → Agent Infrastructure, documenting Celo's hosted x402 facilitator at x402.celo.org.

The existing x402.mdx covers the protocol and the thirdweb-hosted facilitator; this page covers the Celo-native hosted option — so builders who want a Celo-first, ready-to-use facilitator have a direct path. The two pages cross-link each other.

What's included

  • High-level explanation of what MPP is (hosted x402 facilitator: seller returns 402, buyer signs EIP-3009, facilitator settles on-chain and pays gas) and why it fits Celo.
  • Code examples — facilitator client, seller (@x402/hono), and buyer (@x402/fetch). These mirror the live integration guide and were verified end-to-end against the facilitator on Celo Sepolia (real on-chain settlement).
  • Runnable example repo — links to celo-org/mpp-celo-example, a minimal seller + buyer you can clone and run.
  • CTA to the agent skill — points integrators at x402.celo.org/skill.md so their AI coding assistant can add MPP payments for them.
  • A Celo-specific warning about naming the asset explicitly (bare "$0.01" pricing 500s until coinbase/x402#244 merges).

Changes

  • build-on-celo/build-with-ai/mpp.mdx — new page
  • docs.json — adds the page to the Agent Infrastructure nav group
  • build-on-celo/build-with-ai/x402.mdx — cross-link note to the new MPP page

Validation

  • docs.json is valid JSON; the page is registered in the nav.
  • All internal links resolve to existing pages; <Note>/<Card>/<Warning> and the icons used are all already in use elsewhere in the docs.
  • The seller/buyer code was run against the live Celo Sepolia facilitator and settled a real payment.

Add a Build with AI > Agent Infrastructure page for MPP, Celo's hosted x402
facilitator at x402.celo.org:
- high-level explanation of what MPP is and why on Celo
- seller + buyer code examples (verified against the live facilitator)
- link to the runnable example repo celo-org/mpp-celo-example
- CTA pointing integrators to the x402.celo.org/skill.md agent skill

Also cross-links the existing x402 page to MPP and back.

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 02:56
@viral-sangani

Copy link
Copy Markdown
Collaborator Author

Closing this — on review, this page describes the Celo-hosted x402 facilitator but was mislabeled as MPP (Machine Payments Protocol), which is a distinct protocol (Tempo/Stripe). Celo already has x402 documentation, so this page isn't needed. Apologies for the noise.

@viral-sangani viral-sangani deleted the docs/add-mpp-page branch July 14, 2026 03:20
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.

1 participant