🤖 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

• "What are the top AI agents on ATP?"
• "Get statistics for agent with token contract 0x123..."
• "Search for AI agents by name or category."

📊 Portfolio Management

• "What are my current positions in ATP AI tokens?"
• "Show me my holdings in wallet 0xabc..."

💹 Trading

• "Buy 100 IQ worth of agent tokens for 0x123..."
• "Sell my position in agent 0x456..."

📝 Log Management

• "Get the latest logs for agent 0x123..."
• "Add a new log entry for my agent."

🛠️ MCP Tools

ATP_ADD_AGENT_LOG

Add a new log entry for a specific AI agent. Requires API key as a parameter.

Parameter	Type	Required	Description
agentTokenContract	string	Yes	The contract address of the agent token.
content	string	Yes	The content of the log message.
txHash	string	No	Optional transaction hash associated with this log entry.
chainId	integer	No	Optional chain ID associated with this log entry.

ATP_AGENT_STATS

Get statistics and details of a given AI agent on the ATP platform.

Parameter	Type	Required	Description
tokenContract	string	Yes	The contract address of the agent token (e.g., 0x123...abc).

ATP_BUY_AGENT

Buy AI agent tokens using IQ as the base currency.

Parameter	Type	Required	Description
tokenContract	string	Yes	The contract address of the agent token to buy.
amount	string	Yes	The amount of base currency (IQ) to spend for buying the agent token, specified in wei units (e.g., '1000000000000000000' for 1 IQ).

ATP_GET_AGENT_LOGS

Retrieve logs for a specific AI agent, with pagination.

Parameter	Type	Required	Description
agentTokenContract	string	Yes	The contract address of the agent token.
page	integer	No	Page number for pagination. Defaults to 1.
limit	integer	No	Number of logs per page. Defaults to 10.

ATP_GET_AGENT_POSITIONS

Retrieve the positions of the user

No parameters

ATP_GET_AGENTS

Retrieve a list of AI agents from the ATP platform with optional sorting and limiting.

Parameter	Type	Required	Default	Description
sort	string	No

    Sort agents by market cap, holders count, or inference count.
    Available options are:
    - mcap: Sort by market cap
    - holders: Sort by holders count
    - inferences: Sort by inference count
    Defaults to market cap if not specified.
   |

| limit | integer | No | 100 | |

ATP_SELL_AGENT

Sell AI agent tokens back to the protocol.

Parameter	Type	Required	Description
tokenContract	string	Yes	The contract address of the agent token to sell.
amount	string	Yes	The amount of agent tokens to sell, specified in wei units (e.g., '1000000000000000000' for 1 token).

👨‍💻 Development

🏗️ Build Project

pnpm run build

👁️ Development Mode (Watch)

pnpm run watch

✅ Linting & Formatting

pnpm run lint
pnpm run format

📁 Project Structure

• src/tools/: Individual tool definitions
• src/services/: API client and business logic
• src/lib/: Shared utilities
• src/index.ts: Server entry point

📚 Resources

• 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