# Descobrir ferramentas MCP do conector

Conecta ao servidor MCP configurado no conector do tenant e consulta os nomes, descrições e schemas das ferramentas disponíveis. Faz uma chamada ao servidor externo, mas não executa as ferramentas nem as autoriza automaticamente para um agente. Requer ViewConnectors.

Source: https://zild.ai/pt-BR/docs/api-reference/get-api-AgentMcpConnection-connectors-connectorId-tools

GET `/AgentMcpConnection/connectors/{connectorId}/tools`

Conecta ao servidor MCP configurado no conector do tenant e consulta os nomes, descrições e schemas das ferramentas disponíveis. Faz uma chamada ao servidor externo, mas não executa as ferramentas nem as autoriza automaticamente para um agente. Requer ViewConnectors.

## Autenticação

**Autenticação obrigatória.** Envie sua chave de API de usuário no header X-API-Key.

## Parâmetros



<table class="api-params"><thead><tr><th>Nome</th><th>Local</th><th>Tipo</th><th>Obrigatório</th><th>Descrição</th><th>Restrições</th></tr></thead><tbody><tr><td><code>connectorId</code></td><td><code>path</code></td><td><code>integer · int32</code></td><td>Sim</td><td>—</td><td>—</td></tr></tbody></table>



## Corpo da requisição

Esta operação não recebe corpo de requisição.

## Exemplo de requisição



```
curl --request GET \
  --url 'https://api.zild.ai/AgentMcpConnection/connectors/{connectorId}/tools' \
  --header 'X-API-Key: YOUR_USER_API_KEY'
```



## Respostas



<table class="api-params"><thead><tr><th>Status</th><th>Descrição</th><th>Corpo da resposta</th></tr></thead><tbody><tr><td><code>200</code></td><td>Ferramentas disponíveis no servidor MCP.</td><td><code>application/json</code> · <code>array&lt;McpToolDefinition&gt;</code></td></tr></tbody></table>

**Exemplo de resposta (200):**



```
[
  {
    "name": "string",
    "description": "string",
    "inputSchema": "string"
  }
]
```



## Modelos de dados

`McpToolDefinition`

<table class="api-params"><thead><tr><th>Propriedade</th><th>Tipo</th><th>Obrigatório</th><th>Descrição</th><th>Restrições</th></tr></thead><tbody><tr><td><code>name</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>description</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>inputSchema</code></td><td><code>any</code></td><td>Não</td><td>—</td><td>—</td></tr></tbody></table>