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

Rate Limits

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:

Troubleshooting

License

MIT