MCP Tool Connections API

Connect Model Context Protocol (MCP) servers to AI assistants through the AchieveApex REST API.

Overview

MCP tool connections are stored on the mcp_tools field of an AI assistant. Use the MCP connection proxy to validate a server and retrieve its tools, then save the selected connection on the assistant with

PATCH

/ai-assistants/:id.

Assistant Field: mcp_tools

Connection Proxy Endpoint: /mcp-tool-connection-proxy

MCP Server Config Object

json

Authentication Types

Accepted values used by the assistant configuration UI:

Value	Description
`none`	The MCP server does not require credentials
`api_key`	Send one API key to the server
`custom_headers`	Send one or more custom headers
`oauth2`	Use OAuth2 token metadata and tokens

Save an MCP Server on an Assistant

OAuth2 Config Shape

json