For AI Agents

Agnic Skill Guide

Install skills, connect via MCP, or call the REST API directly. Agnic gives your agent access to 340+ AI models, x402 paid services, a cryptographic identity, and its own email inbox — one dashboard at app.agnic.ai.

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

# Token mode — recommended for agents
npx agnic@latest --token <agnic_token> status
# Or: export AGNIC_TOKEN=<agnic_token>

# Browser OAuth — for humans
npx agnic@latest auth login

# Check status
npx agnic@latest status --json

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

Fund your wallet

Get your wallet address, then add credits via the dashboard.

npx agnic@latest address
# Add credits: https://app.agnic.ai → "Add Funds"
npx agnic@latest balance --json

Get your API token

Visit app.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

8 Skills

Available Skills

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

authenticate

Browser OAuth or headless token auth — recommended for autonomous agents.

"log in", "sign in", "authenticate"

check-balance

Check your credit balance across all supported networks.

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

search-for-service

Discover x402-enabled paid APIs in the bazaar marketplace.

"find an API", "search for a service"

pay-for-service

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

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

fund-wallet

Get your wallet address and instructions to add credits.

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

get-agent-identity

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

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

agent-email

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

"send an email", "check my inbox", "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 Agnic 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": {
    "agnic": {
      "url": "https://mcp.agnic.ai/sse",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer agnic_tok_YOUR_TOKEN"
      }
    }
  }
}

Claude Code (CLI)

Terminal

claude mcp add agnic --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 Agnic 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	Wallet credit balance
GET	/api/transactions	Payment history
POST	/api/x402/fetch	Transparent x402 payment proxy (recommended)
POST	/api/sign-payment	Manual x402 payment signing

Full reference: docs.agnic.ai

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 app.agnic.ai.
Set spending limits on your wallet to cap agent expenditure.

Get Started

Ready to give your agent a cockpit?

Open Dashboard Raw skill.md for agents