---
title: "List Tools"
method: POST
path: "/mcp-server/list-tools"
tags: ["mcp-server"]
---

# List Tools

`POST /mcp-server/list-tools`

Lists all tools available for a specific remote MCP server in various AI model formats.

This eliminates the need for manual MCP code implementation and format conversion.
Under the hood, MCP Handle instantiates an MCP client and establishes a connection 
with the remote MCP server to retrieve available tools.

## Request body

- ListToolsRequest
  - `serverUrl` string, required — The full URL for connecting to the MCP server
  - `connectionType` 'SSE' | 'StreamableHttp'
  - `format` 'openai' | 'anthropic' | 'gemini' | 'mcp_native'
  - `headers` object, nullable — Optional HTTP headers to include when connecting to the server

## Response `200`

Successful Response

- ListToolsResponse
  - `success` boolean, required — Whether the list tools request was successful
  - `tools` unknown[], nullable — List of tools in the requested format
    - unknown
  - `format` 'openai' | 'anthropic' | 'gemini' | 'mcp_native', required
  - `error` string, nullable — Error message, if the request failed

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/weatherpal-ai/apis/mcp-handle-https-www-mcp-handle-dev.md) · [All operations](https://skmtc.net/weatherpal-ai/apis/mcp-handle-https-www-mcp-handle-dev/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/weatherpal-ai/mcp-handle-https-www-mcp-handle-dev/versions/58fc8af3b578/schema)