SOLx402

You run the SOLx402 MCP Server to enable AI assistants to interact with the x402 payment protocol on Solana. It helps you discover and use x402-enabled services, manage USDC payments, query protocol documentation, and access Solana development resources through integrated MCP clients.

How to use

You connect your MCP client to the SOLx402 MCP Server using the provided MCP URL. Once connected, you can search for available x402 services, review facilitator details, and consume a chosen service with built‑in payment handling. You can also query wallet information and USDC balance to verify funds before initiating a service.

When you want to consume a specific x402 service, the server handles the interaction and the associated USDC payment. Remember that external x402 services are managed by third parties and may be temporarily unavailable. Your client should gracefully handle service unavailability or delays.

How to install

Prerequisites: you need Node.js installed on your machine. You may also use npm or npx to run MCP commands.

# Install dependencies if needed (example, adjust to your setup)
npm install

# Run or start the MCP server client workflow as documented in your environment

Configuration and usage notes

Configure the MCP client to point at the SOLx402 MCP Server using the designated URL. The server supports an HTTP connection method to remotely host the MCP endpoint.

{
  "mcpServers": {
    "solx402": {
      "url": "https://server.smithery.ai/@leandrogavidia/solx402-mcp-server/mcp?api_key=<YOUR-SMITHERY-API-KEY>&profile=<YOUR-SMITHERY-PROFILE>",
      "type": "http",
      "timeout": 120000
    }
  }
}

Additional notes

Important: configure your MCP client with a minimum request timeout of 60,000 ms (60 seconds) to ensure x402 service consumption completes reliably. Short timeouts can cause requests to fail after USDC has been charged, resulting in payment without service access.

{
  "mcpServers": {
    "solx402": {
      "url": "https://server.smithery.ai/@leandrogavidia/solx402-mcp-server/mcp?api_key=<YOUR-SMITHERY-API-KEY>&profile=<YOUR-SMITHERY-PROFILE>",
      "type": "http",
      "timeout": 120000
    }
  }
}

Security and environment considerations

When you deploy or run the MCP server locally, you may choose to bind to a specific host and port. You can set environment variables for the server host and port as shown in the configuration options.

If you enable Solana Development Resources or Expert Assistance integrations, ensure you follow best practices for credential storage and access control to protect wallet keys and API keys.

Available tools

search_x402_documentation

Search across the x402 documentation to find relevant information, code examples, API references, and guides.

x402_protocol_flow

Visual diagram showing the x402 protocol flow and architecture.

get_x402_services

Retrieve a list of available x402 services from the facilitator.

get_facilitators

Retrieve a list of known Solana facilitators.

consume_x402_service

Consume a specific x402 service with automatic payment handling.

get_wallet_public_key

Retrieve the public key of the configured wallet.

get_wallet_usdc_balance

Check the USDC token balance of the configured wallet.

Ask_Solana_Anchor_Framework_Expert

Ask questions about developing on Solana with the Anchor Framework.

Solana_Documentation_Search

Search documentation across the Solana ecosystem for up-to-date information.