get_nft_instance_info
Retrieve detailed information about specific NFT instances by providing token address and instance ID for blockchain analysis and data verification.
Instructions
Get NFT instance information
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| token | Yes | The token address | |
| instance_id | Yes | The instance ID |
Implementation Reference
- index.js:488-505 (registration)Registration of the 'get_nft_instance_info' tool in the ListToolsRequestSchema handler, including its description and input schema definition.{ name: 'get_nft_instance_info', description: 'Get NFT instance information', inputSchema: { type: 'object', properties: { token: { type: 'string', description: 'The token address', }, instance_id: { type: 'string', description: 'The instance ID', }, }, required: ['token', 'instance_id'], }, },
- index.js:754-756 (handler)The handler logic in the handleToolCall switch statement that destructures arguments and makes an API request to retrieve NFT instance information from ChainFetch.case 'get_nft_instance_info': const { token: nftToken, instance_id } = args; return await this.makeRequest(`/api/v1/ethereum/token-instances/${nftToken}/${instance_id}`, 'GET', {}, null, token);
- index.js:491-503 (schema)Input schema definition for the 'get_nft_instance_info' tool, specifying required 'token' and 'instance_id' parameters.inputSchema: { type: 'object', properties: { token: { type: 'string', description: 'The token address', }, instance_id: { type: 'string', description: 'The instance ID', }, }, required: ['token', 'instance_id'],
- index.js:634-682 (helper)General helper method 'makeRequest' used by the handler to perform authenticated API calls to the ChainFetch service.async makeRequest(endpoint, method = 'GET', params = {}, body = null, token = null) { const chainfetchToken = token || process.env.CHAINFETCH_API_TOKEN; if (!chainfetchToken) { throw new McpError( ErrorCode.InvalidRequest, 'CHAINFETCH_API_TOKEN is required' ); } const url = new URL(`${API_BASE_URL}${endpoint}`); // Add query parameters for GET requests if (method === 'GET' && Object.keys(params).length > 0) { Object.entries(params).forEach(([key, value]) => { if (value !== undefined && value !== null) { if (Array.isArray(value)) { value.forEach(v => url.searchParams.append(`${key}[]`, v)); } else { url.searchParams.append(key, value.toString()); } } }); } const fetchOptions = { method, headers: { 'Authorization': `Bearer ${chainfetchToken}`, 'Content-Type': 'application/json', }, }; if (body && method !== 'GET') { fetchOptions.body = JSON.stringify(body); } const response = await fetch(url.toString(), fetchOptions); if (!response.ok) { const errorText = await response.text(); throw new McpError( ErrorCode.InternalError, `API request failed: ${response.status} ${response.statusText} - ${errorText}` ); } return await response.json(); }