Ashfields MCP Server

Ashfields MCP Server

[MIT License] [npm] [MCP]

The first MCP server that burns an ERC-20 token to mint an NFT. Approve $ASH, call mint() — 100,000 tokens permanently destroyed, fully on-chain animated SVG appears on Ethereum. No ETH payment. No browser. Two contract calls from any agent.

Ashfields — 10,000 fully on-chain animated SVG NFTs. Minting burns 100,000 $ASH permanently. Earn $ASH by burning dead NFTs on deadjpg.lol.

Installation

git clone https://github.com/smoke711711/ashfields-mcp-servercd ashfields-mcp-servernpm install

Or via npx (no clone needed):

npx ashfields-mcp-server

Requirements

• Node.js 18+
• A wallet with:
  • Enough $ASH to mint (100,000 $ASH per token)
  • A small amount of ETH for gas (~0.001 ETH per mint)

Configuration

export WALLET_PRIVATE_KEY=0xYOUR_PRIVATE_KEY# Optional — defaults to a public Ethereum nodeexport ETH_RPC_URL=https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY

Add to Claude Desktop

Edit claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{  "mcpServers": {    "ashfields": {      "command": "node",      "args": ["/absolute/path/to/ashfields-mcp-server/index.js"],      "env": {        "WALLET_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY",        "ETH_RPC_URL": "https://ethereum.publicnode.com"      }    }  }}

Restart Claude Desktop — the tools will appear automatically.

Available Tools

get_mint_info

Returns current mint status: price per token, total minted, remaining supply, whether minting is active, and contract addresses.

Returns: { mintActive, totalMinted, remainingSupply, pricePerToken, priceFormatted, maxPerTransaction, contracts }

check_wallet

Returns the configured wallet address, $ASH balance, ETH balance, current $ASH allowance for the Ashfields contract, and how many tokens it can mint right now.

Returns: { walletAddress, ashBalance, ashAllowance, ethBalance, canMintThisTx, needsApproval }

approve_ash

Approves the Ashfields contract to spend $ASH from the wallet. Waits for on-chain confirmation. Only needed if allowance is insufficient — mint_ashfield handles this automatically.

Returns: { status, approved, forTokens, wallet, txHash, etherscan }

mint_ashfield

Full mint flow: checks allowance, auto-approves if needed, mints, waits for confirmation. Returns minted token IDs and OpenSea link. Burns 100,000 $ASH per token permanently (sent to 0xdead).

Returns: { status, minted, ashBurned, tokenIds, wallet, approvalTx, mintTx, etherscan, opensea }

Example response:

{  "status": "success",  "minted": 2,  "ashBurned": "200,000 ASH",  "tokenIds": ["8377", "220"],  "approvalTx": "0xfc33...",  "mintTx": "0xe2e0...",  "etherscan": "https://etherscan.io/tx/0xe2e0...",  "opensea": "https://opensea.io/collection/ashfields-lol"}

trigger_distribute

Calls distribute() on the RoyaltyDistributor contract. Permissionless — any wallet can trigger this at any time. Splits accumulated royalty ETH: 1% creator · 1% $ASH team · 8% Uniswap buyback → burned to 0xdead. Requires ≥ 0.005 ETH in the distributor.

Returns: { status, txHash, etherscan, note }

Example Agent Prompt

"Check my wallet balance, verify I have enough $ASH to mint 2 Ashfields, then mint them and return the token IDs and OpenSea links."

Contract Addresses (Ethereum Mainnet)

Security

• Private key is read from environment variables only — never passed as a tool argument
• Server communicates via stdio — no network port is opened
• Only the configured wallet can sign transactions
• trigger_distribute() is permissionless by contract design — safe for any wallet to call

Machine-Readable Spec

curl https://ashfields-mint.vercel.app/api/mint-info

Links

• Mint site & MCP docs
• OpenSea collection
• Etherscan — Ashfields contract
• deadjpg.lol — earn $ASH

License

MIT © 2025 smoke711711