# HeyAnon MCP

> HeyAnon MCP is an MCP server for finance and payments. Remote MCP server for DeFi swaps, wallets and portfolios through the Anon agent. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API
- **Website:** https://heyanon.ai
- **Repository:** https://github.com/realwagmi/heyanon-ai-cursor-plugin
- **MCP Registry name:** io.github.RealWagmi/heyanon
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

Requests go to a single hosted endpoint, `https://api.heyanon.ai/mcp`, and are authenticated with an API key sent in an `X-API-Key` header. The heavy lifting is delegated to Anon, HeyAnon's on-chain agent: the `ask_anon` tool takes one self-contained message, returns a background task ID, and the client polls `background_task` for the result and transaction links.

Around that sit read-only tools for wallets (EVM, Solana and TON types), saved recipient addresses, supported protocols and per-wallet portfolio data, plus `ask_gemma` for crypto research that answers directly. Direct `transfer_native` and `transfer_asset` calls move funds and cannot be undone.

The README is explicit about risk: Anon can run real transactions from attached wallets, so the bundled Agent Skill tells the client to show the exact action and wait for explicit confirmation. Anon keeps no context between messages and handles one request at a time.

## Features

- **Anon action requests:** `ask_anon` sends swaps, bridging, lending, staking, CEX actions and automations as a background task.
- **Wallet and address lookup:** `wallet_list` and `address_book_list` return your wallets and saved recipients.
- **Portfolio readers:** Separate tools cover tokens, transactions, DeFi positions and CEX balances per wallet.
- **Crypto research:** `ask_gemma` answers research questions such as protocol news directly.
- **Direct transfers:** `transfer_native` and `transfer_asset` send the native coin or a token to an address.
- **Task and automation control:** Tools list, read and delete background tasks and scheduled automations, and `abort` stops processing.

## Good for

- Check balances on a chain from inside Cursor
- Swap one token for another from a chosen wallet after confirming the action
- Send a native coin to a saved contact address
- Ask for recent news about a DeFi protocol
- Review scheduled automations created through Anon

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http heyanon https://api.heyanon.ai/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.heyanon.ai/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "heyanon": {
      "url": "https://api.heyanon.ai/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "heyanon": {
      "type": "http",
      "url": "https://api.heyanon.ai/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "heyanon": {
      "serverUrl": "https://api.heyanon.ai/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "heyanon": {
      "type": "http",
      "url": "https://api.heyanon.ai/mcp"
    }
  }
}
```

## Tools

- `ping`: Server check
- `get_api_key_setup_url`: Where to create an API key
- `wallet_list`: Lists your wallets with name, type, address and labels
- `address_book_list`: Lists saved recipient addresses
- `projects`: Lists supported protocols and networks
- `portfolio_tokens`: Per-wallet token portfolio
- `portfolio_transactions`: Per-wallet transactions
- `portfolio_defi`: Per-wallet DeFi positions
- `portfolio_cex`: Per-wallet CEX portfolio
- `ask_gemma`: Crypto research that answers directly
- `ask_anon`: Sends an action request to Anon and returns a background task ID
- `background_task`: Reads a task's status, result and logs
- `background_task_list`: Lists background tasks
- `scheduled_task_list`: Lists automations created through Anon
- `scheduled_task_get`: Reads one scheduled automation
- `transfer_native`: Sends the native coin to an address
- `transfer_asset`: Sends a token to an address
- `abort`: Stops processing
- `background_task_delete`: Deletes a task record
- `scheduled_task_delete`: Deletes an automation
- `isProcessing`: Reports whether Anon is still busy

## FAQ

### How do I authenticate?

Create an API key in your HeyAnon account settings and send it as the X-API-Key header. In Cursor you paste it under the plugin's Setup values.

### Can it move my funds?

Yes. ask_anon and the transfer tools can execute real transactions, and transfers are irreversible, so the bundled skill asks the agent to confirm each action with you first.

### Does Anon remember earlier messages?

No. Every request has to be self-contained, and Anon works on one request at a time.

### Which clients are mentioned?

Cursor and Grok Bot, with a separate HeyAnon Connect project for Codex, Claude Code, Hermes and OpenClaw.

### How do I add HeyAnon MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http heyanon https://api.heyanon.ai/mcp

### What are the best alternatives to HeyAnon MCP?

The closest alternatives to HeyAnon MCP are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Crypto Feeds and Crypto Fng.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Crypto Fng](https://ai-powered.com/mcp/crypto-fng): Crypto Fng is a freemium MCP server for finance and payments.
- [Creditcard](https://ai-powered.com/mcp/creditcard): Creditcard is a freemium MCP server for finance and payments.
- [Zovo LEI Lookup](https://ai-powered.com/mcp/zovo-lei-lookup): Zovo LEI Lookup is an MCP server for finance and payments.
- [Recurly](https://ai-powered.com/mcp/recurly): Recurly is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/heyanon-mcp
