---
title: "Discover available tools on an MCP server"
method: POST
path: "/api/mcp/discover-tools"
tags: ["v2", "mcp", "mcp"]
---

# Discover available tools on an MCP server

`POST /api/mcp/discover-tools`

Connect to an MCP server and return its available tools.

If the user has a stored MCP credential for this server URL, it will be
used automatically — no need to pass an explicit auth token.

## Request body

- DiscoverToolsRequest — Request to discover tools on an MCP server.
  - `server_url` string, required — URL of the MCP server
  - `auth_token` string, nullable — Optional Bearer token for authenticated MCP servers

## Response `200`

Successful Response

- DiscoverToolsResponse — Response containing the list of tools available on an MCP server.
  - `tools` MCPToolResponse[], required
    - `name` string, required
    - `description` string, required
    - `input_schema` object, required
  - `server_name` string, nullable
  - `protocol_version` string, nullable

## Other responses

- `401` — Authentication required
- `422` — Validation Error

---

[API](https://skmtc.net/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.net/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/significant-gravitas/autogpt-agent-server/versions/382041c7ecb2/schema)