🤖 MCP-ATP: Agent Tokenization Platform

📖 Overview

The MCP-ATP Server enables AI agents to interact with IQ AI's Agent Tokenization Platform (ATP). This server provides comprehensive access to agent statistics, token positions, trading functionalities, and agent logs.

By implementing the Model Context Protocol (MCP), this server allows Large Language Models (LLMs) to discover AI agents, analyze agent performance, trade agent tokens, and manage agent logs directly through their context window, bridging the gap between AI and decentralized agent tokenization.

✨ Features

Agent Discovery: Search and retrieve AI agent statistics and details.
Portfolio Tracking: Monitor user holdings in ATP AI tokens.
Token Trading: Buy and sell AI agent tokens using IQ as the base currency.
Log Management: Retrieve and add logs for specific AI agents.

📦 Installation

🚀 Using pnpm dlx (Recommended)

To use this server without installing it globally:

pnpm dlx @iqai/mcp-atp

🔧 Build from Source

git clone https://github.com/IQAIcom/mcp-atp.git
cd mcp-atp
pnpm install
pnpm run build

⚡ Running with an MCP Client

Add the following configuration to your MCP client settings (e.g., claude_desktop_config.json).

📋 Minimal Configuration

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

⚙️ Advanced Configuration (Local Build)

{
  "mcpServers": {
    "atp": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-atp/dist/index.js"],
      "env": {
        "ATP_WALLET_PRIVATE_KEY": "your_wallet_private_key_here",
        "ATP_API_KEY": "your_atp_api_key_if_needed"
      }
    }
  }
}

🔐 Configuration (Environment Variables)

| Variable | Required | Description | Default |
| :--- | :--- | :--- | :--- |
| ATP_WALLET_PRIVATE_KEY | Yes | Wallet private key for trading and position queries | - |
| ATP_API_KEY | No | API key for certain backend services | - |

Required for ATP_GET_AGENT_POSITIONS, ATP_BUY_AGENT, ATP_SELL_AGENT tools.

Security Note: Handle the private key with extreme care. Ensure it is stored securely and only provided to trusted MCP client configurations.

💡 Usage Examples

🔍 Agent Discovery

pnpm run build

pnpm run watch

pnpm run lint
pnpm run format

IQ AI Agents Platform
Model Context Protocol (MCP)
IQ Wiki

⚠️ Disclaimer

This project interacts with blockchain-based financial operations. Users should exercise caution and verify all transactions independently. Trading in agent tokens involves risk.

📄 License

ISC