ACI

MCP server(s) for Aipolabs ACI.dev

python

251

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "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.