API Reference

Consensus Intelligence

Query multiple AI models simultaneously. Returns a synthesized consensus answer with confidence scores.

Request Body

{
  "query": "What factors drive AI startup valuations?",
  "models": ["claude", "gpt", "gemini", "deepseek", "grok"],
  "domain": "finance"
}

Response

{
  "consensus": "The key factors driving AI startup valuations include...",
  "confidence": 0.89,
  "agreementRate": 0.8,
  "models": [
    { "name": "gpt", "weight": 1.0, "latencyMs": 3200 },
    { "name": "gemini", "weight": 0.7, "latencyMs": 1500 },
    { "name": "deepseek", "weight": 0.6, "latencyMs": 6800 }
  ],
  "meta": {
    "domain": "finance",
    "modelsQueried": 4,
    "modelsResponded": 3,
    "totalTokens": 861,
    "latencyMs": 8874
  }
}

Register Agent

Register a new AI agent on the trust network. Returns cryptographic identity keys and initial trust profile.

Request Body

{
  "name": "my-shopping-agent",
  "description": "E-commerce purchasing agent",
  "permissions": {
    "maxSpend": 500,
    "allowedActions": ["purchase", "search", "compare"],
    "blockedMerchants": ["gambling", "adult"]
  }
}

Response

{
  "agent": {
    "id": "cmlx...",
    "name": "my-shopping-agent",
    "publicKey": "mpai_5161d560...",
    "trustScore": 50,
    "status": "ACTIVE",
    "permissions": {
      "maxDailySpend": 500,
      "allowedActions": ["purchase", "search", "compare"]
    }
  },
  "credentials": {
    "agentSecret": "mpsk_4e80f875...",
    "publicKey": "mpai_5161d560...",
    "warning": "Save the agentSecret now. It cannot be retrieved again."
  }
}

Verify Agent

Check an agent's trust status before accepting a transaction. Sub-200ms response time.

Response

{
  "verified": true,
  "trusted": true,
  "agent": {
    "id": "cmlx...",
    "name": "my-shopping-agent",
    "trustScore": 72.5,
    "status": "ACTIVE",
    "totalActions": 156,
    "successRate": 97.4
  },
  "permissions": {
    "maxDailySpend": 500,
    "allowedActions": ["purchase", "search", "compare"],
    "canSpend": true
  },
  "meta": { "responseMs": 118 }
}

Browse Skills Marketplace

Search and browse agent skills. Filter by category, search keyword, sort by popularity/rating/price. No auth required.

Response

{
  "skills": [
    {
      "id": "cmlx...",
      "name": "Financial Due Diligence Agent",
      "slug": "financial-due-diligence",
      "description": "AI agent that performs comprehensive financial analysis...",
      "category": "FINANCE",
      "tags": ["finance", "due-diligence", "sec"],
      "priceType": "PER_CALL",
      "priceCents": 500,
      "totalCalls": 12847,
      "avgRating": 4.7,
      "reviewCount": 89,
      "featured": true
    }
  ],
  "pagination": { "page": 1, "limit": 10, "total": 3, "totalPages": 1 }
}

Purchase Skill

Purchase a skill from the marketplace. 20% platform fee, 80% to the seller. Returns integration details.

Response

{
  "purchase": {
    "id": "cmlx...",
    "skillName": "Financial Due Diligence Agent",
    "pricePaidCents": 500,
    "platformFeeCents": 100,
    "status": "ACTIVE"
  },
  "integration": {
    "endpointUrl": "https://...",
    "inputSchema": { "type": "object", "properties": { "ticker": { "type": "string" } } }
  }
}

Execute Skill

Call a skill through MultiPowerAI. Requires purchase for paid skills. Routes to skill endpoint and tracks usage.

Request Body

{
  "input": { "ticker": "NVDA", "depth": "deep" }
}

Response

{
  "result": { "analysis": "NVIDIA shows strong revenue growth..." },
  "meta": {
    "skillId": "cmlx...",
    "skillName": "Financial Due Diligence Agent",
    "version": "1.0.0",
    "executionMs": 2340,
    "totalMs": 2412,
    "billed": true,
    "costCents": 500
  }
}

Publish Skill

Publish a new skill to the marketplace. You earn 80% of every purchase.

Request Body

{
  "name": "My Custom Agent Skill",
  "description": "Does amazing things",
  "category": "CODING",
  "tags": ["coding", "automation"],
  "priceType": "PER_CALL",
  "priceCents": 100,
  "endpointUrl": "https://my-skill.example.com/execute",
  "inputSchema": { "type": "object", "properties": { "code": { "type": "string" } } }
}

Response

{
  "skill": {
    "id": "cmlx...",
    "name": "My Custom Agent Skill",
    "slug": "my-custom-agent-skill",
    "status": "PUBLISHED"
  },
  "url": "https://multipowerai.com/marketplace/my-custom-agent-skill"
}

Agent-to-Agent Transaction

One agent autonomously hires another agent's skill. Checks permissions, wallet balance, executes the skill, and records the transaction. The core of agent commerce.

Request Body

{
  "targetAgentId": "cmlx...",
  "skillSlug": "financial-due-diligence",
  "input": { "ticker": "NVDA" },
  "maxSpendCents": 1000
}

Response

{
  "transaction": {
    "id": "cmlx...",
    "status": "COMPLETED",
    "callerAgent": { "id": "...", "name": "my-agent", "trustScore": 72 },
    "skill": { "name": "Financial Due Diligence Agent", "slug": "financial-due-diligence" },
    "cost": { "totalCents": 500, "platformFeeCents": 100, "sellerPayoutCents": 400 },
    "timing": { "executionMs": 2340, "totalMs": 2500 }
  },
  "result": { "analysis": "..." }
}

Top Up Agent Wallet

Add credits to an agent's wallet for autonomous spending on skills and transactions.

Request Body

{
  "amountCents": 5000
}

Response

{
  "agent": { "id": "...", "name": "my-agent", "balanceCents": 5000, "balanceFormatted": "$50.00" },
  "topup": { "amountCents": 5000, "formatted": "$50.00" }
}

Agent Action History

Get an agent's full action history — every transaction, verification, and event. Paginated with type/status filters.

Response

{
  "agent": { "id": "...", "name": "my-agent", "trustScore": 72 },
  "actions": [
    {
      "id": "...",
      "type": "agent_transaction",
      "description": "Agent my-agent → Skill: Financial Due Diligence Agent",
      "amount": 5.00,
      "status": "COMPLETED",
      "timestamp": "2026-02-22T..."
    }
  ],
  "pagination": { "page": 1, "total": 42 }
}

Audit Trail

Full audit trail across all your agents. Filter by type, status, date range. Compliance-ready.

Response

{
  "audit": [
    {
      "agentName": "my-agent",
      "type": "agent_transaction",
      "amount": 5.00,
      "status": "COMPLETED",
      "timestamp": "2026-02-22T..."
    }
  ],
  "summary": { "totalActions": 156, "completed": 148, "denied": 6, "failed": 2 },
  "pagination": { "page": 1, "total": 156 }
}

Developer Signup

Create a developer account instantly. Returns an API key. No waitlist, no credit card.

Request Body

{ "email": "dev@company.com", "name": "Jane Dev" }

Response

{
  "developer": { "id": "...", "email": "dev@company.com", "apiKey": "mpk_...", "tier": "FREE" },
  "nextSteps": { "dashboard": "https://multipowerai.com/dashboard" }
}

Rotate API Key

Generate a new API key. Old key is invalidated immediately. Use for security rotation.

Response

{
  "developer": { "id": "...", "apiKey": "mpk_new_key_here", "tier": "PRO" },
  "warning": "Save this key immediately. It cannot be retrieved again."
}

Register Webhook

Register a URL to receive real-time event notifications (transactions, trust changes, purchases). HMAC-SHA256 signed.

Request Body

{ "url": "https://yourapp.com/webhooks/mpai" }

Response

{
  "webhook": { "url": "https://...", "secret": "whsec_..." },
  "events": ["agent.transaction.completed", "agent.trust.updated", "skill.purchased"]
}

Platform Stats

Public platform metrics — developers, agents, skills, revenue, transaction counts. Investor-ready.

Response

{
  "metrics": { "developers": 42, "agents": 15, "skills": 12, "totalSkillCalls": 217000 },
  "agentNetwork": { "avgTrustScore": 68.5, "transactions": { "completed": 148, "denied": 6 } },
  "infrastructure": { "apiEndpoints": 26, "mcpTools": 10, "aiModels": 5 }
}

MCP Tool Manifest

MCP server discovery endpoint. Returns all 10 tools with schemas, endpoints, and auth requirements. Point any LLM agent here.

Response

{
  "name": "multipowerai-mcp",
  "tools": [ { "name": "mpai_verify_agent", "endpoint": "..." }, "...9 more" ],
  "pricing": { "free": { "rateLimit": "10/min" }, "pro": { "price": "$49/mo" } }
}

Create Checkout Session

Create a Stripe Checkout session for Pro plan subscription. Provide email to auto-create account, or apiKey for existing developers. Redirects to Stripe-hosted checkout.

Request Body

{ "email": "dev@company.com" }
// OR
{ "apiKey": "mpk_your_key" }

Response

{ "url": "https://checkout.stripe.com/c/pay/cs_...", "apiKey": "mpk_..." }

Customer Portal

Open Stripe Customer Portal for subscription management — update payment method, cancel, view invoices.

Request Body

{ "apiKey": "mpk_your_key" }

Response

{ "url": "https://billing.stripe.com/p/session/..." }

Subscription Status

Check current subscription status, billing period, and plan details for a developer account.

Request Body

{ "apiKey": "mpk_your_key" }

Response

{
  "tier": "PRO",
  "subscription": {
    "status": "active",
    "currentPeriodEnd": "2026-03-22T00:00:00Z",
    "cancelAtPeriodEnd": false,
    "plan": { "amount": 49, "currency": "usd", "interval": "month" }
  }
}

Crypto Wallet Topup

Create a Coinbase Commerce charge to fund an agent wallet with USDC or other crypto. Returns a hosted checkout URL where users pay with BTC, ETH, USDC, SOL, etc.

Request Body

{ "amountUsd": 50 }

Response

{
  "charge": {
    "id": "abc123",
    "code": "MPAI-XYZ",
    "hostedUrl": "https://commerce.coinbase.com/charges/MPAI-XYZ",
    "amount": "$50.00",
    "supportedCurrencies": ["BTC", "ETH", "USDC", "DAI"]
  },
  "agent": { "id": "...", "name": "my-agent", "currentBalanceCents": 5000 }
}

Crypto Payment Status

Check if crypto payments are enabled, supported currencies, networks, and fee structure.

Response

{
  "crypto": {
    "enabled": true,
    "provider": "Coinbase Commerce",
    "supportedCurrencies": ["BTC", "ETH", "USDC", "DAI", "USDT", "MATIC", "SOL"],
    "networks": ["Base", "Ethereum", "Polygon", "Solana", "Bitcoin"]
  }
}