HeyAnon MCP plugin
Connect Cursor or Grok Bot to HeyAnon: wallets, portfolios, DeFi and CEX actions through Anon, the HeyAnon on-chain agent; Gemma crypto research; token transfers and scheduled automations. The plugin registers the remote HeyAnon MCP server and ships an Agent Skill that teaches wallet selection, self-contained Anon requests, background-task polling and confirmation rules.
Tools
| Tool | Key | What it does |
|---|---|---|
ping, get_api_key_setup_url | no | Server check; where to create an API key |
wallet_list | yes | Your wallets: name, type (evm, solana, ton), address, labels |
address_book_list | yes | Saved recipient addresses |
projects | yes | Supported protocols and networks |
portfolio_tokens, portfolio_transactions, portfolio_defi, portfolio_cex | yes | Portfolio readers per wallet |
ask_gemma | yes | Crypto research; answers directly |
ask_anon | yes | Action. Message to Anon: balances, swaps, bridging, lending, staking, CEX, automations. Returns a background task ID |
background_task, background_task_list | yes | Read a task's status, result and logs |
scheduled_task_list, scheduled_task_get | yes | Automations created through Anon |
transfer_native, transfer_asset | yes | Moves funds. Send the native coin or a token to an address; irreversible |
abort, background_task_delete, scheduled_task_delete | yes | Changes state. Stop processing; delete a task record or an automation |
isProcessing | yes | Whether Anon is still busy with the previous request |
Read-only tools are marked as such with MCP tool annotations; ask_anon, the
transfer tools, abort and the delete tools are marked destructive. Anon can
execute real transactions from the attached wallets, so the skill tells the
agent to show the exact action and wait for your explicit confirmation before
every such call. Client prompts add a second gate: Cursor asks before MCP tool
calls by default, Grok Bot reviews tool calls and lets you add "Ask first"
rules in its settings.
Setup
Grok Bot
Open Connect apps, find HeyAnon MCP and choose Add. Enter your API
key in the secure field the app asks for; it is stored by Grok Bot and sent only
as the X-API-Key header of the MCP connection. Get the key at
https://heyanon.ai/ (account settings, API keys). Do not paste it into the chat.
Cursor
Install HeyAnon MCP from the Cursor Marketplace, open the plugin, then Setup β Edit Values and paste your HeyAnon API key. The skill appears in Customize.
Manual setup
Add to .cursor/mcp.json in your project (or ~/.cursor/mcp.json):
{
"mcpServers": {
"heyanon": {
"url": "https://api.heyanon.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}
Codex, Claude Code, Hermes and OpenClaw users can use HeyAnon Connect instead; it installs the same connection and skill with a local key page.
Examples
"What are my balances on Base?" The agent takes your EVM address from
wallet_list, sends one self-contained question through ask_anon, polls
background_task until it completes and reports the answer.
"Swap 10 USDC to ETH on Base from my main wallet" The agent confirms the
exact action, sends it through ask_anon, waits for the task and reports the
transaction links from the result.
"Send 0.1 ETH to my work address on Arbitrum" The agent resolves the
contact with address_book_list, confirms the address and amount with you, and
calls transfer_native once.
"Any news about Aave this week?" Research goes to ask_gemma, which answers
directly.
Anon keeps no context between messages: every request must be self-contained, and Anon handles one request at a time.
Privacy and security
- The API key is stored by the client (Cursor or Grok Bot) and sent only to
https://api.heyanon.ai/mcpover HTTPS as theX-API-Keyheader. - No secrets are stored in this repository, and nothing runs locally: the plugin is configuration and a skill for a remote server.
- HeyAnon privacy policy
- Security reports: see SECURITY.md
Support and community
- Questions and feedback: [email protected]
- Documentation: https://docs.heyanon.ai/heyanon.ai
- X: https://x.com/heyanonai
- Telegram: https://t.me/realwagmi
- Discord: https://discord.com/invite/realwagmi
License
MIT