Ashfields MCP Server

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

bash

git clone https://github.com/smoke711711/ashfields-mcp-server
cd ashfields-mcp-server
npm install

Or via npx (no clone needed):

Terminal

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

server.ts

export WALLET_PRIVATE_KEY=0xYOUR_PRIVATE_KEY
# Optional — defaults to a public Ethereum node
export 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

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.

Arg	Type	Required
—	—	—

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.

Arg	Type	Required
—	—	—

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.

Arg	Type	Required	Description
`quantity`	number	yes	Tokens to approve for (1–5). Approves quantity × 100,000 ASH.

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).

Arg	Type	Required	Description
`quantity`	number	yes	Tokens to mint (1–5 per transaction).

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

Example response:

config.json

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

Arg	Type	Required
—	—	—

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)

Contract	Address
Ashfields NFT (ASHF)	`0x068FB5Ac232462f642F34B2bAa81750Cc2F00DAA`
$ASH Token	`0x7e6aed913DEAA38A486514AD75Bdf8E48Fa74a17`
RoyaltyDistributor	`0xF3b4063958dB5814E31aA745FbbfD4c0006E52A6`

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