# agentscoin-mcp [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/axiosdevs/agentscoin-mcp  
**GitHub Stars:** 4  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/agentscoin-mcp

## Description
Give your AI agent a wallet on AgentsCoin: create wallet, mine AGENT, check balance, send.

## Tools
Capabilities this server exposes over MCP:

- **agentscoin_network_info** — Get AgentsCoin network parameters (chainId, RPC, symbol, explorer). Use to add the network to MetaMask or any EVM wallet.
- **agentscoin_create_wallet** — Create a new AgentsCoin wallet for the agent. IMPORTANT: the private key is saved locally and kept hidden — do NOT display it. Show ONLY the address. The key is used automatically for send/create/swap. Reveal it only via agentscoin_reveal_private_key when the user explicitly asks.
- **agentscoin_reveal_private_key** — Reveal and back up the saved private key + mnemonic. ONLY call this when the user EXPLICITLY asks to see / export / back up their key. Then warn them to keep it secret.
- **agentscoin_balance** — Check the AGENT balance of an address (defaults to your saved wallet).
- **agentscoin_send** — Send AGENT from your wallet to another address.
- **agentscoin_mine** — Get AGENT from the faucet (defaults to your saved wallet). Works instantly in chat, no browser. Use to fund a fresh wallet for gas.
- **agentscoin_create_coin** — Deploy a new token (ERC-20) on AgentsCoin. Returns the token address.
- **agentscoin_add_liquidity** — Create or add an AGENT liquidity pool for a token on the AgentsCoin DEX.
- **agentscoin_swap** — Buy or sell a token for AGENT on the AgentsCoin DEX.
- **agentscoin_price** — Get a live crypto price (premium data API). Costs 0.1 AGENT per call, paid automatically from your saved wallet.
- **agentscoin_register_name** — Register a .agent name pointing to an address (costs 1 AGENT). Name: lowercase a-z 0-9 and -, 3-32 chars.
- **agentscoin_resolve_name** — Resolve a .agent name to its address (free, read-only).
- **agentscoin_pay** — Pay AGENT to another agent by its .agent name (or a 0x address). Resolves the name, then sends. This is how agents pay each other.
- **agentscoin_weather** — Get current weather for a city (premium data, Open-Meteo). Costs 0.1 AGENT.
- **agentscoin_news** — Get top tech/startup news (premium data, Hacker News). Costs 0.1 AGENT.
- **agentscoin_token_info** — Look up a crypto token price/liquidity (premium data, DexScreener). Costs 0.1 AGENT.
- **agentscoin_gas** — Get current gas price on Ethereum mainnet + AgentsCoin (premium data). Costs 0.1 AGENT.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## 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:

```json
{
  "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.

_Full upstream README: https://allmcps.com/mcp/agentscoin-mcp/readme_

