Skip to main content
Glama

x402-nft-metadata

NFT Metadata: Reads an ERC-721 or ERC-1155 token URI on Base or Ethereum via eth_call, trying tokenURI then uri selectors 🆓 5 free trial calls per signed wallet

Input Schema

NameRequiredDescriptionDefault
idNo
chainNo
tokenNo
addressNo
tokenIdNo
contractNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed6 schema fields changed
    • removedInput schema / properties / address / description
      Removed value: -"Address to process"
    • removedInput schema / properties / chain / description
      Removed value: -"Chain to process"
    • removedInput schema / properties / contract / description
      Removed value: -"Contract to process"
    • removedInput schema / properties / id / description
      Removed value: -"Id to process"
    • removedInput schema / properties / token / description
      Removed value: -"Token to process"
    • removedInput schema / properties / tokenId / description
      Removed value: -"TokenId to process"
  2. First observed

TDQS

C2.9/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden and does disclose useful behavior: the eth_call mechanism, the tokenURI-then-uri selector fallback, and the payment/rate model ('5 free trial calls per signed wallet'). It still omits failure behavior, whether it returns parsed metadata or a raw URI, and any auth/signing requirement details beyond the trial mention.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single front-loaded sentence that leads with the purpose and keeps the selector/mechanism detail secondary. Efficient overall, with only the trial-calls emoji line adding promotional weight.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 6-parameter on-chain read tool with no annotations, no output schema, and 0% parameter coverage, the description is under-specified: it does not say what is returned (raw URI vs metadata JSON), how errors are surfaced, or what each identifier parameter should contain.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% and the description explains none of the 6 parameters. Ambiguous names like 'id', 'token', 'address', 'tokenId', and 'contract' overlap and are not disambiguated, so an agent must guess which identifier to supply; only the chain values (Base/Ethereum) are weakly implied.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource: reads an ERC-721/ERC-1155 token URI via eth_call on Base or Ethereum, including the selector fallback order. It is clear about standards and chains, but does not explicitly distinguish itself from adjacent siblings like x402-erc721-info, x402-erc1155-info, or x402-nft-owner, which an agent could easily confuse with this tool.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage ('read a token URI on Base or Ethereum') but gives no explicit when-to-use vs alternatives, no prerequisites, and no guidance on which of the 6 parameters are needed even though 0 are marked required. An agent has no help deciding between this and sibling contract/token-info tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources