Skip to main content
The tools/list method returns all active tools configured for the server, including their names, descriptions, and input schemas. AI clients call this to discover what capabilities are available.

​
MCP Endpoint

POST https://yoursite.com/mcp/{slug}/{server_id}
Content-Type: application/json

​
Request

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: your_session_id" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/list",
    "params": {}
  }' \
  "https://yoursite.com/mcp/my-weather-tools/a1b2c3d4e5f6a1b2"

​
Response

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "tools": [
      {
        "name": "get_weather",
        "description": "Get current weather conditions for a city",
        "inputSchema": {
          "type": "object",
          "properties": {
            "city": {
              "type": "string",
              "description": "The city name to get weather for"
            }
          },
          "required": ["city"]
        }
      },
      {
        "name": "get_forecast",
        "description": "Get a 5-day weather forecast for a city",
        "inputSchema": {
          "type": "object",
          "properties": {
            "city": {
              "type": "string",
              "description": "The city name"
            },
            "units": {
              "type": "string",
              "enum": ["metric", "imperial"],
              "default": "metric",
              "description": "Temperature units"
            }
          },
          "required": ["city"]
        }
      }
    ]
  }
}

​
Response Fields

​
result.tools
array
Array of tool objects. Only active tools are included. Tools are returned in their configured sort order.Each tool object contains:
  • name — Machine-readable tool identifier
  • description — Human-readable description for AI decision making
  • inputSchema — JSON Schema defining accepted parameters
Only tools with status: active are included in tools/list. Paused tools are hidden from AI clients.