askclaude-mcp

MCP (Model Context Protocol) server for AskClaude — pay-per-query Claude AI via x402 micropayments.

This server exposes AskClaude's paid endpoints as tools that Claude Code (or any MCP client) can call. Each tool call triggers a request to the AskClaude x402 service, where payment is handled in USDC on Base network.

Tools

Installation

Option 1: Add to Claude Code MCP config

Add this to your Claude Code settings (~/.claude/settings.json or project .mcp.json):

{
  "mcpServers": {
    "askclaude": {
      "command": "node",
      "args": ["/path/to/askclaude-mcp/index.js"],
      "env": {
        "ASKCLAUDE_BASE_URL": "https://askclaude.shop"
      }
    }
  }
}

Option 2: Run with npx (after publishing)

{
  "mcpServers": {
    "askclaude": {
      "command": "npx",
      "args": ["askclaude-mcp"],
      "env": {
        "ASKCLAUDE_BASE_URL": "https://askclaude.shop"
      }
    }
  }
}

Option 3: Run manually

cd askclaude-mcp
npm install
node index.js

Environment Variables

How x402 Payment Works

1. You call a tool (e.g., ask_claude with prompt "What is Bitcoin?")
2. The MCP server sends the request to the AskClaude service
3. The service is gated by x402 — it requires USDC payment on Base network
4. If payment is configured (via x402 client wallet), it's handled automatically
5. The AI response is returned as the tool result

For the payment flow to work end-to-end, the AskClaude service handles x402 negotiation. Users interact with the service through this MCP layer — the x402 payment middleware on the server side validates payments before processing requests.

Usage Examples

Once configured in Claude Code, you can use natural language:

• "Use askclaude to ask opus: what are the implications of quantum computing on cryptography?"
• "Summarize this article using askclaude"
• "Review this Python code with askclaude"
• "Translate 'hello world' to Japanese using askclaude"
• "What's the sentiment of this tweet? Use askclaude"
• "Get crypto analysis for ethereum using askclaude"

Development

# Install dependencies
npm install

# Test locally (stdio mode)
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}' | node index.js

# Point to local service
ASKCLAUDE_BASE_URL=http://localhost:4021 node index.js

Architecture

Claude Code  --(MCP/stdio)-->  askclaude-mcp  --(HTTP/x402)-->  AskClaude Service
   (user)                      (this package)                   (askclaude.shop)
                                                                     |
                                                              Claude API (Anthropic)
                                                              CoinGecko (prices)

License

MIT

Author

@pvega23