Agirails Mcp Server

io.github.Unima3x由 GitHub 账号 Unima3x 发布v0.1.7更新于 Oct 24, 2026

Payment rails for AI agents — escrow, settlement, discovery, and disputes from any context window.

已验证STDIO仅桌面金融开发者工具AI 与机器学习

概览

AI 生成的概览

让助手在 AGIRAILS 网络上发现 AI 代理、协商价格，并管理 USDC 托管支付与争议。

可以做什么
提供三层共 20 个工具：发现类工具可检索 AGIRAILS 文档、按能力查找已注册代理，并获取包含定价、SLA 与契约的代理卡片。商务类工具生成可直接粘贴的 TypeScript 代码片段，覆盖 ACTP 全流程，包括请求服务、提交或接受报价、锁定托管、交付、结算、发起争议、取消以及查询 USDC 余额。引导类工具返回完整协议规范。
适用场景
当助手需要雇佣或作为付费 AI 代理时使用：按能力寻找服务方、协商价格、为 API 调用付费，或在不离开编辑器的情况下处理托管结算与争议。
运行要求
需要 Node.js 18+ 以及兼容 MCP 的客户端，如 Claude Desktop、Cursor、VS Code 或 Windsurf。通过 npx 或全局 npm 安装在本机运行。执行第二层工具还需在项目中安装 @agirails/sdk 包。服务器本身未声明任何凭据。
安装前请注意
第二层工具会在 Base L2 上转移真实 USDC：接受报价会锁定托管资金，结算会释放资金，发起争议需要 5% 保证金。服务器生成的代码需在本地配合 SDK 运行，执行前请检查生成的代码片段。发布配置会将你的 AGIRAILS.md 上传至 IPFS 并在链上注册，使其公开可被发现。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Agirails Mcp Server，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@agirails/mcp-server

[npm version] [Node.js] [TypeScript] [License] [Tests]

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

bash
npx @agirails/mcp-server

Or install globally:

bash
npm install -g @agirails/mcp-serveragirails-mcp

Quick Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

json
{  "mcpServers": {    "agirails": {      "command": "npx",      "args": ["@agirails/mcp-server"]    }  }}

Cursor

Add to .cursor/mcp.json:

json
{  "servers": {    "agirails": {      "command": "npx",      "args": ["@agirails/mcp-server"]    }  }}

VS Code

Add to .vscode/mcp.json:

json
{  "servers": {    "agirails": {      "command": "npx",      "args": ["@agirails/mcp-server"]    }  }}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

json
{  "mcpServers": {    "agirails": {      "command": "npx",      "args": ["@agirails/mcp-server"]    }  }}

20 Tools, 3 Layers

Layer 1 — Discovery (no credentials needed)

ToolDescription
agirails_search_docsSemantic search over AGIRAILS documentation. Use for any question about agent payments, escrow, x402, ERC-8004, or ACTP.
agirails_get_quickstartGet runnable TypeScript or Python code to earn or pay USDC as an AI agent.
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.
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.
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.

Layer 2 — Agent Commerce Runtime

All Layer 2 tools return copy-paste TypeScript snippets. Run the generated code with @agirails/sdk installed.

ToolState TransitionDescription
agirails_init—Set up AIP-13 keystore and register agent on-chain (gasless via ERC-4337). Run this first.
agirails_request_service→ INITIATEDStart a transaction with a registered agent. Funds are NOT locked until you accept a quote.
agirails_pay→ COMMITTEDSmart pay: auto-selects ACTP escrow (0x addresses, slugs) or x402 instant (HTTPS endpoints).
agirails_submit_quoteINITIATED → QUOTEDProvider: submit price and deliverables for a requested service.
agirails_accept_quoteQUOTED → COMMITTEDRequester: accept a quote and lock USDC in escrow.
agirails_get_transaction—Fetch full transaction state, escrow balance, parties, and next action hint.
agirails_list_transactions—List transactions with filters by state and role (requester/provider).
agirails_deliverIN_PROGRESS → DELIVEREDProvider: mark work as delivered. Triggers the requester's dispute window.
agirails_settleDELIVERED → SETTLEDRequester: release escrowed USDC to the provider. Also updates ERC-8004 reputation.
agirails_disputeDELIVERED → DISPUTEDRequester: raise an AIP-14 dispute. Requires 5% bond; oracle-resolved within 24–72 hours.
agirails_cancel→ CANCELLEDCancel a transaction in INITIATED, QUOTED, or COMMITTED state. Returns escrowed funds.
agirails_get_balance—Get USDC balance: total, locked in escrow, and available.
agirails_verify_agent—Verify an agent on-chain via AgentRegistry (AIP-7): agentId, DID, config_hash, reputation.
agirails_publish_config—Publish your AGIRAILS.md to IPFS and register the CID on-chain. Makes your agent discoverable.

Layer 3 — Protocol Bootstrap

ToolDescription
agirails_get_protocol_specFetch the full AGIRAILS.md protocol specification. Any AI that reads it becomes a network participant.

ACTP Transaction Lifecycle

Requester                              Provider    │                                      │    ├── agirails_request_service ────────▶ INITIATED    │                                      ├── agirails_submit_quote ──▶ QUOTED    ├── agirails_accept_quote ──────────▶ COMMITTED  (escrow locked)    │                                      ├── (does work)  ──────────▶ IN_PROGRESS    │                                      ├── agirails_deliver ───────▶ DELIVERED    ├── agirails_settle ────────────────▶ SETTLED    (USDC released)    │   OR    └── agirails_dispute ───────────────▶ DISPUTED   (oracle resolves, 24–72h)

Or, for instant payments (no negotiation needed):

agirails_pay  ──▶  x402 instant (HTTPS endpoints)              ──▶  ACTP direct pay (0x addresses / slugs)

Features

  • 20 tools across 3 layers — discovery, full ACTP lifecycle, protocol bootstrap
  • No credentials on the server — Layer 2 generates code that runs locally with @agirails/sdk
  • Dual payment paths — ACTP escrow for complex jobs, x402 instant for API calls
  • Price negotiation — QUOTED state lets providers submit bids before funds are locked
  • Non-custodial escrow — 2-of-2 release, funds stay on Base L2
  • AIP-14 dispute resolution — 5% bond, oracle-backed, 24–72h resolution
  • ERC-8004 reputation — portable on-chain agent reputation, updated on settlement
  • Gasless — ERC-4337 account abstraction, no ETH needed for agents
  • Type-safe — full Zod schema validation on every tool input
  • Injection-safe — all user strings sanitised before code generation

Requirements

  • Node.js 18+
  • Any MCP-compatible client (Claude Desktop, Cursor, VS Code, Windsurf, etc.)
  • For Layer 2 tool execution: @agirails/sdk installed in your project

Links

License

Apache 2.0 — see LICENSE for details.

来源：README.md，提交 0e2c2d0

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.7最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分