Skip to main content
Glama

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-server
cd ashfields-mcp-server
npm install

Or via npx (no clone needed):

npx ashfields-mcp-server

Related MCP server: Vibecoins MCP

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

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

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

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


License

MIT © 2025 smoke711711

Available Tools

5 tools
approve_ashA

Approves the Ashfields contract to spend $ASH tokens from the configured wallet. Submits the approval transaction and waits for on-chain confirmation. Required before minting if the current allowance is insufficient.

Inputs: quantity (required).

check_walletA

Returns the configured wallet address, its $ASH token balance, its current $ASH allowance for the Ashfields contract, and its ETH balance for gas. Also reports the maximum number of tokens it can mint right now.

Inputs: no named parameters.

get_mint_infoA

Returns current Ashfields mint status: price per token, total minted so far, remaining supply, whether minting is currently active, and contract addresses. Call this first to confirm minting is open before attempting a mint.

Inputs: no named parameters.

mint_ashfieldA

Mints one or more Ashfields NFTs. Automatically approves $ASH if the current allowance is insufficient, then submits the mint transaction and waits for confirmation. Returns the minted token IDs and OpenSea links. Burns 100,000 $ASH per token permanently (sent to 0xdead).

Inputs: quantity (required).

trigger_distributeA

Calls distribute() on the RoyaltyDistributor contract. Permissionless — any wallet can trigger this at any time. Splits accumulated royalty ETH: 1% to creator, 1% to $ASH team, 8% buys $ASH on Uniswap and burns it to 0xdead. Requires at least 0.005 ETH in the distributor to execute.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct action: reading mint status, checking wallet state, approving spending, minting, and triggering distribution. The only slight overlap is approve_ash versus mint_ashfield's auto-approve, but both are clearly differentiated by purpose.

    Naming Consistency4/5

    All tool names follow a verb_noun pattern and use snake_case consistently. Minor inconsistency exists between get_mint_info and check_wallet, both of which are informational but use different verbs; overall the pattern is predictable.

    Tool Count5/5

    Five tools is well-scoped for a focused NFT minting and royalty distribution server. Each tool maps to an essential step in the workflow without unnecessary bloat.

    Completeness4/5

    The core minting flow is fully covered: check status, inspect wallet, approve, mint, and distribute royalties. A minor gap is the lack of a dedicated way to query the RoyaltyDistributor's balance or distribution status, which would require external verification.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to trigger on-chain minting of $SHIT tokens via EIP-7702 delegation and MCP, with the user retaining full custody and the contract ensuring tokens go to the caller's own wallet.
      4
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to mint and manage ERC-8004 identities on Arc through free self-minting from their own wallet or paid x402 minting, including drafting registration files, confirming on-chain registration, editing owner-signed files, and checking status.
      MIT