AI-Powered x402 Integration

SOLx402 MCP Server

Model Context Protocol server enabling AI assistants to interact with the x402 payment protocol on Solana.

AI-Native

Native MCP Protocol

Solana

x402 Integration

Instant

USDC Payments

Playground

Test and interact with the SOLx402 MCP server in Smithery's visual playground environment

NextJS Playground

Test and interact with the SOLx402 MCP server in NextJS's visual playground environment

AI Integration

Seamlessly integrate AI assistants with the x402 payment protocol through Model Context Protocol.

x402 Protocol

Discover and consume x402-enabled services with automated payment handling.

Developer Ready

Simple configuration and easy integration into Claude, Cursor, VS Code, and more.

Architecture Flow

AI Agent

(Claude, ChatGPT, GitHub Copilot, etc)

SOLx402

MCP Server

Solana

Blockchain

x402

Payment Protocol

Step 1: Connect

AI assistant communicates via MCP protocol

Step 2: Process

MCP server handles x402 protocol logic

Step 3: Execute

Payments settled on Solana instantly

x402 Flow Diagram

Tools Reference

Core tools available in the MCP server

get_x402_services

Retrieve a list of available x402 services from the facilitator.

Parameters

facilitatorUrllimit

Returns

Array of service objects with details

consume_x402_service

Consume a specific x402 service with automatic payment handling.

Parameters

x402ServiceUrl

Returns

Service response data

get_facilitators

Retrieve a list of available facilitators.

Parameters

Returns

Array of facilitator objects with details

search_x402_documentation

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

Parameters

query

Returns

Search results with relevant documentation snippets

x402_protocol_flow

Visual diagram showing the x402 protocol flow and architecture.

Parameters

Returns

URL to the protocol flow diagram image

get_wallet_public_key

Retrieve the public key of the configured wallet.

Parameters

Returns

Wallet public key

get_wallet_usdc_balance

Check the USDC token balance of the configured wallet.

Parameters

Returns

Wallet USDC balance

Ask_Solana_Anchor_Framework_Expert

Ask questions about developing on Solana with the Anchor Framework.

Parameters

question

Returns

Expert guidance on Solana Anchor development

Solana_Expert__Ask_For_Help

A Solana expert that can answer questions about Solana development.

Parameters

question

Returns

Expert answers on Solana development

Solana_Documentation_Search

Search documentation across the Solana ecosystem to get the most up to date information.

Parameters

query

Returns

Search results with relevant Solana documentation snippets

Integration Steps

Get started in 5 simple steps

Visit Smithery

Go to the SOLx402 MCP Server Smithery page

Sign In

Authenticate with your account

Configure

Fill in required fields and optional configurations

Generate URL

Create MCP server URL with your API key

Integrate

Add URL to Claude, Cursor, VS Code, or other clients

Ready to integrate?

Access the Smithery page to configure your MCP server

⚠️ Important: Request Timeout Configuration

Critical Setup Requirement for successful x402 service consumption

Minimum Request Timeout Required

Configure your MCP client with a minimum request timeout of 60,000ms (60 seconds)

Why This Matters:

x402 services are external APIs that may require significant processing time
Payment transactions are executed on the Solana blockchain, which can take time to confirm
Short timeouts can cause requests to fail after USDC has been charged, resulting in payment without receiving the service
By default, MCP servers use a maximum request timeout of 10 seconds, which is insufficient for x402 operations

Recommended: 60+ seconds

Minimum timeout for x402 service consumption to handle blockchain confirmations and external API processing.

Default MCP Timeout: 10s

Standard MCP server timeout is too short for blockchain operations and may cause payment issues.

Potential Issues with Short Timeouts

💰 Payment Without Service

USDC may be charged but service request fails due to timeout

🔄 External API Processing

x402 services may need additional time for complex operations

Configuration Example

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

Query Parameters

Detailed reference for all available parameters

Parameter	Type	Required	Description
`privateKey`	string	Yes	Base58-encoded private key for your Solana wallet
`mainnetRpcUrl`	string	Yes	Solana RPC URL for mainnet operations
`isMainnet`	boolean	No	Set to true for mainnet, false for devnet (Default: false)
`facilitatorUrl`	string	No	URL of the x402 facilitator (default: PayAI Facilitator URL)
`maxPrice`	number	No	Maximum price to pay for services in USDC microcents, e.g. 10000 = 0.01 USDC (default: 0)
`useSolanaMcpServer`	boolean	No	Enable Solana development tools integration (default: false)