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 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| 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 | |
TDQS
Scored across 15 tools
Each tool targets a distinct resource or action: catalog browsing vs. buying, flight search vs. price confirmation, table search vs. booking, and separate tools for weather, places, news, domains, and payment/spending metadata. There is no overlap that would cause an agent to select the wrong tool for its intent.
All tool names follow a consistent verb_noun pattern in snake_case (browse_catalog, search_flights, book_table, check_weather, track_confirmation). The verbs are appropriate and uniform, making the expected function of each tool predictable.
With 15 tools, the server sits at the upper edge of the well-scoped range. Each tool addresses a distinct service or workflow, and the breadth reflects the 'commerce marketplace' concept without excessive redundancy or trivial additions.
The server provides search and booking for tables but only search for flights and hotels, with no booking or cancellation tools for those domains. While buy_item covers storefront purchases, there is no order history or cancellation mechanism. The spending_report and track_confirmation tools help, but the missing lifecycle steps are notable gaps.