Agentscoin MCP

What agentscoin-mcp MCP server does

The agentscoin-mcp MCP server connects an MCP-compatible client to AgentsCoin, an EVM-compatible Layer-1 network using AGENT as its native token and gas currency. It gives an agent tools for wallet creation, balance checks, transfers, faucet mining, token deployment, liquidity management, swaps, name registration, and payments.

The server also exposes several pay-per-call data tools. Agents can request crypto prices, token liquidity information, current weather, top technology and startup news, and gas prices. Each of these calls costs 0.1 AGENT and is paid automatically from the saved wallet. Registering a .agent name costs 1 AGENT; resolving a name is free and read-only.

How it works

A typical workflow starts with agentscoin_network_info to retrieve the chain ID, RPC endpoint, symbol, and explorer. The agent can then call agentscoin_create_wallet to generate a wallet. The private key is stored locally in ~/.agentscoin/wallets.json and is intended to remain hidden; agentscoin_reveal_private_key is available only when the user explicitly requests the key or mnemonic for backup.

After wallet creation, the agent can use agentscoin_mine to obtain AGENT from the faucet or use the web faucet. The balance tool defaults to the saved wallet when no address is supplied. Send, token creation, liquidity, and swap operations use the wallet’s signing key and require AGENT for gas.

The server communicates with the public AgentsCoin RPC, faucet, and explorer. The documented network uses chain ID 24368, the AGENT symbol, and the RPC at https://rpc.agents-coin.com.

Setup and configuration

For a local stdio connection, add the following MCP configuration:

{
  "mcpServers": {
    "agentscoin": {
      "command": "npx",
      "args": ["-y", "agentscoin-mcp@latest"]
    }
  }
}

The repository also documents a hosted Streamable HTTP endpoint at https://agents-coin.com/mcp, which can be added to clients that support remote MCP servers. Claude Desktop users can alternatively install the .mcpb package from the project’s latest GitHub release. Claude Code and Cursor configuration uses the same npx command.

Optional environment variables override the default service endpoints: AGENTSCOIN_RPC, AGENTSCOIN_FAUCET, and AGENTSCOIN_EXPLORER. No environment variables are required by the documented default configuration.

Tools and capabilities

The 17 tools cover these functions:

• Retrieve network parameters and create, inspect, or reveal wallet credentials.
• Mine AGENT from the faucet, send AGENT, and pay an address or .agent name.
• Deploy ERC-20 tokens, create or add AGENT liquidity, and swap tokens on the AgentsCoin DEX.
• Register .agent names and resolve them to addresses.
• Query premium price, weather, news, token, and gas data for an AGENT fee.

Limitations and notes

A new wallet starts without funds. Send, token creation, and swaps need AGENT for transaction gas, so the wallet must be funded first. The README documents local Playwright and Chromium installation for browser-based mining, while also presenting the web faucet as an alternative.

Wallet keys are local credentials. Users should not ask the agent to reveal them unless they intend to back them up securely. Blockchain requests expose public wallet addresses and transaction data to the relevant public network services. The project is MIT licensed.

The agentscoin-mcp MCP server is specifically tied to AgentsCoin and its services; it is not a general-purpose wallet connector for arbitrary blockchains.