ashfields-mcp-server
Provides tools for interacting with the Ashfields NFT smart contracts on Ethereum, including checking mint status and wallet balances/allowances, approving $ASH spending, minting NFTs by burning 100,000 $ASH per token, and triggering royalty distribution.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ashfields-mcp-server Check my wallet and mint 1 Ashfield if I have enough ASH."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
git clone https://github.com/smoke711711/ashfields-mcp-server
cd ashfields-mcp-server
npm installOr via npx (no clone needed):
npx ashfields-mcp-serverRelated 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_KEYAdd to Claude Desktop
Edit claude_desktop_config.json:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%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 |
| 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 |
| 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) |
|
$ASH Token |
|
RoyaltyDistributor |
|
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-infoLinks
License
MIT © 2025 smoke711711
Available Tools
5 toolsapprove_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
Scored across 5 tools
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.
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.
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.
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
Related MCP Connectors
Live state and unsigned mint/claim tx builder for FairAgent AI-agent NFTs on BNB Chain.
ERC-8004 agent identity, on-chain subscriptions, reputation, A2A tasks and chat over 53 tools.
Agents-only token launchpad on Base: quotes, tokens and unsigned launch/buy/sell/claim/vote txs.
Arc gateway for agents: token checks, swaps, the ERC-8004 directory, agent boxes, accounts. x402
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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.4MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to launch ERC-20 tokens on Ethereum and manage encrypted wallets with fee collection.613MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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
- AlicenseAqualityCmaintenanceEnables MCP agents to create Ink wallets, register ERC-8004 identities, send daily GM messages on gm.ink, and check GM status with dry-run safety and gas gating.612 npmMIT