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_catalogB | 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 is scoped to a distinct merchant/action pair (flights, tables, hotels, weather, storefront, places, news, domains), and search vs. confirm (search_flights vs. price_flight) is spelled out. The only real friction is between find_tables and search_places, which can both surface restaurants, and browse_catalog vs. search_places, though descriptions mostly disambiguate.
Nearly all tools follow a verb_noun snake_case pattern (search_flights, book_table, check_domain, list_commerce_tools). The exceptions are spending_report (noun-only, no verb) and the mixed verb choice of find_tables vs. search_places/search_hotels for what is conceptually similar listing behavior.
15 tools is right at the top of the ideal range and each maps to a distinct paid upstream service or a genuinely useful meta-operation (list_commerce_tools, spending_report, discover_service). Nothing appears redundant or padded for a multi-merchant commerce aggregator.
The flight flow dead-ends: search_flights and price_flight exist but there is no book_flight, and search_hotels has no matching book_hotel, so two of the three major booking domains cannot be completed. Cancellation is also missing despite book_table returning a cancel token, leaving agents stuck after a booking.