Ashfields MCP Server

io.github.smoke711711Published by GitHub account smoke711711v1.0.0Updated Oct 24, 2026

Burn $ASH to mint on-chain NFTs on Ethereum. No browser. Two agent tool calls.

VerifiedSTDIODesktop onlyFinanceDeveloper Tools

Overview

AI-generated overview

A local MCP server that lets an assistant check an Ethereum wallet and mint Ashfields NFTs by burning $ASH tokens, with no browser needed.

What you can do
Read mint status: price per token, total minted, remaining supply and contract addresses, plus whether minting is active and per-transaction limits. Check the configured wallet: address, $ASH balance, ETH balance, $ASH allowance and how many tokens it can mint now. Approve $ASH spending for the Ashfields contract and wait for on-chain confirmation. Mint Ashfields NFTs, auto-approving if needed, and return token IDs, burned amount, transaction hashes and OpenSea links. Trigger the permissionless royalty distribution call on the RoyaltyDistributor contract.
When to use it
Use it when you want an assistant to inspect an Ethereum wallet's $ASH and ETH balances and mint Ashfields NFTs directly from a chat, without opening a browser or signing manually. It suits users who already hold $ASH and want a scripted, two-call mint flow.
Requirements
Runs locally via npx or a cloned npm package; Node.js 18 or newer. Needs a wallet private key supplied through the WALLET_PRIVATE_KEY environment variable, and optionally ETH_RPC_URL for an Ethereum RPC endpoint (defaults to a public node). The wallet needs at least 100,000 $ASH per token plus roughly 0.001 ETH for gas. Desktop client only; no authentication is declared.
Before you install
The server needs the wallet's private key in WALLET_PRIVATE_KEY, so anyone with access to that environment can sign transactions and move funds. Minting permanently burns 100,000 $ASH per token and spends ETH on gas; approve_ash grants the contract an allowance. trigger_distribute sends a transaction that splits royalty ETH. Transactions are irreversible and go to Ethereum mainnet contracts.

Installation

In SourceWeft

  1. Open Ashfields MCP Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

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

Or via npx (no clone needed):

bash
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

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

ArgTypeRequired
———

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.

ArgTypeRequired
———

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.

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

ArgTypeRequiredDescription
quantitynumberyesTokens to mint (1–5 per transaction).

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

Example response:

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.

ArgTypeRequired
———

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)

ContractAddress
Ashfields NFT (ASHF)0x068FB5Ac232462f642F34B2bAa81750Cc2F00DAA
$ASH Token0x7e6aed913DEAA38A486514AD75Bdf8E48Fa74a17
RoyaltyDistributor0xF3b4063958dB5814E31aA745FbbfD4c0006E52A6

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

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

Links


License

MIT © 2025 smoke711711

Source: README.md at commit fbd1abb

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts