Skip to content

axiosdevs/agentscoin-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

44 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

AgentsCoin MCP 🦞

Give your AI agent its own money.

This is the official MCP server for AgentsCoin β€” an EVM blockchain where AI agents mine the native coin $AGENT themselves: no stake, no captcha, no human signup.

Add it to Claude Code, Cursor, or OpenClaw, and your agent can create a wallet, mine $AGENT, and spend it β€” autonomously, with one config.


Configuration

Add to your MCP client (Claude, Cursor, ModelScope, etc.):

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

Or connect the hosted server (Streamable HTTP):

{
  "mcpServers": {
    "agentscoin": {
      "type": "streamable_http",
      "url": "https://agents-coin.com/mcp"
    }
  }
}

How to use (in Claude Desktop)

Once installed (the extension shows Enabled Β· All requirements met), just chat with Claude β€” it calls the tools for you. No code needed.

First run

  1. "Show AgentsCoin network info" β€” confirms the connection works.
  2. "Create an AgentsCoin wallet" β€” returns an address, a privateKey (save it!), and a faucet link.
  3. Fund it (gas): open the faucet link (or https://faucet.agents-coin.com) and claim AGENT. A fresh wallet is empty, and send / create / swap all need AGENT for gas.
  4. "Check the balance of 0x…"

Create & trade a token (a pump.fun for agents)

  • "Create a token DogeAI (DOGE) on AgentsCoin using key 0x…" β†’ returns the token address + an explorer link.
  • "Add liquidity: 1000 DOGE + 5 AGENT, key 0x…"
  • "Buy token 0x… for 5 AGENT on the AgentsCoin DEX, key 0x…" Β· "Sell 100 of token 0x…"

Send β€” "Send 1 AGENT to 0x… from key 0x…"

Mine β€” "Mine AGENT to 0x…" runs the browser-PoW faucet headlessly. It needs Playwright + Chromium locally (npm i playwright && npx playwright install chromium). Easiest alternative: just claim from the web faucet.

The 17 tools

agentscoin_network_info Β· agentscoin_create_wallet Β· agentscoin_balance Β· agentscoin_send Β· agentscoin_mine Β· agentscoin_create_coin Β· agentscoin_add_liquidity Β· agentscoin_swap Β· agentscoin_register_name Β· agentscoin_resolve_name Β· agentscoin_pay Β· agentscoin_price Β· agentscoin_weather Β· agentscoin_news Β· agentscoin_token_info Β· agentscoin_gas Β· agentscoin_reveal_private_key

Notes

  • Gas first: claim AGENT from the faucet before send / create / swap.
  • Keys: create_wallet shows only the address. The private key is saved hidden in ~/.agentscoin/wallets.json and used automatically to sign β€” call agentscoin_reveal_private_key only if you explicitly need it.
  • Network: AgentsCoin Β· chainId 24368 Β· explorer https://explorer.agents-coin.com Β· DEX https://dex.agents-coin.com

What is AgentsCoin?

AgentsCoin is a public, EVM-compatible Layer-1 blockchain built for AI agents.

  • ⛏️ Agents mine the coin themselves β€” in the browser via Proof-of-Work. No stake, no captcha, no human.
  • β›½ Gas is paid in $AGENT β€” near-free, forever. No ETH required.
  • 🎁 80% of total supply is distributed to agents through the faucet.
  • 🦊 It's a normal EVM chain β€” works with MetaMask and every EVM tool.
  • πŸ”— On Chainlist β€” one-click add network: https://chainlist.org/?search=24368
  • βœ… Verified contracts β€” the token launcher + name service are verified on the explorer.
Network AgentsCoin
Chain ID 24368
RPC https://rpc.agents-coin.com
Symbol AGENT (18 decimals)
Explorer https://explorer.agents-coin.com
Faucet https://faucet.agents-coin.com

What is this MCP?

MCP (Model Context Protocol) is the open standard that lets AI agents use external tools. This server gives your agent 17 tools to use AgentsCoin.

Tool What it does
agentscoin_network_info Returns chain params (to add the network to a wallet)
agentscoin_create_wallet Creates a new wallet (address + private key)
agentscoin_balance Checks an address' $AGENT balance
agentscoin_mine Claims free $AGENT from the faucet (no browser needed)
agentscoin_send Sends $AGENT to another address
agentscoin_create_coin Deploys a new token (ERC-20) on AgentsCoin
agentscoin_add_liquidity Creates/adds an AGENT liquidity pool on the DEX
agentscoin_swap Buys/sells a token for AGENT on the DEX
agentscoin_register_name Registers a .agent name (identity); fee in AGENT
agentscoin_resolve_name Resolves a .agent name to its address
agentscoin_pay Pays another agent by .agent name
agentscoin_price Crypto price β€” pay-per-call (0.1 AGENT)
agentscoin_weather Weather β€” pay-per-call (0.1 AGENT)
agentscoin_news Top tech news β€” pay-per-call (0.1 AGENT)
agentscoin_token_info Token info β€” pay-per-call (0.1 AGENT)
agentscoin_gas Gas price β€” pay-per-call (0.1 AGENT)
agentscoin_reveal_private_key Reveals the saved wallet's key (only on request)

What happens when you give this to your agent

  1. Your agent gets a wallet. It calls agentscoin_create_wallet β†’ a fresh address + private key. No signup, no human needed.
  2. It gets $AGENT. It calls agentscoin_mine β†’ claims free $AGENT from the faucet instantly (no browser).
  3. It uses the coin. agentscoin_balance to check, agentscoin_send to pay anyone. Gas is paid in $AGENT β€” near-free.

In short: you paste one config, and your agent earns and spends its own on-chain money β€” autonomously. It costs you nothing.


Install

git clone https://github.com/axiosdevs/agentscoin-mcp
cd agentscoin-mcp
npm install

Connect as a remote server (no install, no warnings)

The easiest, safest way β€” nothing runs on your machine, so there is no "access to everything" warning:

Claude Desktop β†’ Settings β†’ Connectors β†’ Add custom connector β†’ URL:

https://agents-coin.com/mcp

Works in any MCP client that supports remote / Streamable-HTTP servers. (Use the local install below only if you specifically want it bundled offline.)

Install in Claude Desktop (one-click .mcpb)

Download agentscoin.mcpb from the latest release, then in Claude Desktop β†’ Settings β†’ Extensions drag it in (or "Install from file").

.mcpb is Claude Desktop's extension format β€” it does not open by double-clicking on a normal PC; it must be opened inside Claude Desktop. Source code is this repo; the .mcpb is just a packaged build of it.

Configure (Claude Code / Cursor)

Add to your .mcp.json (or ~/.claude.json):

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

Restart your agent β€” the 17 tools appear.

Typical flow

create_wallet  β†’  mine (faucet)  β†’  balance  β†’  send  β†’  pay  bob.agent

Is it safe?

  • The wallet your agent creates is its own. The private key is generated locally and handed to your agent; it's never sent anywhere except as signed transactions to the public RPC.
  • Mining runs in a local headless browser on your machine.
  • Gas is paid in $AGENT (which your agent mines), so it never costs you real money.
  • The code is one small, readable file (index.js) β€” open-source, MIT licensed.

Configuration (optional env vars)

Env Default
AGENTSCOIN_RPC https://rpc.agents-coin.com
AGENTSCOIN_FAUCET https://faucet.agents-coin.com
AGENTSCOIN_EXPLORER https://explorer.agents-coin.com

Links

MIT licensed. Built for the machine economy. 🦞

Privacy Policy

Full policy: https://agents-coin.com/privacy.html

  • Data collection: This extension does not collect, transmit, or store any personal data on our servers.
  • Wallet keys: Wallets are generated and stored only locally on your device (~/.agentscoin/wallets.json). We never receive your private keys. The key is shown only when you explicitly call agentscoin_reveal_private_key.
  • Network use: The extension talks to the public AgentsCoin RPC, faucet, and block explorer to read balances and broadcast transactions you initiate. Requests include your public wallet address and transaction data (public by nature of a blockchain).
  • Sharing / retention: We do not sell or share data. We retain no personal data. Local data stays on your device until you delete it.
  • Contact: contact@agents-coin.com