@archerprotocol/mcp-client

Stdio bridge that connects AI coding assistants to Archer Protocol's remote MCP server. Gives your AI agent access to Web3 tools — token prices, wallet balances, swaps, bridges, and transfers — through natural language.

How It Works

Claude Code / Desktop          This package             Archer MCP Server
┌──────────────────┐     ┌──────────────────┐     ┌──────────────────────┐
│                  │     │                  │     │                      │
│   AI Assistant   │◄───►│  stdio ◄─► HTTP  │◄───►│  Web3 Tools (10+)    │
│                  │     │                  │     │                      │
└──────────────────┘     └──────────────────┘     └──────────────────────┘
       stdin/stdout           Bridge                  api.archerprotocol.com

The bridge runs locally, authenticates with your API key, discovers all available tools from Archer's server, and exposes them over stdio — the transport that Claude Code and Claude Desktop require.

Quick Start

1. Get an API Key

Create an account at app.archerprotocol.com and generate an API key in the Developer Portal.

2. Configure Your Client

Claude Code — add to .mcp.json (project) or ~/.claude.json (global):

{
  "mcpServers": {
    "archer": {
      "command": "npx",
      "args": ["@archerprotocol/mcp-client"],
      "env": {
        "ARCHER_API_KEY": "arch_your_api_key_here"
      }
    }
  }
}

Claude Desktop — edit the config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "archer": {
      "command": "npx",
      "args": ["@archerprotocol/mcp-client"],
      "env": {
        "ARCHER_API_KEY": "arch_your_api_key_here"
      }
    }
  }
}

3. Start Using It

> What's the price of ETH?
The current price of ETH is $2,142.50 USD.

> Check my balances on Arbitrum
Your Arbitrum balances:
- 0.045 ETH ($96.41)
- 152.30 USDC ($152.30)

> Swap 50 USDC to ETH on Arbitrum
I've prepared a swap of 50 USDC → ETH on Arbitrum.
Please review and approve the transaction at app.archerprotocol.com.

Installation

No installation required — npx downloads and runs the package automatically.

If you prefer to install explicitly:

npm install -g @archerprotocol/mcp-client

Environment Variables

| Variable | Required | Description | |----------|:--------:|-------------| | ARCHER_API_KEY | Yes | Your Archer API key (starts with arch_) | | ARCHER_MCP_URL | No | Override the server URL (default: https://api.archerprotocol.com/mcp) |

Available Tools

The bridge automatically discovers and proxies all tools from Archer's MCP server:

Read-Only (no approval needed)

| Tool | Description | |------|-------------| | resolve_token | Look up token metadata by symbol or address | | get_token_price | Get current USD price for any token | | get_user_balances | Fetch balances across all connected chains | | get_chain_capabilities | List supported chains and their features |

Transactional (requires approval in webapp)

| Tool | Description | |------|-------------| | get_swap_quote | Get a quote for a token swap | | prepare_swap_tx | Prepare a swap transaction for approval | | get_bridge_quote | Get a quote for a cross-chain bridge | | prepare_bridge_tx | Prepare a bridge transaction for approval | | prepare_send_tx | Prepare a token transfer for approval | | check_approval_status | Check if a pending transaction was approved |

Transactional tools create an approval request in the Archer webapp. The user reviews and signs the transaction there — the AI agent never has direct access to private keys.

Other MCP Clients

Clients that support direct HTTP connections (Cursor, VS Code, Windsurf, etc.) don't need this bridge — they can connect directly:

{
  "type": "sse",
  "url": "https://api.archerprotocol.com/mcp",
  "headers": {
    "x-api-key": "arch_your_api_key_here"
  }
}

See the full Client Setup Guide for configurations for Cursor, VS Code, Windsurf, Cline, Continue, and more.

Security

• API keys authenticate requests but never grant direct wallet access
• All transactions require explicit human approval in the webapp
• The bridge runs locally — your API key is never shared with third parties
• Revoke API keys at any time from the Developer Portal

Requirements

• Node.js 18+
• An Archer account with an API key

License

MIT