​
Overview

The Unified MCP Server provides a smart, scalable approach to function calling by exposing just two meta functions (tools) that can:

  1. Dynamically discover the right functions (tools) based on user intent
  2. Execute any function on the ACI.dev platform retrieved from the search results

​
How It Works

The Unified MCP Server exposes two meta-functions:

  1. ACI_SEARCH_FUNCTIONS_WITH_INTENT - Discovers functions based on your intent/needs
  2. ACI_EXECUTE_FUNCTION - Executes any function discovered by the search

This approach allows LLMs to first search for the right tool based on the user’s needs and then execute it, without needing to list all available functions upfront.

​
Benefits

  • Reduced Context Window Usage - Instead of loading hundreds of function definitions into your LLM’s context window, the unified server keeps it minimal with just two functions (tools)
  • Dynamic Discovery - The server intelligently finds the most relevant tools for your specific task
  • Complete Function Coverage - Access to ALL functions on the ACI.dev platform without configuration changes
  • Simplified Integration - No need to manage multiple MCP servers for different apps or groups of functions (tools)

​
Prerequisites

Before using the Unified MCP Server, you need to complete several setup steps on the ACI.dev platform.

1

Get your ACI.dev API Key

You’ll need an API key from one of your ACI.dev agents. Find this in your project settings

2

Configure Apps

Navigate to the App Store to configure the apps you want to use with your MCP servers.

For more details on what is an app and how to configure it, please refer to the App section.

3

Set Allowed Apps

In your Project Settings , enable the apps you want your agent to access by adding them to the Allowed Apps list.

For more details on how and why to set allowed apps, please refer to the Agent section.

4

Link Accounts For Each App

For each app you want to use, you’ll need to link end-user (or your own) accounts. During account linking, you’ll specify a linked-account-owner-id which you’ll later provide when starting the MCP servers.

For more details on how to link accounts and what linked-account-owner-id is, please refer to the Linked Accounts section.

5

Install the Package

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

​
Integration with MCP Clients

{
  "mcpServers": {
    "aipolabs-mcp-unified": {
      "command": "uvx",
      "args": ["aipolabs-mcp", "unified-server", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"],
      "env": {
        "AIPOLABS_ACI_API_KEY": "<YOUR_AIPOLABS_ACI_API_KEY>"
      }
    }
  }
}