Skip to content

docs: clarify agentic payment methods and enhance x402 documentation #2836

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
birosrichard wants to merge 1 commit into
base: master
Choose a base branch
from
+12 −4
Open

docs: clarify agentic payment methods and enhance x402 documentation #2836

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions sources/platform/integrations/ai/mcp.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -356,10 +356,12 @@ Your AI can search Apify Store for relevant Actors using the `search-actors` too

## Agentic payments

Agentic payments allow AI agents to autonomously pay for Actor runs without requiring an Apify API token. The Apify MCP server supports two payment methods:
Agentic payments allow AI agents to autonomously pay for Actor runs without requiring an Apify API token:

- [x402 protocol](/integrations/x402) - Direct on-chain payments using USDC on the [Base](https://www.base.org/) blockchain via the open [x402](https://www.x402.org/) standard.
- [Skyfire](/integrations/skyfire) - Managed payment tokens through the [Skyfire](https://www.skyfire.xyz/) payment platform.
- [AGI](/integrations/x402) - buy a prepaid Apify API token from [Apify AGI](https://agi.apify.com) with an x402 or MPP payment, then use it against this MCP server or the Apify API directly. Recommended for most agents - works for any Actor, not just Pay Per Event ones.
- [Skyfire](/integrations/skyfire) - managed payment tokens through the [Skyfire](https://www.skyfire.xyz/) payment platform.

The MCP server also has its own Direct x402 support (per-request, no minted token, Pay Per Event Actors only) via [`mcpc`](https://github.com/apify/mcp-cli) - see the [Apify MCP Server README](https://github.com/apify/apify-mcp-server#-agentic-payments) for setup.

For setup instructions and details, see the individual integration pages.

Expand Down
8 changes: 7 additions & 1 deletion sources/platform/integrations/ai/x402.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,12 @@ Agentic payments are experimental and may change as payment protocols evolve.

:::

:::info Powered by Apify AGI

This flow buys a prepaid Apify API token from [Apify AGI](https://agi.apify.com) (Agent General Interface) in exchange for an x402 payment - see its site for current terms (minimum amount, token lifetime, refund policy).

:::

:::tip For AI agents

If you are an AI agent, use the ready-made [Apify x402 skill](https://raw.githubusercontent.com/apify/awesome-skills/refs/heads/main/skills/apify-x402-agentic-wallet/SKILL.md). It walks you through wallet setup, payment, and running Actors end to end. The steps below describe the same flow for manual use.
Expand Down Expand Up @@ -71,7 +77,7 @@ Both USDC and ETH must be present. ETH covers the gas for deploying your wallet

## Buy a prepaid token

Pay for a prepaid token from the Apify agentic endpoint. The wallet signs the payment and returns a token tied to a prepaid balance:
Pay for a prepaid token from Apify AGI. The wallet signs the payment and returns a token tied to a prepaid balance:

```bash
npx awal x402 pay 'https://agi.apify.com/protocols/x402/prepaid-tokens?amount=1&currency=usd' \
Expand Down
Loading