Summary
Pulls NFT metadata directly from blockchain contracts using contract address and token ID. You get back the token name, image URL, and trait attributes without manually parsing contract calls or hitting multiple endpoints. Runs as a remote server over SSE and uses x402 micropayments, so you pay per request instead of managing API keys or rate limits. Useful when you're building NFT tooling, portfolio trackers, or marketplace features and need quick metadata lookups without spinning up your own indexer. The repository is minimal with no README, so you're working from the server definition and endpoint alone.
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Tools
Public tool metadata for what this MCP can expose to an agent.
1 tools
crypto_get_nft_metadataUse this when you need to fetch metadata for a specific NFT by contract address and token ID. Returns full NFT details in JSON. 1. name: NFT token name 2. description: token description text 3. image3 params
Use this when you need to fetch metadata for a specific NFT by contract address and token ID. Returns full NFT details in JSON. 1. name: NFT token name 2. description: token description text 3. image
Parameters* required
chainstringBlockchain: 'ethereum' or 'base' (default: ethereum)
contractstringNFT contract address (e.g. 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D)
tokenIdstringToken ID within the contract
NFT Metadata API
NFT metadata lookup -- name, image, attributes, collection info from contract + token ID. Ethereum and Base. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.
Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.
Quickstart -- MCP
Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):
{
"mcpServers": {
"nft-metadata": {
"url": "https://nft-metadata.api.klymax402.com/mcp"
}
}
}
Quickstart -- HTTP (x402)
curl -X POST "https://nft-metadata.api.klymax402.com/api/metadata" \
-H "Content-Type: application/json" \
-d '{"contract":"...","tokenId":"..."}'
# -> 402 Payment Required, with an x402 payment challenge in the response body
Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.
Tools
| Tool | Method | Path | Price | Description |
|---|---|---|---|---|
crypto_get_nft_metadata | POST | /api/metadata | $0.008 | Fetch NFT metadata from contract and token ID |
crypto_get_nft_metadata
Use this when you need to fetch metadata for a specific NFT by contract address and token ID. Returns full NFT details in JSON.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
contract | string | yes | NFT contract address (e.g. 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D) |
tokenId | string | yes | Token ID within the contract |
chain | string | no | Blockchain: 'ethereum' or 'base' (default: ethereum) |
Returns
name-- NFT token namedescription-- token description textimageUrl-- URL to the NFT image/mediaattributes-- array of trait objects with trait_type and valuecollection-- collection name and contract infotokenStandard-- ERC-721 or ERC-1155chain-- which blockchain the NFT is on
Example response:
{"name":"Bored Ape #1234","description":"A unique digital collectible...","imageUrl":"ipfs://Qm...","attributes":[{"trait_type":"Background","value":"Blue"},{"trait_type":"Fur","value":"Gold"}],"collection":"BoredApeYachtClub","tokenStandard":"ERC-721","chain":"ethereum"}
When to use: NFT verification, display, and trait analysis. Essential for NFT marketplace agents and collection tools.
Not for: wallet balances (use wallet_get_portfolio), ENS resolution (use crypto_resolve_ens), token safety (use token_check_safety).
Example agent prompts
- "Fetch metadata for a specific NFT by contract address and token ID"
Payment
- Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key
- Network: Base L2 (
eip155:8453) - Asset: USDC
- Facilitator: Coinbase CDP (primary), PayAI (fallback)
- Also reachable via ATXP (OAuth-wrapped x402, RFC 9728 protected-resource metadata)
Part of klymax402
100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.
- Catalog: https://klymax402.com/llms.txt
- Full API reference: https://klymax402.com/llms-full.txt
- Live stats: https://klymax402.com/stats
License
MIT
Featured
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
