---
title: "List exposed tools for a gateway"
method: GET
path: "/v2/mcp-gateways/{gateway_id}/tools"
tags: ["MCP Gateway"]
---

# List exposed tools for a gateway

`GET /v2/mcp-gateways/{gateway_id}/tools`

Returns the namespaced tool view for a gateway.

## Path parameters

- `gateway_id` string, required

## Query parameters

- `limit` integer
- `starting_after` string
- `ending_before` string
- `mcp_server_id` string

## Response `200`

OK

- ListMcpGatewayToolsResponse
  - `object` string — Always "list".
  - `data` McpGatewayTool[] — Exposed tools on the current page.
    - `server_key` string — Key of the upstream server the tool comes from.
    - `alias` string — Alias configured on the gateway link the tool comes from.
    - `exposed_name` string — Name MCP clients call; namespaced per the gateway's `tool_naming` and capped at 64 characters.
    - `description` string — Tool description advertised upstream, passed through to MCP clients.
    - `input_schema` object — JSON Schema for the tool arguments, as advertised upstream.
    - `mcp_server_id` string — Upstream server the exposed tool resolves to.
    - `upstream_tool_name` string — Bare tool name on the upstream server, before namespacing.
    - `title` string — Human-readable label advertised upstream, when the server sends one.
    - `annotations` McpToolAnnotations — Hints claimed by the upstream server; the gateway does not enforce them.
      - `read_only` boolean — Upstream claims the tool does not modify state.
      - `destructive` boolean — Upstream claims the tool can perform destructive updates.
      - `idempotent` boolean — Upstream claims repeated calls with the same arguments have no extra effect.
      - `open_world` boolean — Upstream claims the tool reaches systems outside its own domain.
  - `has_more` boolean — Whether further items exist beyond this page.

---

[API](https://skmtc.net/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.net/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/revisions/ed27dc516fb7/schema)