MCP ATP

• Package: @iqai/mcp-atp
• Purpose: Interact with the IQ AI Agent Tokenization Platform
• Example: 🚀 MCP-ATP Agent Example

Usage with ADK TypeScript

import {McpAtp} from "@iqai/adk";

const toolset = McpAtp({
  env: {
    ATP_WALLET_PRIVATE_KEY: process.env.WALLET_PRIVATE_KEY,
    ATP_API_KEY: process.env.ATP_API_KEY,
  },
})
const tools = await toolset.getTools()

import {McpToolset} from "@iqai/adk";

const toolset = new McpToolset({
  name: "ATP MCP Client",
  description: "Client for the @iqai/mcp-atp server",
  transport: {
    mode: "stdio",
    command: "pnpm",
    args: ["dlx", "@iqai/mcp-atp"],
    env: {
      ATP_WALLET_PRIVATE_KEY: process.env.WALLET_PRIVATE_KEY,
      ATP_API_KEY: process.env.ATP_API_KEY,
      PATH: process.env.PATH || "",
    },
  },
})

const tools = await toolset.getTools()

{
  "mcpServers": {
    "atp-server": {
      "command": "pnpm",
      "args": ["dlx", "@iqai/mcp-atp"],
      "env": {
        "ATP_WALLET_PRIVATE_KEY": "your_wallet_private_key_here",
        "ATP_API_KEY": "your_iq_atp_api_key_here"
      }
    }
  }
}

Features

• Interact with the IQ AI Agent Tokenization Platform
• Fetch statistics and details for a specific AI agent
• Retrieve the user's current holdings in ATP AI tokens
• Purchase AI agent tokens using IQ as the base currency
• Sell AI agent tokens back to the protocol
• Retrieve logs for a specific AI agent, with pagination
• Add a new log entry for a specific AI agent

Available Tools

ATP_AGENT_STATS

Fetch statistics and details for a specific AI agent:

• Parameters: tokenContract (string)

ATP_GET_AGENT_POSITIONS

Retrieve the user's current holdings in ATP AI tokens:

• Requires: ATP_WALLET_PRIVATE_KEY

ATP_BUY_AGENT

Purchase AI agent tokens using IQ as the base currency:

• Parameters: tokenContract (string), amount (string)
• Requires: ATP_WALLET_PRIVATE_KEY

ATP_SELL_AGENT

Sell AI agent tokens back to the protocol:

• Parameters: tokenContract (string), amount (string)
• Requires: ATP_WALLET_PRIVATE_KEY

ATP_GET_AGENT_LOGS

Retrieve logs for a specific AI agent, with pagination:

• Parameters: agentTokenContract (string), page (number, optional), limit (number, optional)

ATP_ADD_AGENT_LOG

Add a new log entry for a specific AI agent:

• Parameters: agentTokenContract (string), content (string), apiKey (string), txHash (string, optional), chainId (number, optional)

Environment Variables

• ATP_WALLET_PRIVATE_KEY: Required for position and trading operations
• ATP_API_KEY: Required for certain backend API calls

Usage Examples

• "Add log for agent 0x1234...5678: Just executed weekly yield distribution"
• "Create log entry for Frax God: Updated pricing model" (Works only if token contract found in previous messages)
• "Log for agent 0x1234...5678 with transaction hash 0xabc...def: Distribution complete"

Response Format

Actions return structured responses including:

✔ Transaction status & hash (for trades) 🔗 ✔ Formatted token amounts 💲 ✔ Error messages when applicable ⚠ ✔ Agent addresses and statistics 🏷 ✔ Formatted agent logs 📄

Error Handling

🚨 Invalid token contracts 💸 Insufficient balances 🔄 Transaction failures 🌐 Network issues 🛑 Input validation errors 🔑 Missing API key for log creation