Amper MCP Server

MCP server that exposes Amper's 80+ DeFi tools to any MCP-compatible client.

Natural language in, onchain transactions out.

Quick Install

Add Amper to your MCP client with a single config block. Requires Node.js 18+ and an Amper API key.

Claude Code

Add to .mcp.json (project root) or ~/.claude.json (global):

{
  "mcpServers": {
    "amper": {
      "command": "npx",
      "args": ["-y", "amper-mcp-server"],
      "env": {
        "AMPER_API_KEY": "amp_live_your_key_here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "amper": {
      "command": "npx",
      "args": ["-y", "amper-mcp-server"],
      "env": {
        "AMPER_API_KEY": "amp_live_your_key_here"
      }
    }
  }
}

Windsurf

Add to .windsurf/mcp.json:

{
  "mcpServers": {
    "amper": {
      "command": "npx",
      "args": ["-y", "amper-mcp-server"],
      "env": {
        "AMPER_API_KEY": "amp_live_your_key_here"
      }
    }
  }
}

Hermes

# ~/.hermes/config.yaml
mcp_servers:
  amper:
    command: "npx"
    args: ["-y", "amper-mcp-server"]
    env:
      AMPER_API_KEY: "amp_live_your_key_here"

Or install globally for faster startup:

npm install -g amper-mcp-server

# ~/.hermes/config.yaml
mcp_servers:
  amper:
    command: "amper-mcp-server"
    env:
      AMPER_API_KEY: "amp_live_your_key_here"

Get an API Key

1. Sign up at app.amper.chat
2. Subscribe ($6/month, 500 requests/day) or fund your embedded wallet with USDC on Base for pay-per-request (https://www.amper.chat/docs/api/pricing)
3. Go to Settings > API and create a key
4. Keys start with amp_live_ and come in two scopes:
   • Read. Price checks, analytics, portfolio queries
   • Write. Everything above plus swaps, lending, bridging, and all onchain execution

Hermes Full Setup Guide

Hermes is an open-source terminal agent by Nous Research. Follow these steps to go from zero to executing DeFi operations from your terminal.

1. Install Hermes

macOS / Linux / WSL2:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Windows (PowerShell):

iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)

Verify the installation:

hermes --version

Then run initial setup:

hermes setup

This will prompt you for your preferred LLM provider and model. If you have a Nous Portal account, use hermes setup --portal instead.

2. Add the Amper MCP Server

Edit ~/.hermes/config.yaml and add the amper entry under mcp_servers (see Hermes config above).

3. Verify

Launch Hermes and try a few commands:

hermes

> What is the price of ETH?
> Show my portfolio on Base
> Swap 0.001 ETH to USDC on Base

Type /tools inside Hermes to list all available Amper tools.

Configuration

| Variable | Required | Description | |----------|----------|-------------| | AMPER_API_KEY | Yes | Your API key (must start with amp_live_) | | AMPER_BASE_URL | No | Override the API base URL (default: https://app.amper.chat/api/v1) |

Rate Limits

| Limit | Value | |-------|-------| | Per minute | 30 requests | | Per day | 500 requests | | Concurrency | Sequential (one at a time per key) |

How It Works

• Discovery. Fetches all tools from /api/v1/tools on startup (cached 5 min).
• Execution. Each tool call hits POST /api/v1/execute with a unique idempotency key.
• Timeouts. 65s for trade tools, 35s for read tools.
• Transport. Stdio. Your MCP client spawns the server as a subprocess.

Available Tools

80+ tools across these categories:

| Category | Examples | |----------|----------| | Token Operations | Swaps, transfers, approvals, wrapping | | Lending | Aave v3 deposits, withdrawals, borrowing | | Vaults | Morpho vault deposits, withdrawals, rewards | | Perpetuals | Avantis positions and limit orders (up to 500x) | | Options | Derive options trading and sessions | | Staking | Venice staking and reward claims | | Token Creation | Clanker token deployment and image generation | | Analytics | DefiLlama TVL, Codex token data, price feeds | | Bridges | Cross-chain transfers |

Troubleshooting

| Error | Fix | |-------|-----| | invalid_key | Check that your key starts with amp_live_ | | key_expired | Generate a new key in Settings > API | | scope_denied | You're using a Read key for a write operation. Create a Write key | | payment_required | No active subscription or insufficient USDC balance | | MCP server not loading | Verify Node.js 18+ is installed (node --version) | | Tools not appearing (Hermes) | Run /reload-mcp inside Hermes |

License

MIT