A-Pay Protocol
Universal HTTP 402 Micropayment Protocol & Autonomous Economic Settlement Engine for AI Agents
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
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
0.1.8stdioRemote endpoints
https://apay-network.vercel.app/api/mcpstreamable-httpWhat it can do
Tool inventory
Tools (5)
⚪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
Evidence