HeyAnon MCP

io.github.RealWagmiPublished by GitHub account RealWagmiv1.0.0Updated Oct 25, 2026

HeyAnon on-chain agent: wallets, portfolios, DeFi and CEX actions, transfers, Gemma research.

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Remote HeyAnon MCP server that lets an assistant read crypto wallets and portfolios, run on-chain actions through the Anon agent, and send funds.

What you can do
Check server health and get the API key setup page, and list supported protocols and networks with their tool counts and chains. List the user's wallets and saved recipient addresses, and read token balances, recent transactions, DeFi positions and linked CEX balances across wallets. Ask Anon, the on-chain agent, to handle balances, swaps, bridging, lending, staking, CEX and automations, then poll, list or delete the resulting background tasks and stop a stuck request. Ask Gemma for crypto research such as protocol analysis, market data, news and token analytics. List, inspect and delete scheduled automations, and send native coins or tokens from a wallet to an address.
When to use it
Use it when an assistant should work with the user's HeyAnon account: checking multi-chain portfolios and DeFi or CEX positions, getting crypto research, running swaps and other on-chain actions through Anon, managing scheduled automations, or sending funds. It suits users who already hold a HeyAnon API key and want those actions available from a chat client.
Requirements
A remote MCP endpoint at api.heyanon.ai over HTTPS; nothing runs locally. A HeyAnon account and API key, obtained from the HeyAnon site and supplied as the X-API-Key header by the client. Wallets and exchange accounts must already be registered in HeyAnon. Network access to the endpoint is required.
Before you install
The API key is a credential: keep it out of chat and let the client store it. Anon can execute real transactions from attached wallets, and the transfer tools move real funds irreversibly; the README says the agent should show the exact action and wait for explicit confirmation. Delete tools remove task records and scheduled automations irreversibly. Wallet, portfolio and transaction data are sent to the HeyAnon backend.

Installation

In SourceWeft

  1. Open HeyAnon MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.RealWagmi%2Fheyanon/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

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

ToolKeyWhat it does
ping, get_api_key_setup_urlnoServer check; where to create an API key
wallet_listyesYour wallets: name, type (evm, solana, ton), address, labels
address_book_listyesSaved recipient addresses
projectsyesSupported protocols and networks
portfolio_tokens, portfolio_transactions, portfolio_defi, portfolio_cexyesPortfolio readers per wallet
ask_gemmayesCrypto research; answers directly
ask_anonyesAction. Message to Anon: balances, swaps, bridging, lending, staking, CEX, automations. Returns a background task ID
background_task, background_task_listyesRead a task's status, result and logs
scheduled_task_list, scheduled_task_getyesAutomations created through Anon
transfer_native, transfer_assetyesMoves funds. Send the native coin or a token to an address; irreversible
abort, background_task_delete, scheduled_task_deleteyesChanges state. Stop processing; delete a task record or an automation
isProcessingyesWhether 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):

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/mcp over HTTPS as the X-API-Key header.
  • 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

License

MIT

Source: README.md at commit b3dc80c

Tools

21

ping

Ping

Health check for the Hey Anon MCP server. Returns "pong" and the server time (ISO 8601). No API key required.

Takes no parameters.

get_api_key_setup_url

API key setup URL

Get the URL of the Hey Anon page where the user logs in and creates an API key, plus the MCP config snippet where the key goes (X-API-Key header). Call this when a tool fails with "API key not set" or the user has no key yet. The key is never passed through the chat. No API key required.

Takes no parameters.

wallet_list

List wallets

List the user wallets registered in Hey Anon: display name, type (evm, solana, ton, etc.), address, labels and whether the wallet is archived. Call it before ask_anon to choose which addresses to attach (at most one per type); match the wallet the user names by display name, label or address and skip archived wallets. The same addresses are used by the portfolio_* tools.

Takes no parameters.

ask_anon

Ask Anon

Send a message to Anon, the Hey Anon on-chain AI agent (balances, swaps, bridging, lending, staking, CEX, scheduled automations, research). Asynchronous: the output is only a confirmation with the background task ID; poll background_task with that ID until status is no longer "pending" ("completed": the reply is in result; any other status, e.g. "failed": the request did not finish, check logs). Anon keeps NO conversation context: every message is processed from a clean slate, so each message must be self-contained (repeat the wallet, network, token and amount every time; follow-ups like "and on Base?" will not work). Before sending, the tool checks that Anon is idle: if the previous request is still processing it returns an error, poll background_task until it finishes (or call abort) and retry. Anon can execute real transactions from the attached wallets: send action instructions (swap, send, bridge, stake, create an automation) only when the user explicitly asked for that action, and phrase everything else as a question. For general crypto research not tied to the user wallets, prefer ask_gemma.

Parameterstextrequiredfileswalletsrequired

ask_gemma

Ask Gemma

Ask Gemma, the Hey Anon crypto research assistant: protocol analysis, community and social insights, market data, news, token analytics by contract address. Synchronous: returns the answer text directly, no polling and no wallet addresses needed. Research only: Gemma takes no wallet addresses, executes no transactions and keeps its own session, separate from the Anon conversation. Prefer ask_gemma for general crypto questions and ask_anon for anything about the user wallets or for actions.

Parameterstextrequired

isProcessing

Is Anon processing

Check whether Anon is still processing the previous ask_anon request. Returns "isProcessing: true|false". Use before sending another message, or when a request looks stuck (then call abort).

Takes no parameters.

abort

Abort Anon request

Force-stop Anon processing of the current ask_anon request. Use only when isProcessing stays true for too long or the request is stuck; otherwise wait for the background task to complete.

Takes no parameters.

projects

List supported projects

List the protocols and integrations Anon can operate (swaps, lending, staking, bridges, CEX, etc.): name, key, description, supported networks, tool count. Use it to check whether Anon supports a protocol or network before asking.

Takes no parameters.

scheduled_task_list

List scheduled tasks

List the user scheduled tasks: automations created through Anon that run at a given time or when a price condition is met. There is no create/update tool: to create an automation, ask Anon via ask_anon (e.g. "Buy 0.1 ETH on Base when ETH drops below 2000"), then use this tool to confirm it exists. Returns id, description, status, type and, when present, taskExecutorResponse (the last execution result); the trigger time or condition is not a separate field, infer it from description.

Takes no parameters.

scheduled_task_get

Get scheduled task

Get one scheduled task by id (from scheduled_task_list). Returns id, description, status, type and taskExecutorResponse (the last execution result).

Parametersidrequired

scheduled_task_delete

Delete scheduled task

Delete (cancel) a scheduled task by id. Irreversible: the automation will not run again. Returns a confirmation.

Parametersidrequired

portfolio_tokens

Portfolio tokens

Token balances for every user wallet (addresses taken from wallet_list) across all supported networks. Returns JSON [{ walletAddress, data }]; for EVM wallets data.evm is keyed by chain id, Solana balances are in data.solana. Output can be large with many wallets.

Takes no parameters.

portfolio_transactions

Portfolio transactions

Recent transactions for every user wallet (addresses taken from wallet_list). Returns JSON [{ walletAddress, data }]. Output can be large with many wallets.

Takes no parameters.

portfolio_defi

Portfolio DeFi positions

DeFi positions (LP, staking, lending, vaults, etc.) for every user wallet (addresses taken from wallet_list). Returns JSON [{ walletAddress, data }].

Takes no parameters.

portfolio_cex

Portfolio CEX

Balances and positions from the exchange accounts linked to Hey Anon (e.g. Hyperliquid, keyed by exchange). Pass address (an EVM wallet from wallet_list) when the user has several EVM wallets, otherwise the backend rejects the call. Returns the raw JSON response.

Parametersaddress

background_task_list

List background tasks

List the user Anon background tasks (one per ask_anon message): id, prompt, status, result (Anon reply when completed), logs, createdAt, updatedAt. Use it to find earlier answers or check what is still pending. Also returned as structuredContent { tasks }.

Takes no parameters.

background_task

Get background task

Get one Anon background task by id. Each ask_anon call creates a task; poll this tool until status is no longer "pending": "completed" means the Anon reply is in result; any other status (e.g. "failed") means the request did not finish, check logs. Returns id, prompt, status, result ("—" while absent), logs (execution trace, appended live while the task runs), createdAt, updatedAt; the same object is returned as structuredContent.

Parametersidrequired

background_task_delete

Delete background task

Delete a background task record by id.

Parametersidrequired

transfer_native

Transfer native coin

Send the native coin of a network (ETH, S, SOL, TON, ...) from one of the user wallets to another address. This moves real funds and cannot be undone. Call it only when the user explicitly asked to send this exact amount of this asset from this wallet to this recipient on this network; never infer, round or top up any of these values. If anything is missing or ambiguous, ask the user instead of guessing. Returns the transaction hash and an explorer link (also as structuredContent).

ParameterstorequiredfromrequiredchainrequiredamountrequiredallBalance

transfer_asset

Transfer token

Send a token (ERC-20 / SPL / jetton) from one of the user wallets to another address. This moves real funds and cannot be undone. Call it only when the user explicitly asked to send this exact amount of this asset from this wallet to this recipient on this network; never infer, round or top up any of these values. If anything is missing or ambiguous, ask the user instead of guessing. Returns the transaction hash and an explorer link (also as structuredContent).

ParameterstorequiredfromrequiredassetrequiredchainrequiredamountrequiredallBalance

address_book_list

List address book

List the user saved recipient addresses (address book): name, networks and address. Use it to resolve a recipient the user names, e.g. "send 0.1 ETH to My work address": find the entry by name (search), take its address and confirm it with the user before calling transfer_native or transfer_asset. Informational only: transfers are not restricted to these addresses. Returns the entries and pagination, also as structuredContent.

Parameterspagesizechainssearch

Version history

1
  1. v1.0.0LatestOct 13, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts