For AI Agents

Agnic Skill Guide

Install skills, connect via MCP, or call the REST API directly. Agnic gives your agent an autonomous wallet, access to 340+ AI models, x402 payments, on-chain identity, and agentic email.

Raw skill.md Skills Repo API Docs

Step 0

First-Time Wallet Setup

If you don't have an Agnic wallet yet, guide the user through these steps to create one and get an API key.

Authenticate

Terminal

# 1. Check auth state
npx agnic@latest status

# 2. Login with email OTP
npx agnic@latest auth login [email protected]
npx agnic@latest auth verify <flowId> <6-digit-otp>

# 3. Check balance
npx agnic@latest balance --json

# 4. Install skills
npx skills add agnicpay/agnic-wallet-skills

Fund your wallet

Get your wallet address then send USDC on Base or Solana — or fund via the dashboard.

npx agnic@latest address
# Send USDC to this address on Base or Solana
# Or visit https://pay.agnic.ai to fund via dashboard

Get your API token

Visit pay.agnic.ai and copy your API token. It will look like agnic_tok_...

Connect via Skills or MCP

Choose your integration method below.

Method A

Install Agnic Skills

Works with Claude Code, Claude Cowork, OpenClaw, and any agent that supports the Vercel Skills format. Once installed, the agent automatically invokes the right skill based on user intent.

Install

npx skills add agnicpay/agnic-wallet-skills

Source: github.com/agnicpay/agnic-wallet-skills

10 Skills

Available Skills

Each skill is triggered automatically when the user's intent matches. All skills use the agnic CLI under the hood.

authenticate-wallet

"log in", "sign in to my wallet", "authenticate"

check-balance

Check USDC balance across Base and Solana networks.

"what's my balance", "how much USDC do I have"

send-usdc

Send USDC to any Ethereum or Solana wallet address.

"send 10 USDC to 0x...", "transfer funds"

trade-tokens

Swap tokens on Base — USDC, ETH, WETH, cbETH, DAI, AERO.

"swap ETH for USDC", "trade tokens", "buy ETH"

search-for-service

Discover x402-enabled paid APIs in the AgnicHub marketplace.

"find a sentiment API", "search for paid APIs"

pay-for-service

Make a paid HTTP request to any x402-enabled API.

"call this API", "pay for https://..."

fund-wallet

Get your wallet address and instructions to deposit USDC.

"add funds", "deposit USDC", "top up my wallet"

get-agent-identity

Check on-chain ERC-8004 identity, trust score, and KYA credentials.

"my agent identity", "trust score", "KYA credentials"

agent-email

Manage your agent's email — send, receive, check inbox.

"send an email", "check my inbox", "set up agent email"

ai-gateway

Access 340+ AI models — chat with GPT, Claude, Gemini, Llama, generate images.

"chat with GPT-4o", "generate an image", "list AI models"

Method B

MCP Server

Connect directly to the AgnicPay MCP server for tool-level access in any MCP-compatible client.

Server URLhttps://mcp.agnic.ai/sse

TransportSSE

Auth HeaderAuthorization: Bearer agnic_tok_YOUR_TOKEN

Claude Desktop

Add to claude_desktop_config.json

JSON

{
  "mcpServers": {
    "agnicpay": {
      "url": "https://mcp.agnic.ai/sse",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer agnic_tok_YOUR_TOKEN"
      }
    }
  }
}

Claude Code (CLI)

Terminal

claude mcp add agnicpay --transport sse \
  --url https://mcp.agnic.ai/sse \
  --header "Authorization: Bearer agnic_tok_YOUR_TOKEN"

OpenClaw

Add an MCP server with URL https://mcp.agnic.ai/sse, transport SSE, and the Bearer auth header above. OpenClaw also supports skill installation:

npx skills add agnicpay/agnic-wallet-skills

n8n

In your n8n MCP node: set Server URL to https://mcp.agnic.ai/sse, authentication to Bearer Token, and paste your agnic_tok_... token.

Method C

REST API

Call the AgnicPay API directly. Base URL: https://api.agnic.ai

Authentication — include one of:

# API Token
X-Agnic-Token: agnic_tok_YOUR_TOKEN

# OAuth2 Bearer
Authorization: Bearer agnic_at_YOUR_OAUTH_TOKEN

Method	Endpoint	Description
GET	/api/balance	Check USDC wallet balance
GET	/api/transactions	View payment history
POST	/api/x402/fetch	Transparent x402 payment proxy (recommended)
POST	/api/sign-payment	Manual x402 payment signing
POST	/api/trade	Token swaps on Base via DEX aggregation

Full reference: docs.agnic.ai/docs/agnicpay-features

Security

NEVER send your API token (agnic_tok_...) or OAuth token (agnic_at_...) to any domain other than api.agnic.ai or mcp.agnic.ai.
Your API token represents your wallet identity. If compromised, rotate it immediately at pay.agnic.ai.
Set spending limits on your wallet to cap agent expenditure.

Get Started

Ready to give your agent a wallet?

Open Dashboard Raw skill.md for agents