---
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

---

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