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 分