AGIRAILS

Agent payments for Cursor: ACTP escrow, x402, and USDC settlement on Base.

Canonical specification · Documentation · Apache-2.0

What this plugin does

AGIRAILS helps AI agents pay, get paid, and settle work. This plugin gives Cursor one focused skill for:

• integrating the AGIRAILS SDK;
• choosing between ACTP escrow and x402 payments;
• building requester and provider agents;
• onboarding, discovery, settlement, receipts, and disputes;
• verifying current SDK symbols before generating code.

The plugin does not bundle a copy of the protocol documentation. It fetches the live canonical AGIRAILS.md at the start of every AGIRAILS task, so there is only one source of truth to maintain.

Use it

Invoke the skill directly:

/agirails Help me add an x402 payment to this API.

Or ask naturally:

Build a provider agent that sells code reviews for USDC using AGIRAILS.

Explain the ACTP lifecycle and show which actions each party can take.

Install locally

Until the marketplace listing is approved, clone the repository into Cursor's local plugin directory:

mkdir -p ~/.cursor/plugins/local
git clone https://github.com/agirails/cursor-plugin.git ~/.cursor/plugins/local/agirails

Restart Cursor, then invoke /agirails in Agent.

Safety boundaries

The skill instructs the agent to:

• keep private keys, seed phrases, keystores, and passwords local;
• verify APIs against canonical AGIRAILS sources instead of inventing symbols;
• show the network, recipient, amount, payment mode, and expected fee before an on-chain transaction;
• obtain explicit approval before transacting;
• clearly identify mainnet operations as real USDC.

Portable core

The knowledge layer is the standard skills/agirails/SKILL.md file. The Cursor manifest is a thin adapter that supplies marketplace metadata, branding, and discovery. Other harnesses that support Agent Skills can reuse the same skill without copying protocol documentation.

Repository structure

.
├── .cursor-plugin/plugin.json
├── assets/logo.png
├── skills/agirails/SKILL.md
├── LICENSE
└── README.md

Validate a change

jq -e . .cursor-plugin/plugin.json >/dev/null
test -f skills/agirails/SKILL.md
test -f assets/logo.png

Then restart Cursor and run a smoke test:

/agirails Fetch the live canonical AGIRAILS specification and report its frontmatter version and URL.

Source of truth

• Protocol and onboarding: AGIRAILS.md
• Per-symbol SDK verification: sdk-manifest.json
• Advanced flows: AGIRAILS recipes

License

Apache-2.0. See LICENSE.