{
  "service": "readme",
  "displayName": "ReadMe",
  "categories": [
    "Developer Tools",
    "Productivity"
  ],
  "authTypes": [
    "api_key"
  ],
  "auth": [
    {
      "type": "api_key",
      "label": "API Key",
      "placeholder": "readme_api_key",
      "description": "ReadMe API key sent with HTTP Basic authentication. Create or rotate keys from the API Keys page in your ReadMe dashboard.",
      "extraFields": []
    }
  ],
  "homepageUrl": "https://readme.com",
  "actions": [
    {
      "id": "readme.ask_owlbot",
      "service": "readme",
      "name": "ask_owlbot",
      "description": "Ask ReadMe Owlbot a non-streaming question and return its answer with sources.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "question": {
            "type": "string",
            "minLength": 1,
            "description": "The question to ask Owlbot."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe Owlbot question payload."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "answer": {
            "type": "string",
            "description": "The generated answer returned by Owlbot."
          },
          "sources": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "One Owlbot source returned by ReadMe."
            },
            "description": "The sources returned for the Owlbot answer."
          },
          "raw": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The raw Owlbot response returned by ReadMe."
          }
        },
        "additionalProperties": false,
        "required": [
          "raw"
        ],
        "description": "The ReadMe Owlbot answer response."
      }
    },
    {
      "id": "readme.create_category",
      "service": "readme",
      "name": "create_category",
      "description": "Create a ReadMe guide or reference category.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "version": {
            "type": "string",
            "description": "The optional ReadMe project version to send with the x-readme-version header, for example v3.0."
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "description": "A short title for the category."
          },
          "type": {
            "type": "string",
            "enum": [
              "reference",
              "guide"
            ],
            "description": "The ReadMe category type."
          }
        },
        "additionalProperties": false,
        "required": [
          "title"
        ],
        "description": "The ReadMe category creation payload."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "category": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The ReadMe category returned by the API."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe category response."
      }
    },
    {
      "id": "readme.create_changelog",
      "service": "readme",
      "name": "create_changelog",
      "description": "Create a ReadMe changelog entry.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "minLength": 1,
            "description": "The title of the ReadMe changelog entry."
          },
          "type": {
            "type": "string",
            "enum": [
              "",
              "added",
              "fixed",
              "improved",
              "deprecated",
              "removed"
            ],
            "description": "The ReadMe changelog entry type."
          },
          "body": {
            "type": "string",
            "minLength": 1,
            "description": "The body content of the ReadMe changelog entry."
          },
          "hidden": {
            "type": "boolean",
            "description": "Whether the changelog entry is hidden."
          }
        },
        "additionalProperties": false,
        "required": [
          "title",
          "body"
        ],
        "description": "The ReadMe changelog creation payload."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "changelog": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The ReadMe changelog returned by the API."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe changelog response."
      }
    },
    {
      "id": "readme.create_custom_page",
      "service": "readme",
      "name": "create_custom_page",
      "description": "Create a ReadMe custom page.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "minLength": 1,
            "description": "The title of the ReadMe custom page."
          },
          "body": {
            "type": "string",
            "description": "The Markdown body content for the custom page."
          },
          "html": {
            "type": "string",
            "description": "The HTML body content for the custom page."
          },
          "htmlmode": {
            "type": "boolean",
            "description": "Whether ReadMe should display html instead of body."
          },
          "hidden": {
            "type": "boolean",
            "description": "Whether the custom page is hidden."
          }
        },
        "additionalProperties": false,
        "required": [
          "title"
        ],
        "description": "The ReadMe custom page creation payload."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "customPage": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The ReadMe custom page returned by the API."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe custom page response."
      }
    },
    {
      "id": "readme.create_doc",
      "service": "readme",
      "name": "create_doc",
      "description": "Create a ReadMe doc page using a category ID or category slug.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "version": {
            "type": "string",
            "description": "The optional ReadMe project version to send with the x-readme-version header, for example v3.0."
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "description": "The title of the ReadMe doc."
          },
          "type": {
            "type": "string",
            "enum": [
              "basic",
              "error",
              "link"
            ],
            "description": "The ReadMe doc page type."
          },
          "body": {
            "type": "string",
            "description": "The ReadMe-flavored Markdown body content for the page."
          },
          "category": {
            "type": "string",
            "description": "The ReadMe category ID for the page."
          },
          "categorySlug": {
            "type": "string",
            "description": "The ReadMe category slug for the page."
          },
          "hidden": {
            "type": "boolean",
            "description": "Whether the doc is hidden."
          },
          "order": {
            "type": "integer",
            "description": "The position of the doc in the project sidebar."
          },
          "parentDoc": {
            "type": "string",
            "description": "The parent doc ID if the page is a subpage."
          },
          "parentDocSlug": {
            "type": "string",
            "description": "The parent doc slug if the page is a subpage."
          },
          "error": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "Deprecated error-page metadata for ReadMe docs."
          }
        },
        "additionalProperties": true,
        "description": "The ReadMe doc creation payload.",
        "anyOf": [
          {
            "required": [
              "category"
            ]
          },
          {
            "required": [
              "categorySlug"
            ]
          }
        ]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "doc": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The ReadMe doc returned by the API."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe doc response."
      }
    },
    {
      "id": "readme.create_version",
      "service": "readme",
      "name": "create_version",
      "description": "Create a new ReadMe project version from an existing base version.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "version": {
            "type": "string",
            "minLength": 1,
            "description": "The semantic version identifier for the ReadMe project version."
          },
          "codename": {
            "type": "string",
            "description": "The codename for the ReadMe project version."
          },
          "from": {
            "type": "string",
            "minLength": 1,
            "description": "The semantic version to use as the base fork."
          },
          "is_stable": {
            "type": "boolean",
            "description": "Whether this version should be the main stable version."
          },
          "is_beta": {
            "type": "boolean",
            "description": "Whether this version is beta."
          },
          "is_hidden": {
            "type": "boolean",
            "description": "Whether this version is hidden."
          },
          "is_deprecated": {
            "type": "boolean",
            "description": "Whether this version is deprecated."
          },
          "pdfStatus": {
            "type": "string",
            "description": "The PDF generation status for the version."
          }
        },
        "additionalProperties": false,
        "required": [
          "version",
          "from"
        ],
        "description": "The ReadMe version creation payload."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "version": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The ReadMe version returned by the API."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe project version response."
      }
    },
    {
      "id": "readme.delete_api_specification",
      "service": "readme",
      "name": "delete_api_specification",
      "description": "Delete one ReadMe API specification by ID.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "The API specification ID to delete."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe API specification identifier."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "deleted": {
            "type": "boolean",
            "description": "Whether the ReadMe resource was deleted."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe delete response."
      }
    },
    {
      "id": "readme.delete_category",
      "service": "readme",
      "name": "delete_category",
      "description": "Delete one ReadMe category by slug.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "minLength": 1,
            "description": "The URL-safe ReadMe slug to request."
          },
          "version": {
            "type": "string",
            "description": "The optional ReadMe project version to send with the x-readme-version header, for example v3.0."
          }
        },
        "additionalProperties": false,
        "required": [
          "slug"
        ],
        "description": "The ReadMe slug and optional project version."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "deleted": {
            "type": "boolean",
            "description": "Whether the ReadMe resource was deleted."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe delete response."
      }
    },
    {
      "id": "readme.delete_changelog",
      "service": "readme",
      "name": "delete_changelog",
      "description": "Delete one ReadMe changelog entry by slug.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "minLength": 1,
            "description": "The URL-safe ReadMe changelog slug to delete."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe changelog slug to delete."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "deleted": {
            "type": "boolean",
            "description": "Whether the ReadMe resource was deleted."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe delete response."
      }
    },
    {
      "id": "readme.delete_custom_page",
      "service": "readme",
      "name": "delete_custom_page",
      "description": "Delete one ReadMe custom page by slug.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "minLength": 1,
            "description": "The URL-safe ReadMe custom page slug to delete."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe custom page slug to delete."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "deleted": {
            "type": "boolean",
            "description": "Whether the ReadMe resource was deleted."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe delete response."
      }
    },
    {
      "id": "readme.delete_doc",
      "service": "readme",
      "name": "delete_doc",
      "description": "Delete one ReadMe doc page by slug.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "minLength": 1,
            "description": "The URL-safe ReadMe slug to request."
          },
          "version": {
            "type": "string",
            "description": "The optional ReadMe project version to send with the x-readme-version header, for example v3.0."
          }
        },
        "additionalProperties": false,
        "required": [
          "slug"
        ],
        "description": "The ReadMe slug and optional project version."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "deleted": {
            "type": "boolean",
            "description": "Whether the ReadMe resource was deleted."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe delete response."
      }
    },
    {
      "id": "readme.delete_version",
      "service": "readme",
      "name": "delete_version",
      "description": "Delete one ReadMe project version by semver identifier.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "versionId": {
            "type": "string",
            "minLength": 1,
            "description": "The semver identifier for the project version, preferably the version_clean value from list_versions."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe version identifier to delete."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "deleted": {
            "type": "boolean",
            "description": "Whether the ReadMe resource was deleted."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe delete response."
      }
    },
    {
      "id": "readme.get_api_registry",
      "service": "readme",
      "name": "get_api_registry",
      "description": "Retrieve one ReadMe API Registry entry by UUID.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "uuid": {
            "type": "string",
            "minLength": 1,
            "description": "The API Registry UUID to retrieve from ReadMe."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe API Registry entry identifier to request."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "registry": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The ReadMe API Registry entry returned by the API."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe API Registry entry response."
      }
    },
    {
      "id": "readme.get_category",
      "service": "readme",
      "name": "get_category",
      "description": "Get one ReadMe category by slug.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "minLength": 1,
            "description": "The URL-safe ReadMe slug to request."
          },
          "version": {
            "type": "string",
            "description": "The optional ReadMe project version to send with the x-readme-version header, for example v3.0."
          }
        },
        "additionalProperties": false,
        "required": [
          "slug"
        ],
        "description": "The ReadMe slug and optional project version."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "category": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The ReadMe category returned by the API."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe category response."
      }
    },
    {
      "id": "readme.get_changelog",
      "service": "readme",
      "name": "get_changelog",
      "description": "Get one ReadMe changelog entry by slug.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "minLength": 1,
            "description": "The URL-safe ReadMe changelog slug to request."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe changelog slug to request."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "changelog": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The ReadMe changelog returned by the API."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe changelog response."
      }
    },
    {
      "id": "readme.get_custom_page",
      "service": "readme",
      "name": "get_custom_page",
      "description": "Get one ReadMe custom page by slug.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "minLength": 1,
            "description": "The URL-safe ReadMe custom page slug to request."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe custom page slug to request."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "customPage": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The ReadMe custom page returned by the API."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe custom page response."
      }
    },
    {
      "id": "readme.get_doc",
      "service": "readme",
      "name": "get_doc",
      "description": "Get one ReadMe doc by slug, optionally requesting the production doc version.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "minLength": 1,
            "description": "The URL-safe ReadMe doc slug to request."
          },
          "production": {
            "type": "boolean",
            "description": "Whether to request the production version of the doc."
          },
          "version": {
            "type": "string",
            "description": "The optional ReadMe project version to send with the x-readme-version header, for example v3.0."
          }
        },
        "additionalProperties": false,
        "required": [
          "slug"
        ],
        "description": "The ReadMe doc slug and retrieval options."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "doc": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The ReadMe doc returned by the API."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe doc response."
      }
    },
    {
      "id": "readme.get_openapi_schema",
      "service": "readme",
      "name": "get_openapi_schema",
      "description": "Get the OpenAPI definition for the ReadMe project.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false,
        "description": "No input is required for this ReadMe action."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "schema": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The OpenAPI definition returned by ReadMe."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe OpenAPI schema response."
      }
    },
    {
      "id": "readme.get_project",
      "service": "readme",
      "name": "get_project",
      "description": "Get metadata for the ReadMe project associated with the API key.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false,
        "description": "No input is required for this ReadMe action."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "project": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "The ReadMe project name."
              },
              "subdomain": {
                "type": "string",
                "description": "The ReadMe project subdomain."
              },
              "baseUrl": {
                "type": "string",
                "description": "The public base URL for the ReadMe project."
              },
              "plan": {
                "type": "string",
                "description": "The ReadMe project plan when returned."
              }
            },
            "additionalProperties": true,
            "description": "ReadMe project metadata returned for the API key."
          }
        },
        "additionalProperties": false,
        "description": "The current ReadMe project response."
      }
    },
    {
      "id": "readme.get_version",
      "service": "readme",
      "name": "get_version",
      "description": "Get one ReadMe project version by semver identifier.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "versionId": {
            "type": "string",
            "minLength": 1,
            "description": "The semver identifier for the project version, preferably the version_clean value from list_versions."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe version identifier to request."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "version": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The ReadMe version returned by the API."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe project version response."
      }
    },
    {
      "id": "readme.list_api_specifications",
      "service": "readme",
      "name": "list_api_specifications",
      "description": "List ReadMe API specification metadata with optional version and pagination.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "version": {
            "type": "string",
            "description": "The optional ReadMe project version to send with the x-readme-version header, for example v3.0."
          },
          "perPage": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "The number of items to include per page. ReadMe accepts values up to 100."
          },
          "page": {
            "type": "integer",
            "minimum": 1,
            "description": "The one-based page number to request."
          }
        },
        "additionalProperties": false,
        "description": "Optional ReadMe version and pagination parameters."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "apiSpecifications": {
            "type": "array",
            "items": {
              "description": "One ReadMe item."
            },
            "description": "The ReadMe API specification metadata records returned by the API."
          },
          "raw": {
            "description": "The raw ReadMe API specification metadata payload."
          },
          "link": {
            "type": "string",
            "description": "The raw Link response header returned by ReadMe when present."
          },
          "totalCount": {
            "type": "integer",
            "description": "The x-total-count response header returned by ReadMe when present."
          }
        },
        "additionalProperties": false,
        "required": [
          "apiSpecifications",
          "raw"
        ],
        "description": "The ReadMe API specification metadata response."
      }
    },
    {
      "id": "readme.list_categories",
      "service": "readme",
      "name": "list_categories",
      "description": "List ReadMe guide and reference categories with optional version and pagination.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "version": {
            "type": "string",
            "description": "The optional ReadMe project version to send with the x-readme-version header, for example v3.0."
          },
          "perPage": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "The number of items to include per page. ReadMe accepts values up to 100."
          },
          "page": {
            "type": "integer",
            "minimum": 1,
            "description": "The one-based page number to request."
          }
        },
        "additionalProperties": false,
        "description": "Optional ReadMe version and pagination parameters."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "categories": {
            "type": "array",
            "items": {
              "description": "One ReadMe item."
            },
            "description": "The ReadMe categories returned by the API."
          },
          "link": {
            "type": "string",
            "description": "The raw Link response header returned by ReadMe when present."
          },
          "totalCount": {
            "type": "integer",
            "description": "The x-total-count response header returned by ReadMe when present."
          }
        },
        "additionalProperties": false,
        "required": [
          "categories"
        ],
        "description": "The ReadMe categories response."
      }
    },
    {
      "id": "readme.list_category_docs",
      "service": "readme",
      "name": "list_category_docs",
      "description": "List the ReadMe docs that belong to a category slug.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "minLength": 1,
            "description": "The URL-safe ReadMe slug to request."
          },
          "version": {
            "type": "string",
            "description": "The optional ReadMe project version to send with the x-readme-version header, for example v3.0."
          }
        },
        "additionalProperties": false,
        "required": [
          "slug"
        ],
        "description": "The ReadMe slug and optional project version."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "docs": {
            "type": "array",
            "items": {
              "description": "One ReadMe item."
            },
            "description": "The ReadMe docs returned for the category."
          },
          "raw": {
            "description": "The raw ReadMe category docs payload."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe category docs response."
      }
    },
    {
      "id": "readme.list_changelogs",
      "service": "readme",
      "name": "list_changelogs",
      "description": "List ReadMe changelog entries with optional pagination.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "perPage": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "The number of items to include per page. ReadMe accepts values up to 100."
          },
          "page": {
            "type": "integer",
            "minimum": 1,
            "description": "The one-based page number to request."
          }
        },
        "additionalProperties": false,
        "description": "Optional ReadMe changelog pagination parameters."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "changelogs": {
            "type": "array",
            "items": {
              "description": "One ReadMe item."
            },
            "description": "The ReadMe changelogs returned by the API."
          },
          "link": {
            "type": "string",
            "description": "The raw Link response header returned by ReadMe when present."
          },
          "totalCount": {
            "type": "integer",
            "description": "The x-total-count response header returned by ReadMe when present."
          }
        },
        "additionalProperties": false,
        "required": [
          "changelogs"
        ],
        "description": "The ReadMe changelogs response."
      }
    },
    {
      "id": "readme.list_custom_pages",
      "service": "readme",
      "name": "list_custom_pages",
      "description": "List ReadMe custom pages with optional pagination.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "perPage": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "The number of items to include per page. ReadMe accepts values up to 100."
          },
          "page": {
            "type": "integer",
            "minimum": 1,
            "description": "The one-based page number to request."
          }
        },
        "additionalProperties": false,
        "description": "Optional ReadMe custom page pagination parameters."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "customPages": {
            "type": "array",
            "items": {
              "description": "One ReadMe item."
            },
            "description": "The ReadMe custom pages returned by the API."
          },
          "link": {
            "type": "string",
            "description": "The raw Link response header returned by ReadMe when present."
          },
          "totalCount": {
            "type": "integer",
            "description": "The x-total-count response header returned by ReadMe when present."
          }
        },
        "additionalProperties": false,
        "required": [
          "customPages"
        ],
        "description": "The ReadMe custom pages response."
      }
    },
    {
      "id": "readme.list_outbound_ips",
      "service": "readme",
      "name": "list_outbound_ips",
      "description": "List ReadMe outbound IP addresses used for webhook and Try It proxy requests.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false,
        "description": "No input is required for this ReadMe action."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "outboundIps": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "One ReadMe outbound IP address entry."
            },
            "description": "The outbound IP address entries returned by ReadMe."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe outbound IP address response."
      }
    },
    {
      "id": "readme.list_versions",
      "service": "readme",
      "name": "list_versions",
      "description": "List the versions configured for the ReadMe project.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false,
        "description": "No input is required for this ReadMe action."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "versions": {
            "type": "array",
            "items": {
              "description": "One ReadMe item."
            },
            "description": "The ReadMe versions returned by the API."
          },
          "raw": {
            "description": "The raw ReadMe versions payload."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe project versions response."
      }
    },
    {
      "id": "readme.search_docs",
      "service": "readme",
      "name": "search_docs",
      "description": "Search ReadMe docs by text query.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "search": {
            "type": "string",
            "minLength": 1,
            "description": "The search text to look for in ReadMe docs."
          },
          "version": {
            "type": "string",
            "description": "The optional ReadMe project version to send with the x-readme-version header, for example v3.0."
          }
        },
        "additionalProperties": false,
        "required": [
          "search"
        ],
        "description": "The ReadMe docs search query and optional project version."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "results": {
            "type": "array",
            "items": {
              "description": "One ReadMe item."
            },
            "description": "The ReadMe docs returned by search."
          },
          "raw": {
            "description": "The raw ReadMe search payload."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe docs search response."
      }
    },
    {
      "id": "readme.update_category",
      "service": "readme",
      "name": "update_category",
      "description": "Update one ReadMe category by slug.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "minLength": 1,
            "description": "The URL-safe ReadMe category slug to update."
          },
          "version": {
            "type": "string",
            "description": "The optional ReadMe project version to send with the x-readme-version header, for example v3.0."
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "description": "A short title for the category."
          },
          "type": {
            "type": "string",
            "enum": [
              "reference",
              "guide"
            ],
            "description": "The ReadMe category type."
          }
        },
        "additionalProperties": false,
        "required": [
          "slug"
        ],
        "description": "The ReadMe category update payload."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "category": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The ReadMe category returned by the API."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe category response."
      }
    },
    {
      "id": "readme.update_changelog",
      "service": "readme",
      "name": "update_changelog",
      "description": "Update one ReadMe changelog entry by slug.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "minLength": 1,
            "description": "The URL-safe ReadMe changelog slug to update."
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "description": "The title of the ReadMe changelog entry."
          },
          "type": {
            "type": "string",
            "enum": [
              "",
              "added",
              "fixed",
              "improved",
              "deprecated",
              "removed"
            ],
            "description": "The ReadMe changelog entry type."
          },
          "body": {
            "type": "string",
            "minLength": 1,
            "description": "The body content of the ReadMe changelog entry."
          },
          "hidden": {
            "type": "boolean",
            "description": "Whether the changelog entry is hidden."
          }
        },
        "additionalProperties": false,
        "required": [
          "slug"
        ],
        "description": "The ReadMe changelog update payload."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "changelog": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The ReadMe changelog returned by the API."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe changelog response."
      }
    },
    {
      "id": "readme.update_custom_page",
      "service": "readme",
      "name": "update_custom_page",
      "description": "Update one ReadMe custom page by slug.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "minLength": 1,
            "description": "The URL-safe ReadMe custom page slug to update."
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "description": "The title of the ReadMe custom page."
          },
          "body": {
            "type": "string",
            "description": "The Markdown body content for the custom page."
          },
          "html": {
            "type": "string",
            "description": "The HTML body content for the custom page."
          },
          "htmlmode": {
            "type": "boolean",
            "description": "Whether ReadMe should display html instead of body."
          },
          "hidden": {
            "type": "boolean",
            "description": "Whether the custom page is hidden."
          }
        },
        "additionalProperties": false,
        "required": [
          "slug"
        ],
        "description": "The ReadMe custom page update payload."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "customPage": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The ReadMe custom page returned by the API."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe custom page response."
      }
    },
    {
      "id": "readme.update_doc",
      "service": "readme",
      "name": "update_doc",
      "description": "Update one ReadMe doc page by slug.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "minLength": 1,
            "description": "The URL-safe ReadMe doc slug to update."
          },
          "version": {
            "type": "string",
            "description": "The optional ReadMe project version to send with the x-readme-version header, for example v3.0."
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "description": "The title of the ReadMe doc."
          },
          "type": {
            "type": "string",
            "enum": [
              "basic",
              "error",
              "link"
            ],
            "description": "The ReadMe doc page type."
          },
          "body": {
            "type": "string",
            "description": "The ReadMe-flavored Markdown body content for the page."
          },
          "category": {
            "type": "string",
            "description": "The ReadMe category ID for the page."
          },
          "categorySlug": {
            "type": "string",
            "description": "The ReadMe category slug for the page."
          },
          "hidden": {
            "type": "boolean",
            "description": "Whether the doc is hidden."
          },
          "order": {
            "type": "integer",
            "description": "The position of the doc in the project sidebar."
          },
          "parentDoc": {
            "type": "string",
            "description": "The parent doc ID if the page is a subpage."
          },
          "parentDocSlug": {
            "type": "string",
            "description": "The parent doc slug if the page is a subpage."
          },
          "error": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "Deprecated error-page metadata for ReadMe docs."
          }
        },
        "additionalProperties": true,
        "description": "The ReadMe doc update payload."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "doc": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The ReadMe doc returned by the API."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe doc response."
      }
    },
    {
      "id": "readme.update_version",
      "service": "readme",
      "name": "update_version",
      "description": "Update one ReadMe project version by semver identifier.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "versionId": {
            "type": "string",
            "minLength": 1,
            "description": "The semver identifier for the ReadMe project version to update."
          },
          "version": {
            "type": "string",
            "minLength": 1,
            "description": "The semantic version identifier for the ReadMe project version."
          },
          "codename": {
            "type": "string",
            "description": "The codename for the ReadMe project version."
          },
          "from": {
            "type": "string",
            "minLength": 1,
            "description": "The semantic version to use as the base fork."
          },
          "is_stable": {
            "type": "boolean",
            "description": "Whether this version should be the main stable version."
          },
          "is_beta": {
            "type": "boolean",
            "description": "Whether this version is beta."
          },
          "is_hidden": {
            "type": "boolean",
            "description": "Whether this version is hidden."
          },
          "is_deprecated": {
            "type": "boolean",
            "description": "Whether this version is deprecated."
          },
          "pdfStatus": {
            "type": "string",
            "description": "The PDF generation status for the version."
          }
        },
        "additionalProperties": false,
        "required": [
          "versionId"
        ],
        "description": "The ReadMe version update payload."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "version": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The ReadMe version returned by the API."
          }
        },
        "additionalProperties": false,
        "description": "The ReadMe project version response."
      }
    }
  ]
}