Model Context Protocol

MCP Server

Give your AI agents the ability to find the best x402 endpoint for any task. Compare pricing, uptime, and latency—all through natural conversation.

View on npm Source Code

Compatibility

Works with any MCP-compatible AI client

Claude Desktop

Native support

Cursor IDE

Built-in MCP

Continue

VS Code extension

Cline

VS Code extension

Installation

1Install the package

npm install -g clarityx402-mcp

2Add to your AI client config

For Claude Desktop, edit your claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "clarityx402": {
      "command": "clarityx402-mcp"
    }
  }
}

3Start chatting

Restart your AI client and start asking about x402 endpoints!

Quick start with npx

No installation required—use npx to run directly:

{
  "mcpServers": {
    "clarityx402": {
      "command": "npx",
      "args": ["-y", "clarityx402-mcp"]
    }
  }
}

Available Tools

5 tools for endpoint intelligence

find_best_endpoint

Find the optimal x402 endpoint for a given task based on quality score, price, and uptime.

Parameters

task*string — Category like "llm-inference", "image-generation"

budgetnumber — Max price in micro USDC

min_uptimenumber — Minimum uptime % (default: 90)

compare_endpoints

Compare endpoints within a category with ranked quality scores.

Parameters

category*string — Category to compare

sortstring — "score", "price", "uptime", or "latency"

check_endpoint_health

Get current health status of a specific endpoint by URL.

Parameters

url*string — Full URL of the x402 endpoint

get_price_history

Historical pricing data for trend analysis.

Parameters

endpoint_id*string — Endpoint ID

daysnumber — Days of history (default: 30)

list_categories

List all available endpoint categories with counts.

Example Prompts

Try these with your AI assistant

“Find me the best LLM inference endpoint under $0.01 per request”

“Compare all image generation endpoints by uptime”

“What's the cheapest search API with at least 95% uptime?”

“Check if api.example.com/v1/chat is healthy”

“Show me price trends for the top DeFi endpoint”

“What categories of x402 endpoints are available?”

Configuration

Advanced options

Custom API URL

By default, the server connects to https://clarityx402.vercel.app. To use your own instance:

{
  "mcpServers": {
    "clarityx402": {
      "command": "clarityx402-mcp",
      "env": {
        "CLARITYX402_API_URL": "https://your-instance.com"
      }
    }
  }
}

Ready to get started?

Install the MCP server and give your AI agents superpowers for finding the best x402 endpoints.

Browse Endpoints Learn about MCP