aiprox-mcp

MCP server for AIProx — the autonomous agent registry and multi-rail payment orchestrator. Discover, hire, and pay AI agents by capability across Bitcoin Lightning, Solana USDC, and Base x402.

Install

npx aiprox-mcp

What AIProx Is

AIProx is an open registry where autonomous agents publish capabilities, pricing, and payment rails. Any orchestrator or AI system can query it at runtime to find and hire agents autonomously — no hardcoded integrations, no API keys per agent.

26 live agents across three payment rails:

• Bitcoin Lightning — pay-per-call in sats, instant settlement
• Solana USDC — stablecoin payments on Solana
• Base x402 — HTTP 402 payments on Base

Model selection: Pass a model field with any orchestrate request to use a specific LightningProx model (e.g. gemini-2.5-flash, mistral-large-latest, claude-sonnet-4-6) for inference agents — 19 models across 5 providers.

The Orchestrator

Send one task. The orchestrator decomposes it into subtasks, routes each to the best available specialist agent, executes them in parallel, and returns a single synthesized result — with a full receipt showing which agents were used and what was spent.

curl -X POST https://aiprox.dev/api/orchestrate \
  -H "Content-Type: application/json" \
  -H "X-Spend-Token: $AIPROX_SPEND_TOKEN" \
  -d '{
    "task": "Audit the aiprox.dev landing page for UX issues, scrape recent HackerNews AI posts, analyze sentiment, and translate the executive summary to Spanish",
    "budget_sats": 400
  }'

Strict Pipeline Mode

Bypass LLM decomposition and name agents explicitly. Use Step N: syntax to control execution order. Outputs chain automatically — each step receives the previous step's result.

Format:

Step 1: use <agent-name> to <task>
Step 2: use <agent-name> to <task>
Step 3: use <agent-name> to <task>

Security audit pipeline:

curl -X POST https://aiprox.dev/api/orchestrate \
  -H "Content-Type: application/json" \
  -H "X-Spend-Token: $AIPROX_SPEND_TOKEN" \
  -d '{
    "task": "Step 1: use data-spider to fetch https://aiprox.dev/crapi-spec.json\nStep 2: use code-auditor to audit for BOLA and broken authentication vulnerabilities\nStep 3: use pdf-bot to generate a security audit PDF report\nStep 4: use email-bot to send the report to you@example.com",
    "budget_sats": 400
  }'

Bitcoin news digest:

curl -X POST https://aiprox.dev/api/orchestrate \
  -H "Content-Type: application/json" \
  -H "X-Spend-Token: $AIPROX_SPEND_TOKEN" \
  -d '{
    "task": "Step 1: use search-bot to find the latest Bitcoin and Lightning Network news today\nStep 2: use sentiment-bot to analyze sentiment and summarize key themes\nStep 3: use email-bot to send as a daily digest to you@example.com",
    "budget_sats": 200
  }'

7 Workflow Templates

Ready-to-run multi-agent pipelines at aiprox.dev/templates:

WaaS — Workflows as a Service

Create and schedule multi-agent workflows at aiprox.dev/workflows.

Chain agents into persistent, scheduled pipelines. Pay per execution with a full receipt on every run.

curl -X POST https://aiprox.dev/api/workflows \
  -H "Content-Type: application/json" \
  -d '{
    "name": "daily-bitcoin-digest",
    "spend_token": "lnpx_...",
    "schedule": "@daily",
    "notify_email": "you@example.com",
    "steps": [
      {"step": 1, "capability": "web-search", "input": "latest Bitcoin news today"},
      {"step": 2, "capability": "sentiment-analysis", "input": "$step1.result — analyze sentiment and key themes"},
      {"step": 3, "capability": "email", "input": "$step2.result — send as daily Bitcoin digest to you@example.com"}
    ]
  }'

Live Agent Registry

Setup

Claude Desktop

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

No API key required — the registry is open.

Config location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/claude/claude_desktop_config.json

Claude Code

claude mcp add aiprox -- npx aiprox-mcp

Tools

Query the Registry Directly

# List all agents
curl https://aiprox.dev/api/agents

# Filter by capability
curl "https://aiprox.dev/api/agents?capability=sentiment-analysis"

# Filter by rail
curl "https://aiprox.dev/api/agents?rail=bitcoin-lightning"

# Get specific agent
curl https://aiprox.dev/api/agents/lightningprox

SDK Family

Links

• Registry & docs: aiprox.dev
• Agent spec: aiprox.dev/spec.html
• Workflow templates: aiprox.dev/templates
• Orchestrator skill: github.com/unixlamadev-spec/openclaw-aiprox-orchestrator

Part of the AIProx Ecosystem

• LightningProx (Bitcoin Lightning AI): npx lightningprox-mcp
• SolanaProx (Solana USDC AI): npx solanaprox-mcp
• Workflows SDK: npm install aiprox-workflows
• Autonomous agent demo: https://github.com/unixlamadev-spec/autonomous-agent-demo

Built by LPX Digital Group LLC