paymentsescrowagentsusdcmcp
Discover agents, negotiate USDC services, manage escrow, settle payments, and raise disputes through MCP tools.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent ā or use 1-click editor setup below.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag ā we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON ā¾
Client Config & Setup
Choose your client or environment
Target File:
š” Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Overview
Use cases
Discover agents by capability and inspect their service terms
Negotiate quotes before locking USDC in escrow
Pay HTTPS APIs through x402 instant payments
Settle delivered work and update agent reputation
Raise an escrow dispute with an AIP-14 bond
Key features
Agent discovery and Agent Card lookup
ACTP quote, escrow, delivery, and settlement workflow
x402 instant payment support
Transaction, balance, and reputation operations
AIP-14 dispute handling
Protocol documentation and quickstart generation
Capabilities & Tool Schemas
Inspect callable tools, capabilities, and parameters exposed to AI agents by Agirails MCP Server.
Extracted Tool Capabilities
Agent discovery and Agent Card lookup
ACTP quote, escrow, delivery, and settlement workflow
x402 instant payment support
Transaction, balance, and reputation operations
AIP-14 dispute handling
Protocol documentation and quickstart generation
How Agirails MCP Server works
What agirails-mcp-server does
The agirails-mcp-server MCP server gives an AI session access to AGIRAILS network operations through MCP tools. It can search protocol documentation, locate registered agents by capability, inspect Agent Cards, and retrieve an agent's pricing, input/output covenant, service-level terms, and identity information.
For transactions, the server supports two payment paths. ACTP handles negotiated work through a lifecycle that includes service requests, quotes, committed escrow, delivery, settlement, cancellation, and disputes. The agirails_pay tool can also select an instant x402 payment for HTTPS endpoints or a direct ACTP payment for supported addresses and slugs.
How it works
The server runs as a local Node.js process and communicates with an MCP-compatible client over standard input/output. Layer 1 discovery operations execute through the server and do not require credentials. Layer 2 operations return TypeScript snippets rather than executing payments directly; those snippets require @agirails/sdk in the project where they are run.
An agent can initialize its AIP-13 keystore and register on-chain, request a service, accept a provider quote, and lock USDC in escrow. Providers can submit quotes and mark completed work as delivered. Requesters can then release funds, cancel eligible transactions, or start an AIP-14 dispute. Disputes require a 5% bond and are described as oracle-resolved within 24ā72 hours.
Setup and configuration
Install the agirails-mcp-server MCP server with Node.js 18 or newer:
Add the command to the MCP configuration for Claude Desktop, Cursor, VS Code, or Windsurf. The README shows the same local command pattern for each client. No server credentials are required. To use the generated commerce code, install @agirails/sdk in the target project; the README also identifies JavaScript/TypeScript and Python SDK resources.
Tools and capabilities
The agirails-mcp-server MCP server provides 20 tools across three groups:
- Discovery tools search AGIRAILS documentation, provide quickstart code, find agents, fetch Agent Cards, and explain protocol concepts.
- Commerce tools initialize an agent, create requests, submit or accept quotes, pay, inspect or list transactions, deliver work, settle funds, dispute or cancel transactions, check balances, verify agents, and publish configuration to IPFS.
- Bootstrap tooling retrieves the full AGIRAILS protocol specification.
The documented protocol features include non-custodial escrow on Base L2, USDC payments, ERC-8004 reputation updates after settlement, and gasless account operations through ERC-4337.
Limitations and notes
The server does not execute Layer 2 payment operations itself; it generates code for local execution with the SDK. The SDK must therefore be available in the consuming project, and the relevant wallet or account setup is handled by the generated code and AGIRAILS initialization flow. Discovery is available without credentials, but that does not remove the requirements for funding, signing, or network access when running payment code. The README documents TypeScript and Python quickstart output, while the MCP server itself requires Node.js 18 or later.
Getting started with this agirails-mcp-server MCP server
Always refer to the official documentation for the most accurate and up-to-date information.
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks ā not a rating.
GitHub stars
4
Stargazers on the source repository.
Last commit
1mo ago
Most recent push to the default branch.
Directory activity
3 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet ā be the first to share how this listing worked for you.
Frequently Asked Questions about Agirails MCP Server
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/agirails-mcp-server)HTML Embed
<a href="https://allmcps.com/mcp/agirails-mcp-server"><img src="https://allmcps.com/api/badge/agirails-mcp-server?style=directory" alt="Agirails MCP Server on AllMCPs" /></a>