List MCP Server Tools

GET/api/mcp/:model_name/tools

Returns the list of tools, prompts, and resources exposed by a specific MCP server. Use this endpoint to discover what capabilities a server provides before connecting via SSE.

Authentication

Endpoint	Auth Required
GET /api/mcp/:model_name/tools	No — public access
GET /api/mcp/tools?name=:model_name	No — public access

Both URL forms resolve to the same handler. Use whichever is more convenient for your client.

Path Parameters

Parameter	Type	Required	Description
model_name	string	Yes	The unique server identifier (e.g. exa/exa). Obtain this from the List MCP Servers endpoint.

Query Parameters

Parameter	Type	Required	Description
name	string	Conditional	Server identifier — required only when using the /api/mcp/tools form instead of the path parameter variant.

Response

Returns the tools, prompts, and resources arrays from the server's unified schema, wrapped in the standard response envelope.

Response Fields

Field	Type	Description
code	integer	0 on success
data.tools	array	Array of MCP tool objects
data.prompts	array	Array of MCP prompt objects (may be empty)
data.resources	array	Array of MCP resource objects (may be empty)
message	string	"ok" on success

Tool Object

Field	Type	Description
name	string	Tool identifier (e.g. web_search, run_sql)
description	string	Human-readable description of what the tool does
inputSchema	object | null	JSON Schema describing the tool's input parameters

Prompt Object

Field	Type	Description
name	string	Prompt identifier
description	string	Human-readable description of the prompt

Resource Object

Field	Type	Description
name	string	Resource identifier
description	string	Human-readable description of the resource
uri	string	Resource URI

Example Request

# Using path parameter
curl "https://api.sandbase.ai/api/mcp/exa/exa/tools"

# Using query parameter
curl "https://api.sandbase.ai/api/mcp/tools?name=exa/exa"

Example Response

{
  "code": 0,
  "data": {
    "tools": [
      {
        "name": "web_search",
        "description": "Search the web using Exa's neural search engine. Returns clean, structured results optimized for AI consumption.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "query": {
              "type": "string",
              "description": "The search query"
            },
            "num_results": {
              "type": "integer",
              "description": "Number of results to return (1-10)",
              "default": 5
            },
            "type": {
              "type": "string",
              "enum": ["neural", "keyword"],
              "description": "Search type",
              "default": "neural"
            }
          },
          "required": ["query"]
        }
      },
      {
        "name": "find_similar",
        "description": "Find web pages similar to a given URL.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "url": {
              "type": "string",
              "description": "The URL to find similar pages for"
            },
            "num_results": {
              "type": "integer",
              "description": "Number of results to return",
              "default": 5
            }
          },
          "required": ["url"]
        }
      }
    ],
    "prompts": [],
    "resources": []
  },
  "message": "ok"
}

Error Responses

Status	Error Code	Description
400	invalid_request	Missing model_name path parameter and name query parameter
404	not_found	Server does not exist or is not an MCP-type model
500	internal_error	Failed to parse the server's schema

Error Examples

{
  "error": "invalid_request",
  "message": "model_name is required"
}

{
  "error": "not_found",
  "message": "MCP server not found: invalid/server"
}

Notes

• The inputSchema field follows JSON Schema format and describes the parameters your agent should pass when calling the tool via the SSE Proxy endpoint.
• Servers with no tools will return an empty tools array ([]), not null.
• The prompts and resources arrays follow the MCP protocol specification and may be empty for servers that only expose tools.

Related

• List MCP Servers — Discover available servers and get model_name identifiers
• SSE Proxy — Connect to a server and invoke tools via SSE
• Client Configuration — Generate IDE config snippets