Skip to main content
GET
JavaScript

Authorizations

Authorization
string
header
required

Authentication header containing API key (find it in dashboard). The format is "Bearer YOUR_API_KEY"

Path Parameters

agent_id
string
required

Unique id of the agent to get MCP tools for.

Minimum string length: 1
Example:

"oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD"

Query Parameters

version

Optional version of the agent to use for this request. Default to latest version. 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.

Required string length: 1 - 20
Pattern: ^(latest|latest_published|(?!(?:latest|latest_published|v\d+)$)[a-z][a-z0-9_-]{0,19})$
Example:

"latest_published"

mcp_id
string
required

The ID of the MCP server to get tools from.

Example:

"mcp-server-1"

component_id
string

The ID of the component if the MCP server is configured under a component.

Example:

"component-123"

Response

Successfully retrieved MCP tools.

name
string
required

Name of the MCP tool.

Example:

"search_files"

description
string
required

Description of what the MCP tool does.

Example:

"Search for files in the filesystem"

inputSchema
object
required

JSON schema defining the input parameters for the tool.

Example: