MCP Server Usage Guide

This document outlines the steps required to integrate with the AIM MCP Server. It includes instructions for setting up supported clients, and initiating interactions with the server.

MCP Client Setup

The AIM MCP server can be used with any MCP client like Claude or Dive AI or Witsy. Follow the instructions below based on your selected client.

Claude Client Setup:

1. Download Claude.
2. Add MCP Server Configuration. Add the following configuration to your Claude setup file (such as claude.config.json or the relevant runtime file located at:

/Users/xxxxxxxxxx/Library/Application Support/Claude/claude_desktop_config.json): 
  "aim-mcp-prod": {
    "command": "npx",
    "env": {},
    "args": [
      "mcp-remote",
      "https://mcp-api.aimplatform.io/mcp",
      "--transport",
      "http-only"
    ]
  }

Dive AI Client Setup:

1. Download Dive AI.
2. Add MCP Server Configuration. Insert the following configuration into Dive’s settings file (typically config.json):

{
  "mcpServers": {
    "aim_prod_server": {
      "transport": "stdio",
      "enabled": true,
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp-api.aimplatform.io/mcp",
        "--transport",
        "http"
      ],
      "env": {},
      "url": null,
      "extraData": null,
      "proxy": null,
      "headers": null,
      "exclude_tools": [],
      "initialTimeout": 1000
    }
  }
}

Witsy Client Setup:

1. Download Witsy.
2. Add MCP Server Configuration.
   • Type: Streamable HTTP
   • Label: AIM-MCP
   • URL: https://mcp-api.aimplatform.io/mcp

Starting the Client

After updating the configuration:

1. Restart the Client (Claude, Dive or Witsy).
2. You will be prompted with the login page. Proceed to log in and authorize the app.
3. After a successful login, close the page and continue using the Claude desktop client as usual.
4. The MCP server retrieves the token based on the currently active login account.

EXAMPLE: If the active account at https://app.aimplatform.io/ is planet-art, then after logging in, all MCP queries will be associated with planet-art.

cd /Users/xxxxxx/.mcp-auth
      rm -r mcp-remote-*

5. Open the chat interface.
6. Begin interaction with the MCP server.

Log In Issues

If you encounter any login issues for Claude or Dive AI, follow these steps:

1. Close the Claude desktop/ Dive Ai application.
2. Remove the existing mcp-remote configuration by running the following commands in your terminal:

 cd /Users/xxxxxx/.mcp-auth
        rm -r mcp-remote-*

Sample Prompts

Get App Lists:

Get List of Attribution Metrics:

Get Time Series Data:

• Get time series data for UK FreePrints Android for date range 2025-06-01 to 2025-06-30 for metric spend for periodicity daily in line chart html.
• Get recommendation for UK FreePrints Android for date range 2025-06-23 to 2025-10-05 for periodicity weekly for spend for Google, TikTok and Applovin network in line chart html.