API ReferenceAgents

MCP Server — discover tools

Fetches tools from the MCP server and syncs ChannelAction rows. Returns discovered, created, updated, disabled counts.

POST
/api/v1/console/agents/{agentId}/integrations/mcp_server/{integrationId}/discover

Authorization

ApiKeyAuth
AuthorizationBearer <token>

Team API key (prefix sk_). You may also send the key via X-Api-Key header.

In: header

Path Parameters

agentId*string
integrationId*string

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/console/agents/string/integrations/mcp_server/string/discover"
{  "message": "Success",  "data": {    "discovered": 0,    "created": 0,    "updated": 0,    "disabled": 0  }}
Empty
{  "message": "Integration type does not match this endpoint",  "error": "Bad Request",  "code": "bad_request",  "statusCode": 400,  "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"}
{  "message": "Invalid API key.",  "error": "Unauthorized",  "code": "api_key_invalid",  "statusCode": 401,  "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"}
{  "message": "This API key is missing the required scope: conversations:read.",  "error": "Forbidden",  "code": "insufficient_scope",  "statusCode": 403,  "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"}
{  "message": "Integration not found",  "error": "Not Found",  "code": "not_found",  "statusCode": 404,  "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"}