{
  "endpoint": "https://docs.bump.sh/mcp",
  "captured": "2026-10-27",
  "method": "initialize + tools/list (anonymous, no tool called; roadmap#992)",
  "protocol_version": "2025-06-18",
  "server_info": {
    "name": "Documentation Portal API",
    "version": "0.1.0"
  },
  "result": {
    "tools": [
      {
        "name": "search",
        "description": "Search across all documentation pages in the portal by keyword. Returns matching pages with their URL, title, type, and a text excerpt. Use this to find specific endpoints, schemas, or topics when the user asks about a particular feature or concept. Supports filtering by object type (api, operation, request, response, property, guide..)\n2 outputs are returned: - \"results\" returns a maximum of 20 results, - \"total\" returns the total number of results.\n",
        "inputSchema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "type": "object",
          "properties": {
            "url": {
              "type": "string",
              "description": "The base URL of the documentation or hub to search. (e.g., \"https://docs.example.com\"). Default to the portal_url if omitted.\n"
            },
            "query": {
              "type": "string",
              "description": "Search query string. Matches against page titles, content, and metadata. Use specific terms for best results (e.g., \"create user\" rather than \"user\").\n"
            },
            "type": {
              "type": "string",
              "description": "Filter results by object type. Useful to narrow down results when looking for a specific kind of documentation page. If omitted, all types are returned.\n",
              "enum": [
                "hub",
                "api",
                "guide",
                "group",
                "operation",
                "request",
                "response",
                "property",
                "model",
                "message",
                "binding"
              ]
            }
          },
          "required": [
            "query"
          ]
        }
      },
      {
        "name": "get_pages",
        "description": "Retrieve the full content of one or more documentation pages by their URLs.\nEach page result includes their title and type. Use this when you already know which pages you need (e.g., from search results or from list_pages) and want to read their full content.\nPass multiple URLs in a single call to batch-fetch several pages at once.\n",
        "inputSchema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "type": "object",
          "properties": {
            "urls": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "minItems": 1,
              "maxItems": 10,
              "description": "List of page URL paths to retrieve (1–10 URLs per call). Use the URLs returned by the search or list_pages flows.\n"
            }
          },
          "required": [
            "urls"
          ]
        }
      },
      {
        "name": "list_pages",
        "description": "List all child pages under a given URL in the portal hierarchy.\nUse this to explore and navigate the portal structure. It is the best starting point to understand what documentation is available before fetching specific pages with get_pages.\nReturns a summary of each child page (URL, title, type and description) without full content.\n",
        "inputSchema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "type": "object",
          "properties": {
            "url": {
              "type": "string",
              "description": "Parent URL to list children of. Default to the portal_url if omitted. Use a hub URL to list every API doc in that hub, or a documentation URL to list every page of that documentation: operations, schemas, topics, etc.\n"
            }
          }
        }
      },
      {
        "name": "list_changes",
        "description": "List visible documentation changes for a given resource.\nSupported resource types are a Hub, an API documentation, or a specific version.\nReturns changes ordered from most recent to oldest, with pagination support.\n",
        "inputSchema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "type": "object",
          "properties": {
            "url": {
              "type": "string",
              "description": "Target resource URL (hub, API documentation, or version). Default to the portal_url if omitted.\n"
            },
            "page": {
              "type": "integer",
              "description": "Changes page number. Default to 1.",
              "default": 1
            },
            "limit": {
              "type": "integer",
              "description": "Maximum number of changes per page (1–20). Defaults to 20.",
              "default": 20
            }
          }
        }
      },
      {
        "name": "get_change",
        "description": "Retrieve a single visible documentation change by its identifier.\nUse this after list_changes to read the full content of a specific change.\nReturns the full change details including title, description, markdown diff content, and creation date.\n",
        "inputSchema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "description": "Unique identifier (UUID) of the documentation change. Use the id returned by list_changes.\n"
            }
          },
          "required": [
            "id"
          ]
        }
      }
    ]
  }
}