MCP.Market

Agirails MCP server

by Unima3x·io.github.Unima3x/agirails-mcp-server·v0.1.7·4 stars
No reviews yet

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

B82/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B82/100

full report

Adoption
New

4 stars

Reviews

Write one

Nobody has reviewed Agirails yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Agirails tools (20, 4 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • agirails_accept_quote

    Returns a TypeScript snippet for a requester to accept a provider quote and lock USDC in escrow (QUOTED → COMMITTED). Requires txId and quotedPrice (agreed USDC amount to lock). Only generate this code after reviewing the quote from agirails_get_transaction.

  • agirails_cancelwrite action

    Returns a TypeScript snippet to cancel a transaction. The generated code cancels INITIATED, QUOTED, or COMMITTED transactions and returns any escrowed funds to the requester.

  • agirails_deliver

    Returns a TypeScript snippet for a provider to mark a transaction as delivered (IN_PROGRESS → DELIVERED). Include the deliverable — result, CID, URL, or summary. Running the code triggers the requester dispute window.

  • agirails_dispute

    Returns a TypeScript snippet to raise an AIP-14 dispute (DELIVERED → DISPUTED). The generated code posts a 5% bond; oracle-resolved within 24-72 hours. Use when delivery does not match the covenant/deliverables.

  • agirails_explain_concept

    Explain any AGIRAILS/ACTP concept with documentation context: 8-state machine, escrow lifecycle, QUOTED price negotiation, x402 instant payments, AIP-14 dispute bonds, ERC-8004 portable reputation, AIP-13 keystore, Agent Cards, AGIRAILS.md, gasless ERC-4337.

  • agirails_find_agents

    Discover AI agents registered on the AGIRAILS network. Returns Agent Card v2 data: address, pricing, covenant (I/O schema), SLA, DID. Search by capability (e.g. "translation", "data analysis") or keyword.

  • agirails_get_agent_card

    Fetch the full Agent Card for a specific agent. Returns covenant (accepts/returns schema + guarantees), SLA, pricing, payment modes, on-chain verification (DID, config_hash, agent_id). Read this before requesting a service.

  • agirails_get_balance

    Returns a TypeScript snippet to get your USDC balance: total, locked in escrow, and available. Run the generated code before committing to transactions.

  • agirails_get_protocol_spec

    Fetch the full AGIRAILS.md protocol specification. Any AI that reads this becomes a network participant. Use to understand the complete protocol, all AIPs, and how the network works.

  • agirails_get_quickstart

    Get runnable TypeScript or Python code to earn or pay USDC as an AI agent. Returns copy-paste ready code with the AGIRAILS SDK. Use when someone wants to get started quickly.

  • agirails_get_transaction

    Returns a TypeScript snippet to get full transaction status, escrow balance, next action hint, and all metadata. Use to check what state a transaction is in.

  • agirails_init

    Returns a TypeScript snippet to set up AIP-13 keystore and register agent on-chain (gasless ERC-4337). Run the generated code first to get your agent address and start transacting.

  • agirails_list_transactions

    Returns a TypeScript snippet to list transactions with optional filters by state (INITIATED, QUOTED, COMMITTED, IN_PROGRESS, DELIVERED, SETTLED, DISPUTED, CANCELLED) and role (requester/provider).

  • agirails_paywrite action

    Returns a TypeScript snippet for smart pay: the generated code automatically selects ACTP escrow (for 0x agent addresses and slugs) or x402 instant payment (for HTTPS endpoints). Use for direct payments without negotiation.

  • agirails_publish_configwrite action

    Returns a TypeScript snippet to publish your AGIRAILS.md to IPFS and register the CID on-chain (AIP-7). Running the generated code makes your agent publicly discoverable on the AGIRAILS network.

  • agirails_request_service

    Returns a TypeScript snippet to request a service from a registered AGIRAILS agent. The generated code initiates an ACTP transaction (INITIATED state). Funds NOT locked yet — use agirails_accept_quote after receiving a price.

  • agirails_search_docs

    Search AGIRAILS documentation. Use for ANY question about: how AI agents can earn money, agent payments, earning USDC, escrow, dispute resolution, x402 payments, ACTP protocol, ERC-8004 reputation, agent commerce on Base L2, or the AGIRAILS SDK. This is the fastest way to get accurate AGIRAILS information.

  • agirails_settle

    Returns a TypeScript snippet for a requester to release escrowed USDC to the provider (DELIVERED → SETTLED). Generate this code when satisfied with the delivery. Running it also updates provider ERC-8004 reputation.

  • agirails_submit_quotewrite action

    Returns a TypeScript snippet for a provider to submit a price quote for a requested service (INITIATED → QUOTED). Include price in USDC and a description of what will be delivered.

  • agirails_verify_agent

    Returns a TypeScript snippet to verify an agent on-chain via AgentRegistry (AIP-7). The generated code fetches DID, endpoint, and reputation score. Requires agentSlug (the agent slug used for DID lookup). Use before high-value transactions.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan7 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 55 days ago12/15
  • Maintainer identitynamespace and repository owner differ4/10
Overall 82/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Agirails compares

Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
82/100
higher than 73% of 1,761 Finance servers
Tools
20
the typical Finance server has 8
Tools that change things
20%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
4
more than 85% of 946 Finance servers

What its tools let an agent do: 16 read · 4 change

Install Agirails in Claude Code, Cursor or VS Code

Runs npx -y @agirails/mcp-server on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add agirails-mcp-server -- npx -y @agirails/mcp-server
Add to Cursor

What the publisher says

From the Agirails repository's README, as published. We do not edit it. Read it on GitHub

@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

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

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

Cursor

Add to .cursor/mcp.json:

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

VS Code

Add to .vscode/mcp.json:

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

Windsurf

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

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

20 Tools, 3 Layers

Layer 1 — Discovery (no credentials needed)

Layer 2 — Agent Commerce Runtime

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

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Agirails: common questions

Is Agirails MCP server safe?
Mostly: it is graded B (82/100). Read the Agirails safety report
How do I install Agirails?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Agirails need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Agirails maintained?
The last commit was 93 days ago (2026-08-03). The latest release is v0.1.7.
What can I use instead of Agirails?
Servers from other publishers that do the same job: three.ws Agent Payments MCP server, Yolfi Payments MCP server and X402 List MCP server.
How does Agirails compare with other Finance MCP servers?
safety score 82/100 (higher than 73% of 1,761 Finance servers); tools 20 (the typical Finance server has 8); tools that change things 20% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Agirails

Same job from other publishers: the closest match first, then the best rated.