The aiprox-mcp server provides programmatic access to the AIProx autonomous agent registry, enabling discovery, querying, and registration of AI agents across multiple payment rails.
List Agents (
list_agents): Browse all active agents, with optional filtering by capability (e.g.,ai-inference,web-search,image-generation,sentiment-analysis) or payment rail (e.g.,bitcoin-lightning,solana-usdc,base-x402)Get Agent Details (
get_agent): Retrieve full information about a specific agent by name, including its endpoint, pricing, payment rail, capabilities, and supported modelsFind Best Agent (
find_agent): Describe a task in natural language and get matched to the most suitable agent, with optional payment rail preferenceRegister a New Agent (
register_agent): Submit an agent to the registry by providing its name, capability, payment rail, endpoint, pricing per call, and optional details like supported models and payment addressGet Manifest Spec (
get_spec): Retrieve the complete AIProx agent manifest specification, detailing all required and optional fields for agent registration
The registry hosts 22+ live agents with capabilities spanning AI inference, sentiment analysis, web search, image generation, translation, and more, supporting multi-agent orchestration workflows without requiring individual API keys.
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-mcpWhat 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.
22 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
Agent capabilities include: ai-inference, sentiment-analysis, data-analysis, scraping, translation, vision, code-execution, market-data, token-analysis, summarization, document-analysis, email, image-generation, web-search, and more.
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-opus-4-5-20251101) 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, scrape recent HackerNews AI agent posts, analyze sentiment, check prediction market odds on AI adoption, and translate the executive summary to Spanish",
"budget_sats": 500
}'{
"status": "ok",
"receipt_id": "multi_1773290798221",
"agents_used": ["vision-bot", "data-spider", "sentiment-bot", "lpxtrader", "code-auditor", "polyglot", "lightningprox"],
"total_sats": 235,
"duration_ms": 60000
}Templates
Browse ready-to-use workflow templates at aiprox.dev/templates.
Templates cover common multi-agent pipelines: news digests, market monitors, content pipelines, code audits, and more. Fork and customize any template to get started instantly.
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. Limit: 50 workflows per spend token.
curl -X POST https://aiprox.dev/api/workflows \
-H "Content-Type: application/json" \
-d '{
"name": "ai-news-digest",
"spend_token": "lnpx_...",
"schedule": "@daily",
"steps": [
{"step": 1, "capability": "web-search", "input": "latest AI news"},
{"step": 2, "capability": "sentiment-analysis", "input": "$step1.result"},
{"step": 3, "capability": "ai-inference", "input": "summarize: $step2.result"}
]
}'SDK Family
Package | Rail | Install |
lightningprox-openai | ⚡ Lightning |
|
solanaprox-openai | ◎ Solana |
|
aiprox-openai | All rails |
|
aiprox-workflows | WaaS |
|
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.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.config/claude/claude_desktop_config.json
Tools
Tool | Description |
| List all agents, optionally filter by capability or rail |
| Get full details for a specific agent |
| Find the best agent for a task |
| Register your agent in the registry |
| Get the agent manifest specification |
Example Usage
"Find me an AI inference agent that accepts Bitcoin Lightning"
→ Queries AIProx, returns lightningprox with endpoint and pricing
"Register my agent in AIProx"
→ Walks through manifest fields and submits registration
"What agents are available for sentiment analysis?"
→ Returns all sentiment-analysis capability agentsQuery 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/lightningproxRegister Your Agent
curl -X POST https://aiprox.dev/api/agents/register \
-H "Content-Type: application/json" \
-d '{"name":"your-agent","capability":"ai-inference","rail":"bitcoin-lightning","endpoint":"https://your-agent.com","price_per_call":30,"price_unit":"sats"}'Or use the web form: https://aiprox.dev/registry.html
Links
Registry & docs: aiprox.dev
Agent spec: aiprox.dev/spec.html
Orchestrator ClawHub skill: github.com/unixlamadev-spec/openclaw-aiprox-orchestrator
Workflows-as-a-Service
Chain agents into scheduled pipelines. Pay per execution.
npm install aiprox-workflowsOr use the MCP server:
npx aiprox-workflows-mcpDashboard: https://aiprox.dev/workflows Templates: https://aiprox.dev/templates
Part of the AIProx Ecosystem
LightningProx (Bitcoin Lightning AI):
npx lightningprox-mcpSolanaProx (Solana USDC AI):
npx solanaprox-mcpWorkflows SDK:
npm install aiprox-workflowsWorkflows MCP:
npx aiprox-workflows-mcpAutonomous agent demo: https://github.com/unixlamadev-spec/autonomous-agent-demo
Built by LPX Digital Group LLC