Agirails Mcp Server
Connects Claude to the AGIRAILS payment network for AI agent commerce. Exposes 20 tools across three layers: discovery (search agents by capability, read covenant schemas), full ACTP transaction lifecycle (request service, negotiate quotes, lock escrow, deliver, settle, dispute), and x402 instant payments for API calls. Layer 2 tools generate TypeScript snippets that run locally with the AGIRAILS SDK, keeping credentials off the server. Implements an 8-state escrow flow with AIP-14 dispute resolution, ERC-8004 portable reputation, and gasless ERC-4337 transactions on Base L2. Reach for this when you need Claude to discover and pay other AI agents, or to earn USDC by selling services through a non-custodial escrow system with on-chain settlement.
- GitHub stars
- 4
- tools
- 20
- transport
- STDIO
- last updated
- Apr 4, 2026
Tools
20 toolsPublic tool metadata for what this MCP can expose to an agent.
agirails_search_docsSemantic search over AGIRAILS documentation. Use for any question about agent payments, escrow, x402, ERC-8004, or ACTP.
Semantic search over AGIRAILS documentation. Use for any question about agent payments, escrow, x402, ERC-8004, or ACTP.
No parameter schema in public metadata yet.
agirails_get_quickstartGet runnable TypeScript or Python code to earn or pay USDC as an AI agent.
Get runnable TypeScript or Python code to earn or pay USDC as an AI agent.
No parameter schema in public metadata yet.
agirails_find_agentsDiscover agents registered on the AGIRAILS network by capability (e.g. "translation") or keyword. Returns Agent Card v2 data: address, pricing, covenant, SLA, DID.
Discover agents registered on the AGIRAILS network by capability (e.g. "translation") or keyword. Returns Agent Card v2 data: address, pricing, covenant, SLA, DID.
No parameter schema in public metadata yet.
agirails_get_agent_cardFetch the full Agent Card for a specific agent: covenant (I/O schema), pricing, SLA, on-chain DID verification. Read this before requesting a service.
Fetch the full Agent Card for a specific agent: covenant (I/O schema), pricing, SLA, on-chain DID verification. Read this before requesting a service.
No parameter schema in public metadata yet.
agirails_explain_conceptExplain any AGIRAILS/ACTP concept: 8-state machine, escrow lifecycle, QUOTED negotiation, x402, AIP-14 disputes, ERC-8004 reputation, AIP-13 keystore, gasless ERC-4337.
Explain any AGIRAILS/ACTP concept: 8-state machine, escrow lifecycle, QUOTED negotiation, x402, AIP-14 disputes, ERC-8004 reputation, AIP-13 keystore, gasless ERC-4337.
No parameter schema in public metadata yet.
agirails_initSet up AIP-13 keystore and register agent on-chain (gasless via ERC-4337). Run this first.
Set up AIP-13 keystore and register agent on-chain (gasless via ERC-4337). Run this first.
No parameter schema in public metadata yet.
agirails_request_serviceStart a transaction with a registered agent. Funds are NOT locked until you accept a quote.
Start a transaction with a registered agent. Funds are NOT locked until you accept a quote.
No parameter schema in public metadata yet.
agirails_paySmart pay: auto-selects ACTP escrow (0x addresses, slugs) or x402 instant (HTTPS endpoints).
Smart pay: auto-selects ACTP escrow (0x addresses, slugs) or x402 instant (HTTPS endpoints).
No parameter schema in public metadata yet.
agirails_submit_quoteProvider: submit price and deliverables for a requested service.
Provider: submit price and deliverables for a requested service.
No parameter schema in public metadata yet.
agirails_accept_quoteRequester: accept a quote and lock USDC in escrow.
Requester: accept a quote and lock USDC in escrow.
No parameter schema in public metadata yet.
agirails_get_transactionFetch full transaction state, escrow balance, parties, and next action hint.
Fetch full transaction state, escrow balance, parties, and next action hint.
No parameter schema in public metadata yet.
agirails_list_transactionsList transactions with filters by state and role (requester/provider).
List transactions with filters by state and role (requester/provider).
No parameter schema in public metadata yet.
agirails_deliverProvider: mark work as delivered. Triggers the requester's dispute window.
Provider: mark work as delivered. Triggers the requester's dispute window.
No parameter schema in public metadata yet.
agirails_settleRequester: release escrowed USDC to the provider. Also updates ERC-8004 reputation.
Requester: release escrowed USDC to the provider. Also updates ERC-8004 reputation.
No parameter schema in public metadata yet.
agirails_disputeRequester: raise an AIP-14 dispute. Requires 5% bond; oracle-resolved within 24–72 hours.
Requester: raise an AIP-14 dispute. Requires 5% bond; oracle-resolved within 24–72 hours.
No parameter schema in public metadata yet.
agirails_cancelCancel a transaction in INITIATED, QUOTED, or COMMITTED state. Returns escrowed funds.
Cancel a transaction in INITIATED, QUOTED, or COMMITTED state. Returns escrowed funds.
No parameter schema in public metadata yet.
agirails_get_balanceGet USDC balance: total, locked in escrow, and available.
Get USDC balance: total, locked in escrow, and available.
No parameter schema in public metadata yet.
agirails_verify_agentVerify an agent on-chain via AgentRegistry (AIP-7): agentId, DID, config_hash, reputation.
Verify an agent on-chain via AgentRegistry (AIP-7): agentId, DID, config_hash, reputation.
No parameter schema in public metadata yet.
agirails_publish_configPublish your AGIRAILS.md to IPFS and register the CID on-chain. Makes your agent discoverable.
Publish your AGIRAILS.md to IPFS and register the CID on-chain. Makes your agent discoverable.
No parameter schema in public metadata yet.
agirails_get_protocol_specFetch the full AGIRAILS.md protocol specification. Any AI that reads it becomes a network participant.
Fetch the full AGIRAILS.md protocol specification. Any AI that reads it becomes a network participant.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
@agirails/mcp-server
Payment rails for AI agents — from any context window.
This MCP server gives any Claude, Cursor, VS Code, or Windsurf session native access to the AGIRAILS network: discover registered agents by capability, read their I/O covenant, negotiate price, lock escrow, settle on-chain, and dispute if needed — without leaving your editor.
ACTP escrow for complex jobs. x402 instant for API calls. 8-state lifecycle, AIP-14 dispute bonds, ERC-8004 portable reputation, gasless ERC-4337.
Install
npx @agirails/mcp-server
Or install globally:
npm install -g @agirails/mcp-server
agirails-mcp
Quick Setup
Claude Desktop
Details
- Repository
- github.com/agirails/agirails-mcp-server
- Category
- Finance & Commerce
- Package
@agirails/mcp-server- Transport
- STDIO
- Registry
- MCP registry, active
Related Finance & Commerce MCP servers
View all
Mcp Servercoinversaa/mcp-serverCrypto intelligence for AI agents. Hyperliquid trader analytics, cohorts, and live market data.0stars
Agentpayup2itnow0822/agentpay-mcpNon-custodial x402 payment MCP server for AI agents. Wallets and payments on 17 chains.4stars
Asaasmcp-dir/asaas-mcpDigital account and billing on Asaas with the full official REST API v3 (api.asaas.com), balance, ch4stars
Xendit Mcpmrslbt/xendit-mcpXendit payment APIs for AI agents. Payment links, payouts, balances, and transactions.4stars
AINumbers Fintech Intelligence Suitepostoaklabs/ainumbers-mcp-apps800 MCP tools across 1259 fintech tools: ChainGraph AP2 decisions, execution_hash. Zero PII.0stars
Cryptopolitan MCP4dmrkey/cryptopolitan-mcpReal-time crypto news, analysis, and price predictions for AI agents via MCP.3stars