A-Pay Protocol

Universal HTTP 402 Micropayment Protocol & Autonomous Economic Settlement Engine for AI Agents

Should I use this

Quality & Safety

A
Description quality
92%
Schema completeness
81%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~467Tokens (tool definitions)
~654 BTypical response size
Minimal attention impact (0.36% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "apay": {
      "command": "uvx",
      "args": [
        "apay"
      ]
    }
  }
}

Runnable packages

pypiapay0.1.8stdio

Remote endpoints

https://apay-network.vercel.app/api/mcpstreamable-http

What it can do

Tool inventory

Tools (5)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
⚪apay_request(url, method, json_body, headers)

Probe and automatically pay HTTP 402 crypto micropayments on Base Layer 2 with USDC or $APAY within pre-configured budget limits.

Input Schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The target endpoint URL"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "POST",
        "PUT",
        "DELETE"
      ],
      "default": "GET"
    },
    "json_body": {
      "type": "object",
      "description": "Optional JSON request body"
    },
    "headers": {
      "type": "object",
      "description": "Optional additional HTTP headers"
    }
  },
  "required": [
    "url"
  ]
}
🟢apay_get_wallet_status

Inspect the agent's active non-custodial wallet address, network, current spending guardrails, and total spent in USDC and $APAY.

Input Schema

{
  "type": "object",
  "properties": {}
}
🟡apay_set_budget(max_per_call_usdc, daily_budget_usdc, max_per_call_apay, daily_budget_apay)

Configure agent safety invariants and spending guardrails. Prevents runaway loops or overcharging.

Input Schema

{
  "type": "object",
  "properties": {
    "max_per_call_usdc": {
      "type": "number",
      "description": "Maximum USDC allowance for a single API call"
    },
    "daily_budget_usdc": {
      "type": "number",
      "description": "Maximum USDC rolling 24-hour spending budget"
    },
    "max_per_call_apay": {
      "type": "number",
      "description": "Maximum $APAY token allowance for a single API call"
    },
    "daily_budget_apay": {
      "type": "number",
      "description": "Maximum $APAY token rolling 24-hour spending budget"
    }
  }
}
🟢apay_inspect_endpoint(url)

Inspect an endpoint to check if it requires an A-Pay micropayment, inspect the exact price quote, currency, and payout receiver without spending any funds.

Input Schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The URL to probe for HTTP 402 payment requirements"
    }
  },
  "required": [
    "url"
  ]
}
🟢apay_get_balance(address)

Inspect the agent's live on-chain balances on Base Layer 2, including native ETH (for gas), USDC, and $APAY tokens.

Input Schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Optional target EVM address to inspect balances for"
    }
  }
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded5 tools