punks.generated.eth MCP

An MCP server for the punks.generated.eth generative art collection on Ethereum. It allows agents to query mint status, quote prices, generate unsigned mint transactions, retrieve token metadata, register punk identities as ERC-8004 agents, and facilitate peer-to-peer trading via Seaport.

Visit punks.generated.eth

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Community listingStreamable HTTPNo sign-inEndpoint checked 2026-11-01Published by punks.generated.eth

MCP endpoint (Streamable HTTP)

https://punks-generated-eth.enspiration-eth.workers.dev/mcp

Vendor documentation

What you can do with it

Generate unsigned mint transactions for generative punks
Retrieve token metadata and images
Register a punk as an ERC-8004 agent identity
Facilitate peer-to-peer trading on Seaport

Source and maintenance

Community listingRegistry 0.2.0

mcp-registry: io.github.enspiration-eth/punks-generated@0.2.0 Project website

Protocol and capabilities

Server: punks.generated.eth 0.1.0
MCP protocol: 2025-06-18
Tools: 14 advertised
Resources: Not advertised
Resource templates: Not advertised
Prompts: Not advertised

Server-advertised capabilities

{
  "tools": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Read tools are free. mint, accept and cancel_order return unsigned txs you sign yourself. list_punk and make_offer return Seaport typed data you sign, then submit_order.

Tools

14 advertised

get_status

Advertised by the server during the last successful anonymous check.

Price, supply and contract for punks.generated.eth.

get_status input schema

{
  "type": "object",
  "properties": {}
}

quote_mint

Advertised by the server during the last successful anonymous check.

Total price in wei for qty punks.

quote_mint input schema

{
  "type": "object",
  "required": [
    "qty"
  ],
  "properties": {
    "qty": {
      "type": "integer",
      "maximum": 10,
      "minimum": 1
    }
  }
}

mint

Advertised by the server during the last successful anonymous check.

Unsigned mint(qty) transaction plus the x402 URL. The caller signs and sends it, and the punks go to the sending wallet (msg.sender). This server never holds keys or funds. mint(qty) mints to msg.sender. Gas: about 111k units for mint(1) (measured on mainnet), more for each extra punk; about 175k for a free claim. Always run estimateGas, gas price varies.

mint input schema

{
  "type": "object",
  "required": [
    "qty"
  ],
  "properties": {
    "qty": {
      "type": "integer",
      "maximum": 10,
      "minimum": 1
    },
    "from": {
      "type": "string",
      "description": "optional: the wallet you will send from. Only copied into the tx for convenience; the punks always go to the actual sender."
    }
  }
}

confirm_mint

Advertised by the server during the last successful anonymous check.

Check a sent mint tx hash and return the token ids it minted.

confirm_mint input schema

{
  "type": "object",
  "required": [
    "txHash"
  ],
  "properties": {
    "txHash": {
      "type": "string"
    }
  }
}

get_token

Advertised by the server during the last successful anonymous check.

Owner, traits, seed, image, subname for a token id.

get_token input schema

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "minimum": 1
    }
  }
}

erc8004_register_punk

Advertised by the server during the last successful anonymous check.

ERC-8004 registration file for the owner's agent, using punk #id as its image and id.punks.generated.eth as its ENS name, plus the unsigned register tx for the owner to send.

erc8004_register_punk input schema

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "minimum": 1
    },
    "mcp": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "description": {
      "type": "string"
    }
  }
}

list_punk

Advertised by the server during the last successful anonymous check.

Seaport 1.6 listing for punk #id at an ETH price: EIP-712 typed data for the owner to sign (free), plus the one-time setApprovalForAll tx to the Seaport conduit if missing. Then submit_order.

list_punk input schema

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "minimum": 1
    },
    "seller": {
      "type": "string"
    },
    "priceEth": {
      "type": "string",
      "description": "e.g. \"0.05\""
    },
    "priceWei": {
      "type": "string"
    },
    "expiresInSeconds": {
      "type": "integer",
      "maximum": 31536000,
      "minimum": 60,
      "description": "default 7 days"
    }
  }
}

make_offer

Advertised by the server during the last successful anonymous check.

Seaport 1.6 WETH offer on punk #id, or a collection-wide offer on any punk if id is omitted. Returns typed data to sign plus WETH wrap/approve txs if needed. Then submit_order.

make_offer input schema

{
  "type": "object",
  "required": [
    "buyer"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "minimum": 1,
      "description": "omit for a collection offer"
    },
    "buyer": {
      "type": "string"
    },
    "priceEth": {
      "type": "string"
    },
    "priceWei": {
      "type": "string"
    },
    "expiresInSeconds": {
      "type": "integer",
      "maximum": 31536000,
      "minimum": 60
    }
  }
}

submit_order

Advertised by the server during the last successful anonymous check.

Publish a signed listing or offer. Verifies the signature (EOA or ERC-1271), ownership, conduit approval, WETH balance and allowance before storing it.

submit_order input schema

{
  "type": "object",
  "required": [
    "order",
    "signature"
  ],
  "properties": {
    "order": {
      "type": "object",
      "description": "the order (OrderComponents) from list_punk / make_offer"
    },
    "signature": {
      "type": "string"
    }
  }
}

get_market

Advertised by the server during the last successful anonymous check.

Live listings (cheapest first), offers incl. collection offers (highest first) and recent sales, for punk #id (with its traits) or the whole collection. Every order is re-checked on-chain; stale ones are skipped.

get_market input schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "minimum": 1
    }
  }
}

accept

Advertised by the server during the last successful anonymous check.

Unsigned Seaport fulfillAdvancedOrder tx to buy a listing or sell into an offer (tokenId required for a collection offer), simulated, plus any approvals the fulfiller still needs.

accept input schema

{
  "type": "object",
  "required": [
    "orderHash",
    "fulfiller"
  ],
  "properties": {
    "tokenId": {
      "type": "integer",
      "minimum": 1
    },
    "fulfiller": {
      "type": "string"
    },
    "orderHash": {
      "type": "string"
    }
  }
}

cancel_order

Advertised by the server during the last successful anonymous check.

Unsigned Seaport cancel tx for one of your orders. Only the offerer can send it.

cancel_order input schema

{
  "type": "object",
  "required": [
    "orderHash"
  ],
  "properties": {
    "orderHash": {
      "type": "string"
    }
  }
}

leave_feedback

Advertised by the server during the last successful anonymous check.

Optional, after a mint: unsigned ERC-8004 Reputation Registry giveFeedback tx rating this agent 0 to 100 (tag1 starred). Only send it if your wallet owner agrees. Costs gas, no ETH goes to us.

leave_feedback input schema

{
  "type": "object",
  "required": [
    "score"
  ],
  "properties": {
    "from": {
      "type": "string",
      "description": "wallet that will send it (must not be the agent owner)"
    },
    "tag2": {
      "type": "string",
      "description": "what you rate, default mint"
    },
    "score": {
      "type": "integer",
      "maximum": 100,
      "minimum": 0
    }
  }
}

resolve_subname

Advertised by the server during the last successful anonymous check.

Resolve <id>.punks.generated.eth (or any ENS name) to address, avatar and url.

resolve_subname input schema

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string"
    }
  }
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks: 1 of 1 (100%)
Average latency: 320 ms
95th percentile latency: 320 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

Nov 1, 2026, 7:57 PM UTC · probe · passed · 320 ms · metadata changed · 14 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.

Claude Code configuration

claude mcp add --transport http punks-generated-eth-mcp https://punks-generated-eth.enspiration-eth.workers.dev/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).

Codex configuration

codex mcp add punks-generated-eth-mcp --url https://punks-generated-eth.enspiration-eth.workers.dev/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable punks-generated-eth-mcp in your MCP settings.

Cursor configuration

{
  "mcpServers": {
    "punks-generated-eth-mcp": {
      "url": "https://punks-generated-eth.enspiration-eth.workers.dev/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).

Cline configuration

{
  "mcpServers": {
    "punks-generated-eth-mcp": {
      "type": "streamableHttp",
      "url": "https://punks-generated-eth.enspiration-eth.workers.dev/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start punks-generated-eth-mcp and inspect its tools.

VS Code configuration

{
  "servers": {
    "punks-generated-eth-mcp": {
      "type": "http",
      "url": "https://punks-generated-eth.enspiration-eth.workers.dev/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.

Gemini CLI configuration

gemini mcp add --transport http punks-generated-eth-mcp https://punks-generated-eth.enspiration-eth.workers.dev/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.

Claude Desktop configuration

{
  "mcpServers": {
    "punks-generated-eth-mcp": {
      "url": "https://punks-generated-eth.enspiration-eth.workers.dev/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.

Windsurf configuration

{
  "mcpServers": {
    "punks-generated-eth-mcp": {
      "serverUrl": "https://punks-generated-eth.enspiration-eth.workers.dev/mcp"
    }
  }
}

Let your agent find its tools

Find servers like punks.generated.eth MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows