ADK-TSMCP ATP
Interact with the IQ AI Agent Tokenization Platform to manage AI agent tokens and positions.
- Package:
@iqai/mcp-atp - Provider: IQ AI
Overview
The ATP MCP server connects your agent to the IQ AI Agent Tokenization Platform (ATP). It provides tools to query agent rankings, manage token positions, and interact with the ATP ecosystem programmatically using an API key and a funded wallet.
Getting Started
Install the package:
pnpm add @iqai/mcp-atpUse the server in your agent:
import { McpAtp } from "@iqai/adk";
const toolset = McpAtp({
env: {
ATP_WALLET_PRIVATE_KEY: process.env.ATP_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 IQ AI Agent Tokenization Platform",
transport: {
mode: "stdio",
command: "npx",
args: ["-y", "@iqai/mcp-atp"],
env: {
ATP_WALLET_PRIVATE_KEY: process.env.ATP_WALLET_PRIVATE_KEY,
ATP_API_KEY: process.env.ATP_API_KEY,
PATH: process.env.PATH || "",
},
},
});
const tools = await toolset.getTools();{
"mcpServers": {
"atp-mcp-server": {
"command": "npx",
"args": ["-y", "@iqai/mcp-atp"],
"env": {
"ATP_WALLET_PRIVATE_KEY": "your_wallet_private_key",
"ATP_API_KEY": "your_atp_api_key"
}
}
}
}Environment Variables
| Variable | Required | Description |
|---|---|---|
ATP_WALLET_PRIVATE_KEY | Yes | Private key of the wallet used for ATP transactions |
ATP_API_KEY | Yes | Your IQ AI ATP API key |
Credentials
To get your ATP credentials:
- Sign up at IQ AI
- Navigate to your profile page to generate an API Key
- Use the private key of the EVM wallet you want to use for ATP transactions
Available Tools
ATP_AGENT_STATStokenContract:string
ATP_AGENT_STATSDescription
Get statistics and details of a given AI agent on the ATP platform.
ATP_GET_AGENTSsort:stringlimit:integer
ATP_GET_AGENTSDescription
Retrieve a list of AI agents from the ATP platform with optional sorting and limiting.
ATP_GET_AGENT_LOGSagentTokenContract:stringpage:integerlimit:integer
ATP_GET_AGENT_LOGSDescription
Retrieve logs for a specific AI agent, with pagination.
ATP_ADD_AGENT_LOGagentTokenContract:stringcontent:stringtxHash:stringchainId:integer
ATP_ADD_AGENT_LOGDescription
Add a new log entry for a specific AI agent. Requires API key as a parameter.
ATP_BUY_AGENTtokenContract:stringamount:string
ATP_BUY_AGENTDescription
Buy AI agent tokens using IQ as the base currency.
ATP_SELL_AGENTtokenContract:stringamount:string
ATP_SELL_AGENTDescription
Sell AI agent tokens back to the protocol.
ATP_GET_AGENT_POSITIONSNo parameters
ATP_GET_AGENT_POSITIONSNo parameters
Description
Retrieve the positions of the user's agent tokens.
Integration Example
import { AgentBuilder, McpAtp } from "@iqai/adk";
import * as dotenv from "dotenv";
dotenv.config();
async function main() {
// Initialize McpAtp toolset
const toolset = McpAtp({
env: {
ATP_WALLET_PRIVATE_KEY: process.env.ATP_WALLET_PRIVATE_KEY,
ATP_API_KEY: process.env.ATP_API_KEY,
},
});
// Get available McpAtp tools
const atpTools = await toolset.getTools();
// Create agent with McpAtp tools
const { runner } = await AgentBuilder.create("atp_agent")
.withModel("gemini-2.5-flash")
.withDescription(
"An agent that interacts with the IQ AI Agent Tokenization Platform",
)
.withTools(...atpTools)
.build();
const response = await runner.ask(
"Show me the top 10 ranked agents on ATP and their recent performance",
);
console.log(response);
}
main().catch(console.error);