Zetrix MCP Server

Instructions

Implementation Reference

• src/index.ts:685-699 (registration)

  Tool registration including name, description, and input schema definition in the tools array used for ListToolsRequest.

  {
    name: "zetrix_contract_get_token_standard",
    description: "Get token standard specification (ZTP20, ZTP721, or ZTP1155)",
    inputSchema: {
      type: "object",
      properties: {
        standard: {
          type: "string",
          enum: ["ZTP20", "ZTP721", "ZTP1155"],
          description: "Token standard to get documentation for",
        },
      },
      required: ["standard"],
    },
  },

• src/index.ts:1419-1432 (handler)

  Main tool handler in the CallToolRequest switch statement. Validates arguments and delegates to zetrixContractDocs.getTokenStandard, then formats response.

  case "zetrix_contract_get_token_standard": {
    if (!args) {
      throw new Error("Missing arguments");
    }
    const docs = zetrixContractDocs.getTokenStandard(args.standard as string);
    return {
      content: [
        {
          type: "text",
          text: docs,
        },
      ],
    };
  }

• src/zetrix-contract-docs.ts:217-343 (helper)

  Helper method in ZetrixContractDocs class that provides detailed documentation strings for ZTP20, ZTP721, or ZTP1155 token standards, including methods, events, variants, and code examples.

    getTokenStandard(standard: string): string {
      if (standard === 'ZTP20') {
        return `# ZTP20 Token Standard (Fungible Tokens)
  
  ## Standard Methods
  
  ### Query Methods
  - **balanceOf(address)** - Get token balance of address
  - **totalSupply()** - Get total token supply
  - **allowance(owner, spender)** - Get approved amount
  
  ### Transaction Methods
  - **transfer(to, amount)** - Transfer tokens
  - **approve(spender, amount)** - Approve spending
  - **transferFrom(from, to, amount)** - Transfer on behalf
  
  ### Events
  \`\`\`javascript
  Chain.tlog('Transfer', from, to, amount);
  Chain.tlog('Approval', owner, spender, amount);
  \`\`\`
  
  ## Variants Available
  
  1. **ZTP20Core** - Basic fungible token
  2. **ZTP20Burnable** - Can destroy tokens
  3. **ZTP20Permit** - Gasless approvals
  4. **ZTP20Pausable** - Emergency stop functionality
  5. **ZTP20Capped** - Maximum supply limit
  
  ## Example Implementation
  
  \`\`\`javascript
  const ZTP20Core = function() {
      const self = this;
  
      self.transfer = function(to, amount) {
          const from = Chain.msg.sender;
          Utils.assert(Utils.addressCheck(to), 'Invalid address');
  
          const fromBalance = self.getBalance(from);
          const toBalance = self.getBalance(to);
  
          Utils.assert(
              Utils.int256Compare(fromBalance, amount) >= 0,
              'Insufficient balance'
          );
  
          const newFromBalance = Utils.int256Sub(fromBalance, amount);
          const newToBalance = Utils.int256Add(toBalance, amount);
  
          self.setBalance(from, newFromBalance);
          self.setBalance(to, newToBalance);
  
          Chain.tlog('Transfer', from, to, amount);
          return true;
      };
  };
  \`\`\`
  
  See SMART_CONTRACT_DEVELOPMENT.md for complete details.`;
      } else if (standard === 'ZTP721') {
        return `# ZTP721 Token Standard (Non-Fungible Tokens)
  
  ## Standard Methods
  
  ### Query Methods
  - **balanceOf(owner)** - Get NFT count of owner
  - **ownerOf(tokenId)** - Get owner of NFT
  - **getApproved(tokenId)** - Get approved address for NFT
  - **isApprovedForAll(owner, operator)** - Check operator approval
  
  ### Transaction Methods
  - **approve(to, tokenId)** - Approve NFT transfer
  - **setApprovalForAll(operator, approved)** - Approve all NFTs
  - **transferFrom(from, to, tokenId)** - Transfer NFT
  - **safeTransferFrom(from, to, tokenId, data)** - Safe transfer NFT
  
  ### Events
  \`\`\`javascript
  Chain.tlog('Transfer', from, to, tokenId);
  Chain.tlog('Approval', owner, approved, tokenId);
  Chain.tlog('ApprovalForAll', owner, operator, approved);
  \`\`\`
  
  ## Variants Available
  
  1. **ZTP721Core** - Basic NFT
  2. **ZTP721Burnable** - Destroyable NFTs
  3. **ZTP721Pausable** - Emergency stop
  4. **ZTP721Enumerable** - Token enumeration support
  
  See SMART_CONTRACT_DEVELOPMENT.md for complete details.`;
      } else if (standard === 'ZTP1155') {
        return `# ZTP1155 Token Standard (Multi-Token)
  
  ## Standard Methods
  
  ### Query Methods
  - **balanceOf(account, id)** - Get balance of token ID
  - **balanceOfBatch(accounts, ids)** - Get multiple balances
  - **isApprovedForAll(account, operator)** - Check operator approval
  
  ### Transaction Methods
  - **setApprovalForAll(operator, approved)** - Approve operator
  - **safeTransferFrom(from, to, id, amount, data)** - Transfer tokens
  - **safeBatchTransferFrom(from, to, ids, amounts, data)** - Batch transfer
  
  ### Events
  \`\`\`javascript
  Chain.tlog('TransferSingle', operator, from, to, id, value);
  Chain.tlog('TransferBatch', operator, from, to, ids, values);
  Chain.tlog('ApprovalForAll', account, operator, approved);
  \`\`\`
  
  ## Variants Available
  
  1. **ZTP1155Core** - Basic multi-token
  2. **ZTP1155Burnable** - Destroyable tokens
  3. **ZTP1155Pausable** - Emergency stop
  4. **ZTP1155Supply** - Track total supply per ID
  5. **ZTP1155URIStorage** - Token metadata URIs
  
  See SMART_CONTRACT_DEVELOPMENT.md for complete details.`;
      }
      return 'Unknown token standard';
    }