MCP servers powered by [ACI.dev](https://aci.dev)
_For full documentation and tutorials on MCP servers please visit [aci.dev docs](https://aci.dev/docs/mcp-servers/introduction)._
Table of Contents
- MCP servers powered by ACI.dev
Overview
_For full documentation and tutorials on MCP servers please visit [aci.dev docs](https://aci.dev/docs/mcp-servers/introduction)._
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_FUNCTIONSandACI_EXECUTE_FUNCTION) to discover and execute ALL functions (tools) available on ACI.dev
Prerequisites
Before using this package, you need to (for more information please see tutorial):
- Set the
ACI_API_KEYenvironment variable with your ACI.dev API key
- Configure apps and set them in
allowed_appsfor your agent on platform.aci.dev.
- Link your app specific accounts under the same
--linked-account-owner-idyou'll later provide to start the MCP servers
Installation
The package is published to PyPI, so you can run it directly using
uvx:Usage
Apps Server
The apps server provides direct access to functions (tools) under specific apps.
You can specify one or more apps to use with the
--apps parameter. (For a list of available apps, please visit ACI.dev)Unified Server
The unified server provides two meta functions (tools) to discover and execute ANY functions (tools) available on ACI.dev, even if they aren't directly listed in the server.
The functions (tools) are dynamically searched and executed based on your intent/needs. You don't need to worry about having thousands of tools taking up your LLM's context window or having to integrate multiple MCP servers.
Understanding the Two Server Types
_For full documentation and tutorials on MCP servers please visit [aci.dev docs](https://aci.dev/docs/mcp-servers/introduction)._
Apps Server
The apps server provides direct access to specific app functions/tools you specify with the
--apps parameter. These tools will appear directly in the tool list when MCP clients (e.g. Claude Desktop, Cursor, etc.) interact with this server.Unified Server
The unified server doesn't directly expose app-specific tools. Instead, it provides two meta functions (tools):
ACI_SEARCH_FUNCTIONS: Discovers functions (tools) based on your intent/needs
ACI_EXECUTE_FUNCTION: Executes ANY function (tool) discovered by the search
This approach allows MCP clients to dynamically discover and use ANY function available on ACI.dev platform without needing to list them all upfront. It can search for the right tool based on your needs and then execute it.
Configuration
_For full documentation and tutorials on MCP servers please visit [aci.dev docs](https://aci.dev/docs/mcp-servers/introduction)._
Usage with Claude Desktop
Add this to your
claude_desktop_config.json:For apps-specific access:
Usage with Cursor
Add to your Cursor
mcp.json:For apps-specific access:
FAQ
- How do I get the `ACI_API_KEY`? The
ACI_API_KEYis the API key for your ACI.dev project. You can find it in the ACI.dev project settings.
- How to configure Apps and allow access to them? You can configure apps and allow access to them in the ACI.dev project settings.
- How do I get the `LINKED_ACCOUNT_OWNER_ID`? The
LINKED_ACCOUNT_OWNER_IDis the ID of the account that you want to use to access the functions. You can find it in the ACI.dev project settings.
- What is the benefit of using the unified server over the apps server? Most of the current MCP servers are limited to a specific set of functions (tools), usually from a single app. If you need to use functions from multiple apps, you'll need to integrate multiple MCP servers. But even if you are ok with the managing overhead of integrating multiple MCP servers, your LLM tool calling performance might suffer because all the tools are loaded into the LLM's context window at once. The unified server, however, allows you to discover and execute ANY function available on ACI.dev dynamically without worrying about having thousands of tools taking up your LLM's context window or having to integrate multiple MCP servers.
- How to specify a list of apps to use with the apps server? You can specify a comma-separated list of apps to use with the apps server using the
--appsparameter. Try NOT to have spaces between the app names.
- Can I just use functions (tools) from one app? Yes, you can just use functions (tools) from one app by specifying the (one) app name with the
--appsparameter.
Debugging
You can use the MCP inspector to debug the server:
Running
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log will show the logs from the server and may help you debug any issues.MCP servers powered by [ACI.dev](https://aci.dev)
_For full documentation and tutorials on MCP servers please visit [aci.dev docs](https://aci.dev/docs/mcp-servers/introduction)._
Table of Contents
- MCP servers powered by ACI.dev
Overview
_For full documentation and tutorials on MCP servers please visit [aci.dev docs](https://aci.dev/docs/mcp-servers/introduction)._
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_FUNCTIONSandACI_EXECUTE_FUNCTION) to discover and execute ALL functions (tools) available on ACI.dev
Prerequisites
Before using this package, you need to (for more information please see tutorial):
- Set the
ACI_API_KEYenvironment variable with your ACI.dev API key
- Configure apps and set them in
allowed_appsfor your agent on platform.aci.dev.
- Link your app specific accounts under the same
--linked-account-owner-idyou'll later provide to start the MCP servers
Installation
The package is published to PyPI, so you can run it directly using
uvx:Usage
Apps Server
The apps server provides direct access to functions (tools) under specific apps.
You can specify one or more apps to use with the
--apps parameter. (For a list of available apps, please visit ACI.dev)Unified Server
The unified server provides two meta functions (tools) to discover and execute ANY functions (tools) available on ACI.dev, even if they aren't directly listed in the server.
The functions (tools) are dynamically searched and executed based on your intent/needs. You don't need to worry about having thousands of tools taking up your LLM's context window or having to integrate multiple MCP servers.
Understanding the Two Server Types
_For full documentation and tutorials on MCP servers please visit [aci.dev docs](https://aci.dev/docs/mcp-servers/introduction)._
Apps Server
The apps server provides direct access to specific app functions/tools you specify with the
--apps parameter. These tools will appear directly in the tool list when MCP clients (e.g. Claude Desktop, Cursor, etc.) interact with this server.Unified Server
The unified server doesn't directly expose app-specific tools. Instead, it provides two meta functions (tools):
ACI_SEARCH_FUNCTIONS: Discovers functions (tools) based on your intent/needs
ACI_EXECUTE_FUNCTION: Executes ANY function (tool) discovered by the search
This approach allows MCP clients to dynamically discover and use ANY function available on ACI.dev platform without needing to list them all upfront. It can search for the right tool based on your needs and then execute it.
Configuration
_For full documentation and tutorials on MCP servers please visit [aci.dev docs](https://aci.dev/docs/mcp-servers/introduction)._
Usage with Claude Desktop
Add this to your
claude_desktop_config.json:For apps-specific access:
Usage with Cursor
Add to your Cursor
mcp.json:For apps-specific access:
FAQ
- How do I get the `ACI_API_KEY`? The
ACI_API_KEYis the API key for your ACI.dev project. You can find it in the ACI.dev project settings.
- How to configure Apps and allow access to them? You can configure apps and allow access to them in the ACI.dev project settings.
- How do I get the `LINKED_ACCOUNT_OWNER_ID`? The
LINKED_ACCOUNT_OWNER_IDis the ID of the account that you want to use to access the functions. You can find it in the ACI.dev project settings.
- What is the benefit of using the unified server over the apps server? Most of the current MCP servers are limited to a specific set of functions (tools), usually from a single app. If you need to use functions from multiple apps, you'll need to integrate multiple MCP servers. But even if you are ok with the managing overhead of integrating multiple MCP servers, your LLM tool calling performance might suffer because all the tools are loaded into the LLM's context window at once. The unified server, however, allows you to discover and execute ANY function available on ACI.dev dynamically without worrying about having thousands of tools taking up your LLM's context window or having to integrate multiple MCP servers.
- How to specify a list of apps to use with the apps server? You can specify a comma-separated list of apps to use with the apps server using the
--appsparameter. Try NOT to have spaces between the app names.
- Can I just use functions (tools) from one app? Yes, you can just use functions (tools) from one app by specifying the (one) app name with the
--appsparameter.
Debugging
You can use the MCP inspector to debug the server:
Running
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log will show the logs from the server and may help you debug any issues.