home / mcp / aci mcp server

ACI MCP Server

MCP server(s) for Aipolabs ACI.dev

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "aipotheosis-labs-aci-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "ACI_API_KEY=<ACI_API_KEY>",
        "aci-mcp",
        "unified-server",
        "--linked-account-owner-id",
        "<LINKED_ACCOUNT_OWNER_ID>"
      ],
      "env": {
        "ACI_API_KEY": "<ACI_API_KEY>"
      }
    }
  }
}

You can run MCP servers powered by ACI.dev to access and execute a wide range of managed functions (tools). The unified server lets you discover and run all available tools, while the apps server provides direct access to tools from specified apps. Use these servers to build integrations, automate workflows, or test tool availability in your environment.

How to use

Start the unified MCP server to discover and execute all available tools, or start the apps server to access tools from specific apps. You can run these servers locally or via Docker. After starting, your MCP client can browse tooling, search for functions, and execute them in your workflow.

How to install

Prerequisites you need before running MCP servers:

Install a Python environment to obtain the uv tool: you may need to install pip first, then install uv.

# Install pip for Python 3 if needed
curl -sSf https://install.pypa.io/get-pip.py | python3 -

# Install uv tool
pip install uv

Additional sections

Configuration and run details for the MCP servers are shown in the runtime examples. You can deploy using Docker or run locally with uvx. The unified server provides two meta functions to discover and execute all tools available on ACI.dev.

Debugging and logs help you diagnose issues. You can use the MCP inspector to debug servers locally. For the unified server, run: npx @modelcontextprotocol/inspector uvx aci-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID> and for the apps server: npx @modelcontextprotocol/inspector uvx aci-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>.

Tail server logs to monitor activity and diagnose issues: tail -n 20 -f ~/Library/Logs/Claude/mcp*.log.

Available tools

ACI_SEARCH_FUNCTIONS

Discovers all functions (tools) available on the ACI.dev MCP ecosystem so you can see what is accessible across the platform.

ACI_EXECUTE_FUNCTION

Executes a selected function (tool) from the discovered set, enabling you to perform actions directly through MCP.