Use This MCP server To

Access ACI.dev app-specific functions via MCP protocol Discover all available ACI.dev functions dynamically Execute ACI.dev managed functions through MCP servers Integrate ACI.dev functions into AI workflows and agents Run MCP servers locally or via Docker for development Debug and monitor ACI.dev function calls in real time

README

MCP servers powered by ACI.dev

Important

This README only covers basic development guide. For full documentation and tutorials on ACI.dev MCP servers please visit aci.dev docs.

Overview
Run MCP Servers Locally
Integration with MCP Clients
Docker
Debugging

Overview

This package provides two Model Context Protocol (MCP) servers for accessing ACI.dev managed functions (tools):

aci-mcp-apps: An MCP server that provides direct access to functions (tools) from specified apps
aci-mcp-unified: An MCP server that provides two meta functions (tools) (ACI_SEARCH_FUNCTIONS and ACI_EXECUTE_FUNCTION) to discover and execute ALL functions (tools) available on ACI.dev

Important

For detailed explanation and tutorials on the two MCP servers please visit aci.dev docs.

Run MCP Servers Locally

The package is published to PyPI, so you can run it directly using uvx:

# Install uv if you don't have it already
curl -sSf https://install.pypa.io/get-pip.py | python3 -
pip install uv

$ uvx aci-mcp --help
Usage: aci-mcp [OPTIONS] COMMAND [ARGS]...

  Main entry point for the package.

Options:
  --help  Show this message and exit.

Commands:
  apps-server     Start the apps-specific MCP server to access tools...
  unified-server  Start the unified MCP server with unlimited tool access.

Integration with MCP Clients

See the Unified MCP Server and Apps MCP Server sections for more information on how to configure the MCP servers with different MCP clients.

Docker

# Build the image
docker build -t aci-mcp .

# Run the unified server
docker run --rm -i -e ACI_API_KEY=<ACI_API_KEY> aci-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

# Run the apps server
docker run --rm -i -e ACI_API_KEY=<ACI_API_KEY> aci-mcp apps-server --apps <APP1,APP2,...> --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

Debugging

You can use the MCP inspector to debug the server:

# For unified server
npx @modelcontextprotocol/inspector uvx aci-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

# For apps server
npx @modelcontextprotocol/inspector uvx aci-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

Running tail -n 20 -f ~/Library/Logs/Claude/mcp*.log will show the logs from the server and may help you debug any issues.

aci-mcp FAQ

How do I run aci-mcp servers locally?

You can run aci-mcp servers locally by following the development guide in the README and using provided scripts or Docker containers.

What are the main components of aci-mcp?

aci-mcp includes two MCP servers: aci-mcp-apps for direct app function access and aci-mcp-unified for meta function discovery and execution.

How does aci-mcp integrate with MCP clients?

aci-mcp servers expose ACI.dev functions as MCP tools, allowing MCP clients to discover and invoke these functions seamlessly.

Can I use aci-mcp with Docker?

Yes, aci-mcp provides Docker support for easy deployment and development environments.

Where can I find full documentation for aci-mcp?

Full documentation and tutorials are available at https://aci.dev/docs/mcp-servers/introduction.

What debugging options are available for aci-mcp?

The package includes debugging tools and logs to monitor function calls and troubleshoot issues.

Does aci-mcp support executing all ACI.dev functions?

Yes, the aci-mcp-unified server provides meta functions to discover and execute all available ACI.dev functions.

Is aci-mcp limited to specific apps?

The aci-mcp-apps server targets specified apps, while aci-mcp-unified covers all functions across ACI.dev.