x402-mcp-commerce
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NETWORK | No | EVM network to use (default 'base-sepolia', mainnet 'base'). | base-sepolia |
| MAX_CALLS | No | Total number of paid calls allowed. | |
| X402_RAIL | No | Server-wide default payment rail (e.g., 'auto', 'evm', 'solana'). Per-tool overrides can be set as X402_RAIL_<TOOL>. | |
| PRIVATE_KEY | No | The EVM wallet private key that signs Base payments. Without it the EVM rail is unavailable. | |
| ALLOWED_TOOLS | No | Comma-separated allowlist of tools; empty means all. | |
| PAY_TO_ADDRESS | No | The pay-to address for EVM rail. | |
| SIGNING_SECRET | No | HMAC key behind the attestation signature. | |
| SOLANA_NETWORK | No | Solana network to use (default 'solana', 'devnet' for testing). | solana |
| SOLANA_RPC_URL | No | RPC URL used to build the SPL transfer. The public endpoint is heavily rate limited. | |
| FACILITATOR_URL | No | The facilitator URL for EVM rail (default 'https://x402.org/facilitator'). | https://x402.org/facilitator |
| MAX_SESSION_USD | No | Total spending cap in USD for this process. | |
| MAX_PER_CALL_USD | No | Maximum amount in USD this agent will pay for one call. | |
| X402_TOOLS_CONFIG | No | Path to the tools configuration JSON file. | |
| SOLANA_PRIVATE_KEY | No | Base58 or JSON-array secret key for the Solana rail. Optional; leave unset to disable the Solana rail. | |
| SOLANA_PAY_TO_ADDRESS | No | The pay-to address for Solana rail. | |
| SOLANA_FACILITATOR_URL | No | The Solana facilitator URL (default 'https://facilitator.payai.network'). | https://facilitator.payai.network |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_commerce_toolsA | List every commerce tool this server exposes, with its upstream service, price, and configured payment rail. Free — no payment is made. |
| spending_reportA | Show this agent's spending caps, how much it has spent so far, and every payment it has made in this session. Free — no payment is made. |
| discover_serviceA | Read any x402 service's /.well-known/x402 manifest to learn its routes, prices, payment rails, and response schemas. Free — no payment is made. |
| search_flightsA | Search flights between two airports on a date. Returns priced offers with airline, times, stops and fare basis. Costs $0.005 per call, paid in USDC over x402 to x402-flight-search. Returns the merchant's artifact and the payment receipt. |
| price_flightA | Confirm the live price and availability of a specific flight offer before booking. Costs $0.003 per call, paid in USDC over x402 to x402-flight-search. Returns the merchant's artifact and the payment receipt. |
| find_tablesA | List open restaurant reservation slots for a date and party size. Costs $0.001 per call, paid in USDC over x402 to x402-tablebook. Returns the merchant's artifact and the payment receipt. |
| book_tableA | Book a restaurant table. Returns the confirmed reservation with a cancel token, refund terms and a calendar invite. The hold is refundable. Costs $0.01 per call, paid in USDC over x402 to x402-tablebook. Returns the merchant's artifact and the payment receipt. |
| search_hotelsA | Search hotel rooms and offers for a city and date range. Costs $0.005 per call, paid in USDC over x402 to x402-hotel-search. Returns the merchant's artifact and the payment receipt. |
| check_weatherA | Forecast for a location, with the plan-relevant summary an agent needs to decide whether an outdoor booking is a good idea. Costs $0.001 per call, paid in USDC over x402 to x402-weather-guard. Returns the merchant's artifact and the payment receipt. |
| browse_catalogA | List a storefront's items with prices and buy routes. Free at the merchant. Costs free per call, paid in USDC over x402 to x402-storefront. Returns the merchant's artifact and the payment receipt. |
| buy_itemA | Buy an item from a storefront. Digital goods return a signed download URL and license; physical goods return a signed order confirmation and fulfillment record. Costs per item per call, paid in USDC over x402 to x402-storefront. Returns the merchant's artifact and the payment receipt. |
| search_placesA | Find places — restaurants, shops, landmarks — near a point or in a named area. Costs $0.002 per call, paid in USDC over x402 to x402-places. Returns the merchant's artifact and the payment receipt. |
| search_newsA | Query the global news wire for coverage of a topic in a time window. Costs $0.003 per call, paid in USDC over x402 to x402-news-wire. Returns the merchant's artifact and the payment receipt. |
| check_domainA | Check whether a domain is registered, and if so who holds it and when it expires. Costs $0.001 per call, paid in USDC over x402 to x402-domains. Returns the merchant's artifact and the payment receipt. |
| track_confirmationA | Normalize any merchant confirmation into a portable record plus an ICS calendar invite. Feed it the artifact any booking tool returned. Costs $0.005 per call, paid in USDC over x402 to x402-confirmations. Returns the merchant's artifact and the payment receipt. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/nirholas/x402-mcp-commerce'
If you have feedback or need assistance with the MCP directory API, please join our Discord server