SIsignificant-gravitas
v2
mcp
mcp

Discover available tools on an MCP server

Changed on

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 unless use_saved_credentials is false.

post/api/mcp/discover-tools

Request

  • The document declares no server URL.
  • Auth
    HTTP bearer

Request body

server_urlstring required

URL of the MCP server

use_saved_credentialsboolean

Use a saved credential when no auth token is supplied. Set false to discover public tools without signing in.

auth_tokenstring password nullable

Optional bare Bearer token, Basic/Bearer value, or complete Authorization header. Omit the field (or send null) for an unauthenticated server; an empty string is rejected.

Response

Successful Response

server_namestring nullable
protocol_versionstring nullable

Changes

  • 5f27fa9d6c03Revision changes
    • info

      added the new optional request property

  • d3946c727d24Revision changes
    • breaking

      the / request property's minLength was increased from 0 to 1

    • breaking

      the / request property format changed from no format to password

    • warning

      the / request property's maxLength was set to 8192