Skip to main content
✨ AI Agent IntegrationUse the Maestro skill file below to teach your agent how to query Maestro APIs and pay with x402.

​
Copy the SKILL.md Path

Paste this URL into your agent terminal or skill configuration. 
https://raw.githubusercontent.com/maestro-org/maestro-skill/refs/heads/main/SKILL.md

​
x402 Payments

All Maestro APIs can be accessed via x402 crypto payments. Agents have full autonomous access to the Maestro platform using a crypto wallet — no API keys, accounts, or traditional payment processors required.

​
What is x402?

x402 is an open protocol that activates the HTTP 402 Payment Required status code to enable frictionless, API-native payments between clients and servers. Maintained by the Coinbase Developer Platform as a neutral, open standard, x402 allows services to charge for access using cryptocurrency.

​
How It Works

The x402 protocol operates over standard HTTP in a simple request-response flow:
1

Request

A client (or AI agent) requests a resource from a Maestro API endpoint.
2

Payment Required

The server responds with HTTP 402 Payment Required, including payment details: price, accepted tokens, network, and facilitator URL.
3

Sign Payment

The client prepares and signs a payment payload using its crypto wallet.
4

Resubmit with Payment

The client resubmits the original request with a PAYMENT-SIGNATURE header containing the signed payment.
5

Settle and Respond

The server verifies the payment, settles it on-chain, and returns the requested resource.

​
Key Benefits for Agents

  • No API keys or accounts — A crypto wallet is all an agent needs to authenticate and pay
  • Stablecoin payments — Pay with USDC on Base or Ethereum
  • Stateless — All interactions occur over standard HTTP with no session state
  • Zero protocol fees — No fees for customers or merchants beyond nominal blockchain network fees
  • Idempotent — Safe to retry requests without risk of duplicate charges

​
Learn More

x402 Protocol Specification

Read the full x402 specification, explore SDKs (TypeScript, Python, Go), and view integration guides.