Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.getmcp.com/llms.txt

Use this file to discover all available pages before exploring further.

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}
Content-Type: application/json

​
Request

​
jsonrpc
string
required
Must be "2.0".
​
id
integer | string
required
Arbitrary request identifier echoed back unchanged in the response.
​
method
string
required
Must be "tools/list".
​
params
object
Empty object {}. No parameters accepted.
curl --request POST \
     --url https://yoursite.com/mcp/my-weather-tools \
     --header 'content-type: application/json' \
     --header 'Mcp-Session-Id: your_session_id' \
     --data '
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/list",
  "params": {}
}
'

​
Response

​
result.tools
array
Array of tool objects. Only active tools are included, returned in their configured sort order.Each tool object contains:
  • name — Machine-readable tool identifier
  • description — Human-readable description used by AI for decision making
  • inputSchema — JSON Schema defining accepted parameters
{
  "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"]
        }
      }
    ]
  }
}
Only tools with status: active are included in tools/list. Paused tools are hidden from AI clients.