AILANG×developers.cloudflare.com

# Agentic Payments · Cloudflare Agents docs


Documentation Index

Fetch the complete documentation index at: https://developers.cloudflare.com/agents/llms.txt

Use this file to discover all available pages before exploring further.

[Skip to content](#_top)

*Header:*
STOP! If you are an AI agent or LLM, read this before continuing. This is the HTML version of a Cloudflare documentation page. Always request the Markdown version instead — HTML wastes context. Get this page as Markdown: https://developers.cloudflare.com/agents/agentic-payments/index.md (append index.md) or send Accept: text/markdown to https://developers.cloudflare.com/agents/agentic-payments/. For this product's page index use https://developers.cloudflare.com/agents/llms.txt. For all Cloudflare products use https://developers.cloudflare.com/llms.txt.

[Image]

Cloudflare Docs

[Cloudflare Docs](/)

Search

[Docs Directory](/directory/)[APIs](https://developers.cloudflare.com/api/)[SDKs](/fundamentals/api/reference/sdks/)Help

[Log in](https://dash.cloudflare.com/)

Select themeDarkLightAuto

[Agents](/agents/)

No results found. Try a different search term, or use our

global search

.

(() => {
			try {
				if (!matchMedia('(min-width: 50em)').matches) return;
				/** @type {HTMLElement | null} */
				const target = document.querySelector('sl-sidebar-state-persist');
				const state = JSON.parse(sessionStorage.getItem('sl-sidebar-state') || '0');
				if (!target || !state || target.dataset.hash !== state.hash) return;
				window._starlightScrollRestore = state.scroll;
				customElements.define(
					'sl-sidebar-restore',
					class SidebarRestore extends HTMLElement {
						connectedCallback() {
							try {
								const idx = parseInt(this.dataset.index || '');
								const details = this.closest('details');
								if (details && typeof state.open[idx] === 'boolean') details.open = state.open[idx];
							} catch {}
						}
					}
				);
			} catch {}
		})();
	

[Overview](/agents/)
Getting started

[Quick start](/agents/getting-started/quick-start/)
[Add to existing project](/agents/getting-started/add-to-existing-project/)
[Testing your Agents](/agents/getting-started/testing-your-agent/)
[Build a chat agent](/agents/getting-started/build-a-chat-agent/)
[Prompt an AI model ↗](/workers/get-started/prompting/)
Concepts

[What are agents?](/agents/concepts/what-are-agents/)
[Workflows](/agents/concepts/workflows/)
[Tools](/agents/concepts/tools/)
[Agent class internals](/agents/concepts/agent-class/)
[Human in the Loop](/agents/concepts/human-in-the-loop/)
[Calling LLMs](/agents/concepts/calling-llms/)
[Long-running agents](/agents/concepts/long-running-agents/)
[Memory](/agents/concepts/memory/)
[Patterns](/agents/patterns/)
Guides

[Implement Effective Agent Patterns ↗](https://github.com/cloudflare/agents/tree/main/guides/anthropic-patterns)
[Human-in-the-loop patterns](/agents/guides/human-in-the-loop/)
[Autonomous responses](/agents/guides/autonomous-responses/)
[Webhooks](/agents/guides/webhooks/)
[Build a Slack Agent](/agents/guides/slack-agent/)
[Build an Interactive ChatGPT App](/agents/guides/chatgpt-app/)
[Build a Remote MCP server](/agents/guides/remote-mcp-server/)
[Push notifications](/agents/guides/push-notifications/)
[Test a Remote MCP Server](/agents/guides/test-remote-mcp-server/)
[Securing MCP servers](/agents/guides/securing-mcp-server/)
[Connect to an MCP server](/agents/guides/connect-mcp-client/)
[Build a Remote MCP Client ↗](https://github.com/cloudflare/ai/tree/main/demos/mcp-client)
[Handle OAuth with MCP servers](/agents/guides/oauth-mcp-client/)
[Cross-domain authentication](/agents/guides/cross-domain-authentication/)
[Build a voice agent](/agents/guides/build-a-voice-agent/)
API Reference

[Agents API](/agents/api-reference/agents-api/)
[Routing](/agents/api-reference/routing/)
[Configuration](/agents/api-reference/configuration/)
[Chat agents](/agents/api-reference/chat-agents/)
[Client SDK](/agents/api-reference/client-sdk/)
[Callable methods](/agents/api-reference/callable-methods/)
[Store and sync state](/agents/api-reference/store-and-sync-state/)
[WebSockets](/agents/api-reference/websockets/)
[HTTP and Server-Sent Events](/agents/api-reference/http-sse/)
[Schedule tasks](/agents/api-reference/schedule-tasks/)
[Durable execution](/agents/api-reference/durable-execution/)
[Queue tasks](/agents/api-reference/queue-tasks/)
[Retries](/agents/api-reference/retries/)
[Run Workflows](/agents/api-reference/run-workflows/)
[Sub-agents](/agents/api-reference/sub-agents/)
[Agent tools](/agents/api-reference/agent-tools/)
[Email](/agents/api-reference/email/)
[Think](/agents/api-reference/think/)
[Sessions](/agents/api-reference/sessions/)
[Codemode](/agents/api-reference/codemode/)
[Using AI Models](/agents/api-reference/using-ai-models/)
[Retrieval Augmented Generation](/agents/api-reference/rag/)
[Browse the web](/agents/api-reference/browse-the-web/)
[Voice agents](/agents/api-reference/voice/)
[createMcpHandler](/agents/api-reference/mcp-handler-api/)
[McpAgent](/agents/api-reference/mcp-agent-api/)
[McpClient](/agents/api-reference/mcp-client-api/)
[Protocol messages](/agents/api-reference/protocol-messages/)
[Readonly connections](/agents/api-reference/readonly-connections/)
[getCurrentAgent()](/agents/api-reference/get-current-agent/)
[Observability](/agents/api-reference/observability/)
Model Context Protocol (MCP)

[Overview](/agents/model-context-protocol/)
[Tools](/agents/model-context-protocol/tools/)
[Authorization](/agents/model-context-protocol/authorization/)
[Transport](/agents/model-context-protocol/transport/)
[MCP governance](/agents/model-context-protocol/governance/)
[MCP server portals ↗](/cloudflare-one/access-controls/ai-controls/mcp-portals/)
[Cloudflare's own MCP servers](/agents/model-context-protocol/mcp-servers-for-cloudflare/)
Platform

[Limits](/agents/platform/limits/)
[Prompt Engineering ↗](/workers/get-started/prompting/)
[prompt.txt ↗](/workers/prompt.txt)
Agentic Payments

[Overview](/agents/agentic-payments/)
x402

[Overview](/agents/agentic-payments/x402/)
[Charge for HTTP content](/agents/agentic-payments/x402/charge-for-http-content/)
[Charge for MCP tools](/agents/agentic-payments/x402/charge-for-mcp-tools/)
[Pay from Agents SDK](/agents/agentic-payments/x402/pay-from-agents-sdk/)
[Pay from coding tools](/agents/agentic-payments/x402/pay-with-tool-plugins/)
MPP (Machine Payments Protocol)

[Overview](/agents/agentic-payments/mpp/)
[Charge for HTTP content](/agents/agentic-payments/mpp/charge-for-http-content/)
[Cloudflare Community MCP Server](/agents/community-mcp-server/)
Agent resources

[Agent setup ↗](/agent-setup/)
[Cloudflare Skills ↗](https://github.com/cloudflare/skills)
[Code Mode MCP Server ↗](https://github.com/cloudflare/mcp)
[Domain-specific MCP Servers ↗](https://github.com/cloudflare/mcp-server-cloudflare)
[Agents llms.txt ↗](/agents/llms.txt)
[Agents llms-full.txt ↗](/agents/llms-full.txt)
[Cloudflare Docs llms.txt ↗](/llms.txt)
[Cloudflare Docs llms-full.txt ↗](/llms-full.txt)
		(() => {
			const scroller = document.getElementById('starlight__sidebar');
			if (!window._starlightScrollRestore || !scroller) return;
			scroller.scrollTop = window._starlightScrollRestore;
			delete window._starlightScrollRestore;
		})();

[GitHub](https://github.com/cloudflare/cloudflare-docs)

[X.com](https://x.com/cloudflare)

[YouTube](https://www.youtube.com/cloudflare)

Select themeDarkLightAuto

On this page

Overview
x402 and Machine Payments Protocol

x402
Machine Payments Protocol
Charge for resources
Related

On this page

Overview
x402 and Machine Payments Protocol

x402
Machine Payments Protocol
Charge for resources
Related

[Edit page](https://github.com/cloudflare/cloudflare-docs/edit/production/src/content/docs/agents/agentic-payments/index.mdx)

[Report issue](https://github.com/cloudflare/cloudflare-docs/issues/new/choose)

[ Directory ](/directory/)
 … 
[ Agents ](/agents/)
[ Agentic Payments ](/agents/agentic-payments/)

# Agentic Payments

Copy as MarkdownCopied!

|

[View as Markdown](index.md)

|

Agent setup

|

Docs for agents

AI agents need to discover, pay for, and consume resources and services programmatically. Traditional onboarding requires account creation, a payment method, and an API key before an agent can pay for a service. Agentic payments let AI agents purchase resources and services directly through the HTTP `402 Payment Required` response code.

Cloudflare's [Agents SDK](/agents/) supports agentic payments through two protocols built on the HTTP `402 Payment Required` status code: **x402** and **Machine Payments Protocol (MPP)**. Both follow the same core flow:

1. A client requests a resource or calls a tool.
2. The server responds with `402` and a payment challenge describing what to pay, how much, and where.
3. The client fulfills the payment and retries the request with a payment credential.
4. The server verifies the payment (optionally through a facilitator service) and returns the resource along with a receipt.

No accounts, sessions, or pre-shared API keys are required. Agents handle the entire exchange programmatically.

## x402 and Machine Payments Protocol

### x402

[x402 ↗](https://www.x402.org/) is a payment standard created by Coinbase. It uses on-chain stablecoin payments (USDC on Base, Ethereum, Solana, and other networks) and defines three HTTP headers — `PAYMENT-REQUIRED`, `PAYMENT-SIGNATURE`, and `PAYMENT-RESPONSE` — to carry challenges, credentials, and receipts. Servers can offload verification and settlement to a **facilitator** service so they do not need direct blockchain connectivity. It is governed by Coinbase and Cloudflare, two of the founding members of the x402 Foundation.

The Agents SDK provides first-class x402 integration:

- **Server-side**: `withX402` and `paidTool` for MCP servers, plus `x402-hono` middleware for HTTP Workers.
- **Client-side**: `withX402Client` wraps MCP client connections with automatic 402 handling and optional human-in-the-loop confirmation.

### Machine Payments Protocol

[Machine Payments Protocol (MPP) ↗](https://mpp.dev) is a protocol co-authored by Tempo Labs and Stripe. It extends the HTTP `402` pattern with a formal `WWW-Authenticate: Payment` / `Authorization: Payment` header scheme and is on the IETF standards track.

MPP supports multiple payment methods beyond blockchain — including cards (via Stripe), Bitcoin Lightning, and stablecoins — and introduces **sessions** for streaming and pay-as-you-go use cases with sub-millisecond latency and sub-cent costs. MPP is backwards-compatible with x402: MPP clients can consume existing x402 services without modification.

## Charge for resources

[HTTP content (x402)](/agents/agentic-payments/x402/charge-for-http-content/)Gate APIs, web pages, and files with a Worker proxy

[HTTP content (MPP)](/agents/agentic-payments/mpp/charge-for-http-content/)Gate APIs, web pages, and files with a Worker proxy

## Related

- [x402.org ↗](https://x402.org) — x402 protocol specification
- [mpp.dev ↗](https://mpp.dev) — MPP protocol specification
- [Pay Per Crawl](/ai-crawl-control/features/pay-per-crawl/) — Cloudflare-native monetization for web content
- [x402 examples ↗](https://github.com/cloudflare/agents/tree/main/examples) — Complete working code

*Footer:*
- **Resources**
- [  API ](/api/)
- [  New to Cloudflare? ](/fundamentals/)
- [  Directory ](/directory/)
- [  Sponsorships ](/sponsorships/)
- [  Open Source ](https://github.com/cloudflare)

- **Support**
- [  Help Center ](https://support.cloudflare.com/)
- [  System Status ](https://www.cloudflarestatus.com/)
- [  Compliance ](https://www.cloudflare.com/trust-hub/compliance-resources/)
- [  GDPR ](https://www.cloudflare.com/trust-hub/gdpr/)

- **Company**
- [  cloudflare.com ](https://www.cloudflare.com/)
- [  Our team ](https://www.cloudflare.com/people/)
- [  Careers ](https://www.cloudflare.com/careers/)

- **Tools**
- [  Cloudflare R