---
title: "GET /get-mcp-tools/{agent_id}"
method: GET
path: "/get-mcp-tools/{agent_id}"
---

# GET /get-mcp-tools/{agent_id}

`GET /get-mcp-tools/{agent_id}`

Get MCP tools for a specific agent

## Path parameters

- `agent_id` string, required

## Query parameters

- `version` union — Agent version reference. Supports a numeric version (for example 3) or a tag/environment name (for example "prod"). The string "latest" resolves to the most recently created version (the largest version number), and "latest_published" resolves to the most recently published version. When a tag is provided, resolution uses that exact tag assignment (including its dynamic variables). If the tag exists but is currently unassigned, it resolves to latest. When a numeric version, latest, or latest_published is provided, resolution applies dynamic variables from the preferred tag for that resolved version (most recently assigned), if any.
  - integer
  - string
- `mcp_id` string, required
- `component_id` string

## Response `200`

Successfully retrieved MCP tools.

- MCPToolDefinition[]
  - `name` string, required — Name of the MCP tool.
  - `description` string, required — Description of what the MCP tool does.
  - `inputSchema` object, required — JSON schema defining the input parameters for the tool.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `422` — Unprocessable Content
- `500` — Internal Server Error

## Changes

- **2026-05-08** `7dd16ddf69d8` — 2 info
  - `query` request parameter `version` list-of-types was widened by adding types `string`
  - for the `query` request parameter `version`, the type was generalized from `integer` to no type
- **2026-03-09** `8fbf8c54a142` — 1 breaking
  - for the `path` request parameter `agent_id`, the minLength was increased from `0` to `1`

[Change history](https://skmtc.dev/retellai/apis/retell-sdk/changes/get-mcp-tools/:agent_id/get.md)

---

[API](https://skmtc.dev/retellai/apis/retell-sdk.md) · [All operations](https://skmtc.dev/retellai/apis/retell-sdk/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/retellai/retell-sdk/revisions/2a182bedbfc5/schema)