Create agent MCP connection
Create agent MCP connection. See the OpenAPI-defined parameters, request body, and responses below.
POST
/AgentMcpConnectionCreate agent MCP connection. See the OpenAPI-defined parameters, request body, and responses below.
OpenAPI description: Cria uma associação entre agente e conector MCP do mesmo tenant. Informe Enabled e a lista AllowedTools; uma lista vazia não libera ferramentas. Não permite duplicar o mesmo conector para um agente. Requer UpdateAgent e ViewConnectors.
Authentication
Authentication required. Send your user API key in the X-API-Key header.
Parameters
This operation has no path, query, or header parameters.
Request body
Content type: application/json · Schema: AgentMcpConnectionDto
| Property | Type | Required | Description | Constraints |
|---|---|---|---|---|
id | integer · int32 | No | — | — |
agentId | integer · int32 | No | — | min: 1; max: 2147483647 |
connectorId | integer · int32 | No | — | min: 1; max: 2147483647 |
enabled | boolean | No | — | — |
allowedTools | array<string> | Yes | — | — |
createdAt | string · date-time | No | — | — |
Example request
curl --request POST \
--url 'https://api.zild.ai/AgentMcpConnection' \
--header 'X-API-Key: YOUR_USER_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"id": 0,
"agentId": 0,
"connectorId": 0,
"enabled": true,
"allowedTools": [
"string"
],
"createdAt": "2026-09-22T18:00:00Z"
}'
Responses
| Status | Description | Response body |
|---|---|---|
200 | Associação criada. | application/json · AgentMcpConnectionDto |
Example response (200):
{
"id": 0,
"agentId": 0,
"connectorId": 0,
"enabled": true,
"allowedTools": [
"string"
],
"createdAt": "2026-09-22T18:00:00Z"
}
Data models
AgentMcpConnectionDto
| Property | Type | Required | Description | Constraints |
|---|---|---|---|---|
id | integer · int32 | No | — | — |
agentId | integer · int32 | No | — | min: 1; max: 2147483647 |
connectorId | integer · int32 | No | — | min: 1; max: 2147483647 |
enabled | boolean | No | — | — |
allowedTools | array<string> | Yes | — | — |
createdAt | string · date-time | No | — | — |