# List an MCP integration's tools

**GET** `/v1/agents/mcp-integrations/{integrationId}/tools`

**Operation ID**: `mcpIntegrationTools`
**Summary**: List an MCP integration's tools
Returns the tools the MCP server publishes, so an agent's allowed-tools list can name them exactly. Read live from the server with the integration's credentials, and cached briefly.

## Tags
- Agents
## Parameters

- **integrationId** (required) - path
  - Type: string
- **refresh** (optional) - query
  - Type: boolean

## Responses

### 200

Tools retrieved successfully

- **Content-Type**: `application/json` / array of `McpToolDescriptor`
### 400

The integration is not an MCP server, or has no stored credential to list with

### 401

Unauthorized

### 404

No MCP integration with that id

### 502

The MCP server could not be reached, or refused the request