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 resources/list method returns all resources configured for the server. AI clients call this to discover what data content is available to read.

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 "resources/list".
params
object
Empty object {}. No parameters accepted.
curl --request POST \
     --url https://yoursite.com/mcp/my-server \
     --header 'content-type: application/json' \
     --header 'Mcp-Session-Id: your_session_id' \
     --data '
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/list",
  "params": {}
}
'

Response

result.resources
array
Array of resource objects. Each object contains:
  • uri — Unique identifier for the resource (used in resources/read)
  • name — Human-readable display name
  • description — What the resource contains; used by AI for discovery
  • mimeType — Content type (e.g., text/plain, text/markdown, application/json)
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "resources": [
      {
        "uri": "docs://api-overview",
        "name": "API Overview",
        "description": "Overview of available API endpoints and usage",
        "mimeType": "text/markdown"
      },
      {
        "uri": "resource://products/featured",
        "name": "Featured Products",
        "description": "Current featured products from the catalog",
        "mimeType": "application/json"
      }
    ]
  }
}
To retrieve the actual content of a resource, call resources/read with the URI from this list.