English Français العربية

NFT Metadata API

Registre officiel Médias et design

Fetch NFT metadata — name, image, traits from contract+tokenId. x402 micropayment.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (sse)
Claude Code 
claude mcp add --transport sse nft-metadata-api 'https://nft-metadata.api.klymax402.com/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "nft-metadata-api": {
            "type": "sse",
            "url": "https://nft-metadata.api.klymax402.com/mcp"
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. NFT Metadata API
  2. Quickstart -- MCP
  3. Quickstart -- HTTP (x402)
  4. Tools
  5. Example agent prompts
  6. Payment
  7. Part of klymax402
  8. License

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

ToolMethodPathPriceDescription
crypto_get_nft_metadataPOST/api/metadata$0.008Fetch 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

NameTypeRequiredDescription
contractstringyesNFT contract address (e.g. 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D)
tokenIdstringyesToken ID within the contract
chainstringnoBlockchain: 'ethereum' or 'base' (default: ethereum)

Returns

  • name -- NFT token name
  • description -- token description text
  • imageUrl -- URL to the NFT image/media
  • attributes -- array of trait objects with trait_type and value
  • collection -- collection name and contract info
  • tokenStandard -- ERC-721 or ERC-1155
  • chain -- 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.

License

MIT

Questions fréquentes

Qu'est-ce que NFT Metadata API ?

Fetch NFT metadata — name, image, traits from contract+tokenId. x402 micropayment.

Comment installer NFT Metadata API ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport sse nft-metadata-api 'https://nft-metadata.api.klymax402.com/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour NFT Metadata API ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

NFT Metadata API est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient NFT Metadata API ?

Il est publié par Br0ski777. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.