{
  "protocolVersion": "1.0.0",
  "name": "Buddy MCP",
  "version": "1.0.0",
  "description": "Buddy provides agentic infrastructure for coding agents: sandbox VMs, app and website hosting, git repositories, package registry, domains and CI/CD workflows - so agents can write, review, test, deploy and ship software. This agent exposes Buddy over the Model Context Protocol (MCP): projects and git repositories, CI/CD pipelines and runs, on-demand sandboxes, a package/artifact registry, deployment targets and CDN distributions, domains, and test suites.",
  "url": "https://mcp.buddy.works/mcp",
  "preferredTransport": "JSONRPC",
  "provider": {
    "organization": "Buddy",
    "url": "https://buddy.works"
  },
  "documentationUrl": "https://buddy.works/docs",
  "iconUrl": "https://buddy.works/favicon.ico",
  "capabilities": {},
  "defaultInputModes": ["application/json", "text/plain"],
  "defaultOutputModes": ["application/json", "text/plain"],
  "securitySchemes": {
    "oauth2": {
      "type": "oauth2",
      "description": "OAuth 2.1 with authorization code + PKCE. Protected resource metadata: https://mcp.buddy.works/.well-known/oauth-protected-resource. A Buddy personal access token may also be used as a bearer token.",
      "flows": {
        "authorizationCode": {
          "authorizationUrl": "https://api.buddy.works/oauth2/authorize",
          "tokenUrl": "https://api.buddy.works/oauth2/token",
          "scopes": {
            "WORKSPACE": "Access workspaces, projects and members",
            "REPOSITORY_READ": "Read git repository contents",
            "EXECUTION_INFO": "Read pipeline and run details",
            "EXECUTION_RUN": "Start, cancel and retry pipeline runs",
            "EXECUTION_MANAGE": "Create, update and delete pipelines",
            "PROJECT_DELETE": "Delete projects",
            "SANDBOX_INFO": "Read sandbox details",
            "SANDBOX_MANAGE": "Create, control and delete sandboxes",
            "ARTIFACT_READ": "Read packages and artifacts",
            "ARTIFACT_WRITE": "Upload package version content",
            "ARTIFACT_MANAGE": "Create, update and delete packages",
            "TARGET_INFO": "Read deployment targets",
            "DISTRIBUTION_INFO": "Read distributions and routes",
            "DISTRIBUTION_ADD": "Add distribution routes",
            "DISTRIBUTION_MANAGE": "Create and delete distributions and routes",
            "ZONE_READ": "Read domains and DNS zones",
            "ZONE_WRITE": "Register, buy and claim domains",
            "VISUAL_TEST_INFO": "Read visual test suites",
            "VISUAL_TEST_MANAGE": "Create visual test suites",
            "UNIT_TEST_INFO": "Read unit test suites",
            "UNIT_TEST_MANAGE": "Create unit test suites",
            "CRAWL_INFO": "Read crawl test suites",
            "CRAWL_MANAGE": "Create crawl test suites",
            "USER_INFO": "Read the authenticated user's profile",
            "USER_KEY": "Manage the user's SSH keys"
          }
        }
      }
    }
  },
  "security": [{ "oauth2": [] }],
  "skills": [
    {
      "id": "manage-projects",
      "name": "Manage projects and git repositories",
      "description": "Create, update and delete projects and inspect their git repositories — branches, commits, tags and pull requests.",
      "tags": ["projects", "git", "repositories", "commits", "pull-requests"]
    },
    {
      "id": "run-pipelines",
      "name": "Run and monitor CI/CD pipelines",
      "description": "Create and edit pipelines (YAML), start, cancel, retry and approve runs, and read per-action status and logs.",
      "tags": ["ci-cd", "pipelines", "builds", "deployments", "automation"]
    },
    {
      "id": "manage-sandboxes",
      "name": "Manage sandboxes",
      "description": "Create and control on-demand sandbox VMs, run shell commands, transfer files, manage snapshots and run apps inside them.",
      "tags": ["sandbox", "vm", "environments", "shell", "snapshots"]
    },
    {
      "id": "manage-packages",
      "name": "Manage the package and artifact registry",
      "description": "Create packages and versions, browse and edit their contents, and upload or download files and ZIP archives.",
      "tags": ["packages", "artifacts", "registry", "storage"]
    },
    {
      "id": "manage-deployments",
      "name": "Manage deployment targets and CDN distributions",
      "description": "Inspect deployment targets and create distributions with routes that map domains and paths to per-region targets.",
      "tags": ["deployments", "targets", "distributions", "cdn", "routing"]
    },
    {
      "id": "manage-domains",
      "name": "Manage domains and DNS zones",
      "description": "List domains and DNS zones, check availability, suggest and buy domains, and claim free sub-names under Buddy-owned zones.",
      "tags": ["domains", "dns", "zones"]
    },
    {
      "id": "manage-test-suites",
      "name": "Manage test suites",
      "description": "List and create visual, unit and crawl test suites and obtain their run tokens.",
      "tags": ["testing", "visual-tests", "unit-tests", "crawl"]
    },
    {
      "id": "workspace-admin",
      "name": "Inspect workspaces and users",
      "description": "Identify the authenticated user, list workspaces and their members, and manage the user's SSH keys.",
      "tags": ["workspace", "members", "users", "ssh-keys"]
    }
  ]
}