List Agent Mcp Tools

List Agent Mcp Tools
List all MCP tools linked to a specific agent.

This method allows you to list all MCP tools that are linked to a specific agent.

The response format is identical to the tools list endpoint.

Request
URI
GET
https://{api_host}/api/v1/compatibility/openai/v1/agents/{agent_id}/mcp_tools
COPY
Path Parameters
string
agent_id
Required

agent_id

Query Parameters
string
after
Optional

after

string
before
Optional

before

integer
limit
Optional
Constraints: exclusiveMinimum: 0 exclusiveMaximum: 1000 default: 100

limit

integer
offset
Optional
Constraints: minimum: 0 maximum: 4294967296 default: 0

offset

string
order
Optional
Constraints: default: asc

order

Possible values are : asc, desc,
boolean
set_num_objects
Optional
Constraints: default: false

set_num_objects

Authentication
This operation uses the following authentication methods.
Responses
200

Successful Response

Returns ToolListResponse of type(s) application/json 
{
    "object": "string",
    "has_more": false,
    "num_objects": 0,
    "data": [
        {
            "id": "string",
            "server": {
                "id": "string",
                "name": "string"
            },
            "tool_type": "string",
            "tool_configuration_type": "string",
            "origin_name": "string",
            "description": "string",
            "annotations": "string",
            "input_schema": "string",
            "output_schema": "string",
            "is_approved": false,
            "availability": "string",
            "last_available_at": 0,
            "last_updated_at": 0,
            "num_linked_agents": 0
        }
    ],
    "first_id": "string",
    "last_id": "string"
}
string
object
Optional
Constraints: default: list

Object type, which is always list.

boolean
has_more
Optional

True, if the server may have more objects than returned in the response.

integer
num_objects
Required

Total number of objects that match the request. Note that this field is populated only if requested by the user (see set_num_objects request parameter).

array of object
data
Required

List of Tools.

string As uuid As uuid
first_id
Required

ID of the first element in the list (if any)

string As uuid As uuid
last_id
Required

ID of the last element in the list (if any)


404

No agent found with the specified ID.

Operation doesn't return any data structure

410

An invalid ID was passed for paginating results.

Operation doesn't return any data structure

422

Validation Error

Returns HTTPValidationError of type(s) application/json 
{
    "detail": [
        {
            "loc": [
                {}
            ],
            "msg": "string",
            "type": "string"
        }
    ]
}
array of object
detail
Optional

detail


Code Samples
COPY
                    curl -H 'Authorization: <value>' https://{api_host}/api/v1/compatibility/openai/v1/agents/{agent_id}/mcp_tools
On This Page
Agents Operations
GET
List Agents
POST
Create Agent
GET
List Assistants
POST
Create Assistant
GET
Get Agent
POST
Update Agent
DELETE
Delete Agent
GET
Get Assistant
POST
Update Assistant
DELETE
Delete Assistant
GET
List Agent Mcp Tools
POST
Create Agent Chat Completion
POST
Create Assistant Chat Completion
POST
Create Agent Completion
POST
Create Assistant Completion