{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "app.while.sh",
    "site": "while.sh",
    "addresses": [
      {
        "address": "85.208.144.96",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 35426,
          "name": "NEXTMAP - NXT Initiative SAS",
          "prefix": "85.208.144.0/22",
          "country": "FR"
        }
      },
      {
        "address": "2a09:8740:4001:ff00::10",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 35426,
          "name": "NEXTMAP - NXT Initiative SAS",
          "prefix": "2a09:8740::/29",
          "country": "FR"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "85.208.144.96",
          "2a09:8740:4001:ff00::10"
        ],
        "first_seen": "2026-11-21T19:39:01.738Z",
        "last_seen": "2026-11-21T19:39:01.738Z",
        "checks": 1
      }
    ],
    "hosting": [],
    "software": [],
    "server_info": {
      "name": "while",
      "version": "2.3.0",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "strict-transport-security": "max-age=31536000",
      "access-control-allow-origin": "*"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 0,
      "sample": []
    },
    "same_site": {
      "total": 0,
      "sample": []
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "sh.while",
      "total": 0,
      "sample": []
    },
    "same_repository": null,
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "46168",
    "server_name": "sh.while/while",
    "url": "https://app.while.sh/mcp",
    "host": "app.while.sh",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-21T19:39:01.738Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "9aeae9fcaef9ed394f390737869b7d7855372c88dad236806b40801153383769",
    "first_listed_at": "2026-11-21T19:39:01.738Z",
    "created_at": "2026-11-21T13:20:14.564Z",
    "resolved_addresses": [
      "85.208.144.96",
      "2a09:8740:4001:ff00::10"
    ]
  },
  "server": {
    "name": "sh.while/while",
    "title": "while.sh",
    "description": "Deploy and share tools built with Claude or ChatGPT: your team, a client or everyone. No sign-up.",
    "version": "2.3.0",
    "registry_status": "active",
    "repository_url": null,
    "website_url": "https://while.sh/en/",
    "published_at": "2026-11-21T08:40:47.864Z",
    "updated_at": "2026-11-21T08:40:47.864Z",
    "first_seen": "2026-11-21T13:20:13.869Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [
      "reads-chain",
      "runs-agents",
      "vector-search",
      "writes-files"
    ],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T16:04:39.467Z"
  },
  "operator": null,
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 1,
    "answered": 1,
    "answered_percent": 100,
    "avg_listing_latency_ms": 1068,
    "first_check_in_window": "2026-11-21T19:39:01.738Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "9aeae9fcaef9ed394f390737869b7d7855372c88dad236806b40801153383769",
    "tools": 45,
    "resources": 0,
    "prompts": 0,
    "first_seen": "2026-11-21T19:39:02.808Z",
    "tool_names": [
      "get_catalog",
      "search_docs",
      "read_source",
      "upload_source",
      "write_files",
      "plan_deploy",
      "deploy_app",
      "get_app_status",
      "list_approvals",
      "get_environment",
      "set_env",
      "query_database",
      "get_logs",
      "observe_app",
      "send_feedback",
      "list_feedback",
      "get_project",
      "create_project",
      "keep_trial",
      "open_trial_app",
      "sign_up",
      "load_tools",
      "link_git_repo",
      "apply_plan",
      "rollback_app",
      "create_preview",
      "request_access_link",
      "backup_database",
      "restore_backup",
      "list_tasks",
      "run_task",
      "acknowledge_announcement",
      "explain_access",
      "request_access",
      "get_activity_log",
      "list_connections",
      "declare_connection",
      "call_connection",
      "get_organization",
      "invite_member",
      "grant_role",
      "revoke_role",
      "create_token",
      "update_connection",
      "set_connection_binding"
    ],
    "declared": {
      "tools": [
        {
          "name": "get_catalog",
          "title": "Read while's catalog",
          "description": "What while can run, block by block: what it does, its cost, the while.yaml line that declares it.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "block": {
                "type": "string",
                "description": "format detail: a single building block, by its id (postgres, valkey…)."
              },
              "trial": {
                "type": "string",
                "description": "The key returned by the call that created the trial (deploy_app, upload_source or write_files: trial_key), passed again on each call."
              },
              "format": {
                "enum": [
                  "text",
                  "detail",
                  "json",
                  "guide",
                  "dockerfile"
                ],
                "type": "string",
                "default": "text",
                "description": "text: the contract and the blocks; detail: one block (block); guide: designing an app; dockerfile: a typical Dockerfile (language); json: the summary."
              },
              "language": {
                "enum": [
                  "rails",
                  "laravel",
                  "rust",
                  "java-maven",
                  "java-gradle",
                  "dotnet",
                  "hugo"
                ],
                "type": "string",
                "description": "format dockerfile: the typical Dockerfile for this language; without it: the list."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Read while's catalog",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "search_docs",
          "title": "Search while's docs",
          "description": "The passages of while's documentation that answer a question, with their address.",
          "inputSchema": {
            "type": "object",
            "required": [
              "query"
            ],
            "properties": {
              "lang": {
                "enum": [
                  "en",
                  "fr"
                ],
                "type": "string",
                "description": "By default, the user's language."
              },
              "query": {
                "type": "string",
                "description": "The question, in a few words."
              },
              "trial": {
                "type": "string",
                "description": "The key returned by the call that created the trial (deploy_app, upload_source or write_files: trial_key), passed again on each call."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Search while's docs",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "read_source",
          "title": "Read the project's code",
          "description": "The project's code at while, without changing anything: a folder (empty path or ending in /) gives its file list; a file, its content, in pages of 60,000 characters; archive: true, the archive link of a deployed version.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "path": {
                "type": "string",
                "description": "A folder (empty, or ending in /): its list; a file: its content."
              },
              "start": {
                "type": "integer",
                "minimum": 1,
                "description": "A file: the first line returned (the rest of a long file, given by the response)."
              },
              "trial": {
                "type": "string",
                "description": "The key returned by the call that created the trial (deploy_app, upload_source or write_files: trial_key), passed again on each call."
              },
              "format": {
                "enum": [
                  "auto",
                  "base64",
                  "link"
                ],
                "type": "string",
                "default": "auto",
                "description": "archive: the archive's form."
              },
              "archive": {
                "type": "boolean",
                "description": "true: the archive link of a deployed version."
              },
              "project": {
                "type": "string",
                "description": "The project."
              },
              "version": {
                "type": "integer",
                "minimum": 1,
                "description": "archive: the version number; the live version by default."
              },
              "environment": {
                "type": "string",
                "default": "production",
                "description": "archive: the version's environment (production by default)."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Read the project's code",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "upload_source",
          "title": "Send code from a terminal",
          "description": "Trial version, not for production, online for a limited time. Without a key, this first call creates the trial. The upload command (curl) that sends the project folder to while from a terminal, through a 15-minute link; deploy_app then deploys it.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "trial": {
                "type": "string",
                "description": "The key returned by the call that created the trial (deploy_app, upload_source or write_files: trial_key), passed again on each call."
              },
              "project": {
                "type": "string",
                "description": "The project."
              },
              "language": {
                "enum": [
                  "en",
                  "fr"
                ],
                "type": "string",
                "description": "Trial creation: your human's language. while's texts for them are in that language, to_say included. Without this parameter, your session's language, then English."
              },
              "terminal": {
                "type": "boolean",
                "description": "true: the curl command even when the client presents itself as a conversation (a client with a terminal that reaches while)."
              },
              "environment": {
                "type": "string",
                "default": "production",
                "description": "Production or a preview."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Send code from a terminal",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "write_files",
          "title": "Write project files",
          "description": "Trial version, not for production, online for a limited time. Without a key, this first call creates the trial. A commit on the project's branch at while, without a terminal: each named file is replaced by its full content, those in delete are removed; deploy_app then deploys this commit. 2 MiB and 200 files per call.",
          "inputSchema": {
            "type": "object",
            "required": [
              "files"
            ],
            "properties": {
              "files": {
                "type": "object",
                "description": "Path → full text content of the file (it replaces the old one).",
                "additionalProperties": {
                  "type": "string"
                }
              },
              "trial": {
                "type": "string",
                "description": "The key returned by the call that created the trial (deploy_app, upload_source or write_files: trial_key), passed again on each call."
              },
              "delete": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "maxItems": 200,
                "description": "The files or folders to delete."
              },
              "message": {
                "type": "string",
                "description": "The commit message, in one sentence."
              },
              "project": {
                "type": "string",
                "description": "The project."
              },
              "language": {
                "enum": [
                  "en",
                  "fr"
                ],
                "type": "string",
                "description": "Trial creation: your human's language. while's texts for them are in that language, to_say included. Without this parameter, your session's language, then English."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Write project files",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "plan_deploy",
          "title": "Plan a deployment",
          "description": "What a deployment would change, block by block, and what each block costs per month; the plan is kept for apply_plan.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "trial": {
                "type": "string",
                "description": "The key returned by the call that created the trial (deploy_app, upload_source or write_files: trial_key), passed again on each call."
              },
              "intent": {
                "type": "string",
                "description": "Content of while.yaml; without it, the one in the latest commit at while (like deploy_app), otherwise the last one deployed."
              },
              "plan_id": {
                "type": "string",
                "description": "Reread this plan (computed earlier) instead of computing one."
              },
              "project": {
                "type": "string",
                "description": "The project."
              },
              "from_state": {
                "type": "integer",
                "description": "Go back to a state version (number given by observe_app { view: \"history\" }): the plan says what to change to get it back; then apply_plan."
              },
              "environment": {
                "type": "string",
                "default": "production",
                "description": "Production or a preview."
              },
              "timeout_seconds": {
                "type": "integer",
                "default": 120,
                "description": "Longest wait, in seconds."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Plan a deployment",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "deploy_app",
          "title": "Deploy an app",
          "description": "Trial version, not for production, online for a limited time. Without a key, this first call creates the trial. Builds the code sent (or the GitHub or GitLab repository linked with link_git_repo, or an image) and deploys it to an environment, in place of the previous version; the response gives the version, its address, its build and what changed.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "wait": {
                "type": "boolean",
                "default": true,
                "description": "false: returns at once (follow with deploy_app { release })."
              },
              "image": {
                "type": "string",
                "description": "OCI image already built (while registry or external), ideally with its digest."
              },
              "trial": {
                "type": "string",
                "description": "The key returned by the call that created the trial (deploy_app, upload_source or write_files: trial_key), passed again on each call."
              },
              "digest": {
                "type": "string",
                "description": "sha256:<64 hex>; without it, while resolves it: the image always goes by its digest."
              },
              "intent": {
                "type": "string",
                "description": "Content of while.yaml, when deploying an image without sending sources."
              },
              "project": {
                "type": "string",
                "description": "The project."
              },
              "release": {
                "type": "integer",
                "description": "The number returned by an upload (or a version in progress): deploy_app follows its build and its deployment."
              },
              "language": {
                "enum": [
                  "en",
                  "fr"
                ],
                "type": "string",
                "description": "Trial creation: your human's language. while's texts for them are in that language, to_say included. Without this parameter, your session's language, then English."
              },
              "redeploy": {
                "type": "integer",
                "description": "A version already built, put back online with today's variables and secrets (after set_env, or to restart an app that went down), without rebuilding. Going back: rollback_app."
              },
              "environment": {
                "type": "string",
                "default": "production",
                "description": "Production or a preview."
              },
              "timeout_seconds": {
                "type": "integer",
                "default": 300,
                "maximum": 1800,
                "description": "Maximum wait; beyond it, the response says how to resume."
              },
              "confirm_overwrite": {
                "type": "boolean",
                "description": "true: while.yaml overwrites what a person changed on screen."
              },
              "source_archive_base64": {
                "type": "string",
                "description": "Last resort, slow: the tar.gz archive of the sources, in base64. Exclusive with image and release."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Deploy an app",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "get_app_status",
          "title": "Read an app's status",
          "description": "An environment's state: its live version, its addresses, its health, its services, its recent traffic; include: its live while.yaml (while_yaml), its known vulnerabilities and the bots seen (vulnerabilities), or who opened the app, when and how (openings).",
          "inputSchema": {
            "type": "object",
            "properties": {
              "probe": {
                "type": "boolean",
                "default": true,
                "description": "false: without probing (does not wake a sleeping service)."
              },
              "since": {
                "type": "string",
                "default": "24h",
                "description": "vulnerabilities: the window of bots seen in the traffic; openings: the window of openings, 7d without since (30m, 6h, 7d…)."
              },
              "trial": {
                "type": "string",
                "description": "The key returned by the call that created the trial (deploy_app, upload_source or write_files: trial_key), passed again on each call."
              },
              "include": {
                "type": "array",
                "items": {
                  "enum": [
                    "while_yaml",
                    "vulnerabilities",
                    "openings"
                  ],
                  "type": "string"
                },
                "maxItems": 1,
                "description": "An extra view on top of the state: while_yaml, vulnerabilities or openings."
              },
              "project": {
                "type": "string",
                "description": "The project."
              },
              "environment": {
                "type": "string",
                "default": "production",
                "description": "Production or a preview."
              },
              "renew_keep_link": {
                "type": "boolean",
                "description": "true: a new claim link, and the one given before stops working. Without this parameter, the link that is still valid."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Read an app's status",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_approvals",
          "title": "Read pending approvals",
          "description": "The approvals a person still has to grant in while (a production deployment, a restore…), and their state; id: a single one.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Id of a request (approval_id): its detail, even decided."
              },
              "trial": {
                "type": "string",
                "description": "The key returned by the call that created the trial (deploy_app, upload_source or write_files: trial_key), passed again on each call."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Read pending approvals",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_environment",
          "title": "Read an environment",
          "description": "An environment, by view: variables, the names of its variables and secrets (never the values); domains, its domains and their DNS proof; links, its access links (never the link); backups, the last 50 backups of a database (their id for restore_backup); queues, its queues and their state.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "view": {
                "enum": [
                  "variables",
                  "domains",
                  "links",
                  "backups",
                  "queues"
                ],
                "type": "string",
                "default": "variables",
                "description": "The view returned."
              },
              "trial": {
                "type": "string",
                "description": "The key returned by the call that created the trial (deploy_app, upload_source or write_files: trial_key), passed again on each call."
              },
              "project": {
                "type": "string",
                "description": "The project."
              },
              "database": {
                "type": "string",
                "description": "Database name; the first declared by default."
              },
              "environment": {
                "type": "string",
                "default": "production",
                "description": "Production or a preview."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Read an environment",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "set_env",
          "title": "Set variables and secrets",
          "description": "Sets or removes an environment's variables and secrets (in the vault by default, never read back); they apply at the next deployment. get_environment { view: \"variables\" } reads their names.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "key": {
                "type": "string",
                "description": "A single variable: its name (with \"value\"), instead of \"values\"."
              },
              "file": {
                "type": "boolean",
                "default": false,
                "description": "true: a secret delivered as a file, never as a variable: the app reads it in /run/secrets/<NAME>. Required for a secret in the production of a project linked to a federated connection."
              },
              "move": {
                "type": "string",
                "description": "A name: this secret moves to the build (build: true) or to the app, its value kept in the vault."
              },
              "build": {
                "type": "boolean",
                "default": false,
                "description": "true: a build secret (build.secrets, e.g. NPM_TOKEN), read by builds only, never by the app. With delete: removes one."
              },
              "trial": {
                "type": "string",
                "description": "The key returned by the call that created the trial (deploy_app, upload_source or write_files: trial_key), passed again on each call."
              },
              "value": {
                "type": "string",
                "description": "A single variable: its value (with \"key\")."
              },
              "delete": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "maxItems": 100,
                "description": "Names of the variables or secrets to delete from this environment."
              },
              "secret": {
                "type": "boolean",
                "default": true,
                "description": "true: in the vault, never read back (default). false: plain variable, which a person reads back in while, never an agent."
              },
              "values": {
                "type": "object",
                "description": "Key/value pairs. Example: { \"LOG_LEVEL\": \"debug\" }",
                "additionalProperties": {
                  "type": "string"
                }
              },
              "project": {
                "type": "string",
                "description": "The project."
              },
              "environment": {
                "type": "string",
                "default": "production",
                "description": "Production or a preview."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Set variables and secrets",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "query_database",
          "title": "Read a database with SQL",
          "description": "A read-only SQL query on one of the project's PostgreSQL databases; format short (default; a cut response says how to read the rest), detailed (wider limits) or csv (an export).",
          "inputSchema": {
            "type": "object",
            "required": [
              "sql"
            ],
            "properties": {
              "sql": {
                "type": "string",
                "description": "A read statement."
              },
              "limit": {
                "type": "integer",
                "maximum": 50000,
                "minimum": 1,
                "description": "Row cap: short 200, detailed 400 (2,000 at most); csv 10,000 (50,000)."
              },
              "trial": {
                "type": "string",
                "description": "The key returned by the call that created the trial (deploy_app, upload_source or write_files: trial_key), passed again on each call."
              },
              "format": {
                "enum": [
                  "short",
                  "detailed"
                ],
                "type": "string",
                "default": "short",
                "description": "The response format."
              },
              "project": {
                "type": "string",
                "description": "The project."
              },
              "database": {
                "type": "string",
                "description": "Name of the database (databases[].name); the first declared by default."
              },
              "max_bytes": {
                "type": "integer",
                "maximum": 200000,
                "minimum": 1000,
                "description": "Byte limit: short 40 KB, detailed and csv 200 KB."
              },
              "environment": {
                "type": "string",
                "default": "production",
                "description": "Production or a preview."
              },
              "timeout_seconds": {
                "type": "number",
                "default": 10,
                "maximum": 30,
                "minimum": 0.5,
                "description": "Query timeout."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Read a database with SQL",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_logs",
          "title": "Read logs",
          "description": "An environment's logs (or a build's: build_id), most recent first, filterable by a text.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer",
                "maximum": 1000,
                "description": "Lines returned: 100 by default, 200 with build_id; 1,000 at most."
              },
              "query": {
                "type": "string",
                "description": "A LogsQL filter (VictoriaLogs' query language: https://docs.victoriametrics.com/victorialogs/logsql/), for example \"timeout\"; \"error\": the error lines."
              },
              "trial": {
                "type": "string",
                "description": "The key returned by the call that created the trial (deploy_app, upload_source or write_files: trial_key), passed again on each call."
              },
              "project": {
                "type": "string",
                "description": "The project."
              },
              "build_id": {
                "type": "string",
                "description": "To read a build's log rather than the application's."
              },
              "environment": {
                "type": "string",
                "default": "production",
                "description": "Production or a preview."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Read logs",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "observe_app",
          "title": "Understand what is happening",
          "description": "What is happening in production, by view: metrics, traces, errors (grouped), history (versions and events), timeline, impact (a version's effect), database (frequent and slow SQL queries) or ask (dated facts around a question).",
          "inputSchema": {
            "type": "object",
            "properties": {
              "view": {
                "enum": [
                  "metrics",
                  "traces",
                  "errors",
                  "history",
                  "timeline",
                  "impact",
                  "database",
                  "ask"
                ],
                "type": "string",
                "default": "metrics",
                "description": "The view returned."
              },
              "limit": {
                "type": "integer",
                "default": 20,
                "description": "100 at most."
              },
              "query": {
                "type": "string",
                "description": "A PromQL query (Prometheus' query language: https://prometheus.io/docs/prometheus/latest/querying/basics/); without it, traffic and errors."
              },
              "range": {
                "enum": [
                  "15m",
                  "1h",
                  "24h",
                  "7d"
                ],
                "type": "string",
                "default": "1h",
                "description": "The window."
              },
              "since": {
                "type": "string",
                "default": "24h",
                "description": "Window: 30m, 2h, 1d, or an ISO 8601 date."
              },
              "trial": {
                "type": "string",
                "description": "The key returned by the call that created the trial (deploy_app, upload_source or write_files: trial_key), passed again on each call."
              },
              "until": {
                "type": "string",
                "description": "End (ISO 8601 date); now by default."
              },
              "errors": {
                "type": "boolean",
                "default": false,
                "description": "Only the traces with a span in error."
              },
              "project": {
                "type": "string",
                "description": "The project."
              },
              "service": {
                "type": "string",
                "description": "The app's OTEL_SERVICE_NAME; by default, the project's name (what while sets)."
              },
              "version": {
                "type": "integer",
                "description": "Version number; the active version by default."
              },
              "database": {
                "type": "string",
                "description": "Database name; the first declared by default."
              },
              "families": {
                "type": "array",
                "items": {
                  "enum": [
                    "build",
                    "plan",
                    "deploy",
                    "rollback",
                    "incident",
                    "error",
                    "preview",
                    "approval",
                    "sleep",
                    "data",
                    "task",
                    "security",
                    "cost",
                    "agent",
                    "other"
                  ],
                  "type": "string"
                },
                "description": "Keep only these families."
              },
              "question": {
                "type": "string",
                "minLength": 3,
                "description": "The question, in plain words."
              },
              "trace_id": {
                "type": "string",
                "description": "One trace in detail: its id (32 hexadecimal characters)."
              },
              "operation": {
                "type": "string",
                "description": "Only the traces of this operation (span name), for example \"GET /orders\"."
              },
              "environment": {
                "type": "string",
                "default": "production",
                "description": "Production or a preview."
              },
              "fingerprint": {
                "type": "string",
                "description": "Fingerprint of a group, for its detail."
              },
              "min_duration": {
                "type": "string",
                "description": "Only the traces longer than this, for example \"500ms\" or \"2s\"."
              },
              "since_minutes": {
                "type": "integer",
                "default": 60,
                "description": "Window, in minutes (30 days at most)."
              },
              "window_minutes": {
                "type": "integer",
                "default": 30,
                "maximum": 1440,
                "minimum": 5,
                "description": "The compared window, before and after the version."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Understand what is happening",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "send_feedback",
          "title": "Send feedback to the while team",
          "description": "Sends feedback to the while team in the person's words, at their request. It also requests a block (kind: \"block\") as soon as the person's need calls for it. while attaches who sends it, the organization, its version and the last 5 failed calls of this identity (the tool and the code only), never the conversation.",
          "inputSchema": {
            "type": "object",
            "required": [
              "kind",
              "message"
            ],
            "properties": {
              "kind": {
                "enum": [
                  "bug",
                  "frustration",
                  "idea",
                  "other",
                  "integration",
                  "block"
                ],
                "type": "string",
                "description": "bug (while is wrong), frustration (the user's, in their words), idea, other, integration (a service to connect), block (a block to open)."
              },
              "tool": {
                "type": "string",
                "description": "The MCP tool concerned."
              },
              "block": {
                "type": "string",
                "maxLength": 60,
                "description": "block: the block (its id in catalog)."
              },
              "route": {
                "type": "string",
                "description": "The API route concerned (\"POST /v1/…\")."
              },
              "trial": {
                "type": "string",
                "description": "The key returned by the call that created the trial (deploy_app, upload_source or write_files: trial_key), passed again on each call."
              },
              "usage": {
                "type": "string",
                "maxLength": 1000,
                "description": "integration, block: what the app wants to do with it."
              },
              "volume": {
                "type": "string",
                "maxLength": 200,
                "description": "block: the expected volume (sends per day, GiB…)."
              },
              "message": {
                "type": "string",
                "maxLength": 4000,
                "description": "What happens, what was expected; 4,000 characters at most."
              },
              "project": {
                "type": "string",
                "description": "The project concerned."
              },
              "service": {
                "type": "string",
                "maxLength": 100,
                "description": "integration: the service to connect (Stripe, Snowflake, Anthropic…)."
              },
              "reference": {
                "type": "string",
                "description": "The identifier of an error, a call or an approval."
              },
              "organization": {
                "type": "string",
                "description": "The organization; otherwise the project's or the token's."
              },
              "documentation": {
                "type": "string",
                "pattern": "^https://",
                "maxLength": 500,
                "description": "integration: the https address of its documentation."
              },
              "authentication": {
                "enum": [
                  "api_key",
                  "oauth",
                  "oidc_federation",
                  "other"
                ],
                "type": "string",
                "description": "integration: how the service authenticates (API key, OAuth, OIDC federation, other)."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Send feedback to the while team",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "list_feedback",
          "title": "Read feedback and replies",
          "description": "The feedback sent to the while team and its replies; organization: the organization's feedback (its admins).",
          "inputSchema": {
            "type": "object",
            "properties": {
              "trial": {
                "type": "string",
                "description": "The key returned by the call that created the trial (deploy_app, upload_source or write_files: trial_key), passed again on each call."
              },
              "organization": {
                "type": "string",
                "description": "The whole organization's feedback (its admins)."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Read feedback and replies",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_project",
          "title": "Read projects",
          "description": "Without project, the projects the identity sees; project, one project and its environments; include: [\"webhooks\"], its webhooks.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "trial": {
                "type": "string",
                "description": "The key returned by the call that created the trial (deploy_app, upload_source or write_files: trial_key), passed again on each call."
              },
              "include": {
                "type": "array",
                "items": {
                  "enum": [
                    "webhooks"
                  ],
                  "type": "string"
                },
                "maxItems": 1,
                "description": "webhooks: its webhooks."
              },
              "project": {
                "type": "string",
                "description": "A project; without it, the list."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Read projects",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "create_project",
          "title": "Create a project",
          "description": "Creates a project in an organization, with its monthly budget (€20 by default); deploy_app then deploys an app to it.",
          "inputSchema": {
            "type": "object",
            "required": [
              "project"
            ],
            "properties": {
              "name": {
                "type": "string",
                "description": "The display name (the project name by default)."
              },
              "trial": {
                "type": "string",
                "description": "The key returned by the call that created the trial (deploy_app, upload_source or write_files: trial_key), passed again on each call."
              },
              "project": {
                "type": "string",
                "description": "The project name (lowercase letters, digits, hyphens)."
              },
              "budget_eur": {
                "type": "number",
                "minimum": 0,
                "description": "Euros per month (20 by default; 0, no cap, or more than €20: admins); alert at 80% then 100%."
              },
              "organization": {
                "type": "string",
                "description": "The organization that holds it (the token's by default)."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Create a project",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "keep_trial",
          "title": "Keep the trial app",
          "description": "When the user wants to keep their trial app: returns the link that keeps it in their own organization. Ask them first for their organization's name, and for the project's name, which makes the app's address; the page proposes names and lets them change them.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "trial": {
                "type": "string",
                "description": "The key returned by the call that created the trial (deploy_app, upload_source or write_files: trial_key), passed again on each call."
              },
              "project_name": {
                "type": "string",
                "maxLength": 40,
                "description": "The project, which makes the app's address."
              },
              "organization_name": {
                "type": "string",
                "maxLength": 60,
                "description": "The user's organization."
              }
            }
          },
          "annotations": {
            "title": "Keep the trial app",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "open_trial_app",
          "title": "Open the trial app",
          "description": "To check the trial app yourself, past the \"Trial tool\" page that visitors see first: a one-hour identifier for its address, tied to the trial key. Write cookie.value to the file named in file, then run the curl command (or the Playwright setting), which reads it from there: never in an argument. read_only: GET and HEAD only.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "trial": {
                "type": "string",
                "description": "The key returned by the call that created the trial (deploy_app, upload_source or write_files: trial_key), passed again on each call."
              },
              "read_only": {
                "type": "boolean",
                "default": false,
                "description": "GET and HEAD only."
              }
            }
          },
          "annotations": {
            "title": "Open the trial app",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "sign_up",
          "title": "Create the user's while account",
          "description": "Sends the user's email address to while, which emails them a link (60 min) to choose a password. With the trial key, the trial app moves to their account. The link and the password are never returned here.",
          "inputSchema": {
            "type": "object",
            "required": [
              "email"
            ],
            "properties": {
              "email": {
                "type": "string",
                "description": "The user's email address."
              },
              "trial": {
                "type": "string",
                "description": "The key returned by the call that created the trial (deploy_app, upload_source or write_files: trial_key), passed again on each call."
              }
            }
          },
          "annotations": {
            "title": "Create the user's while account",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "load_tools",
          "title": "Load a tool group",
          "description": "Ajoute un groupe d'outils à cet agent : alerts (alertes, incidents, canaux), feedback_and_docs (remarques de page, retours, doc), environments_and_storage (domaines, applis internes, identifiant git, buckets, détruire ou redémarrer un environnement, proposer une destination privée), administer (membres, groupes, rôles, accès, jetons, comptes de service, liaisons, consommation, réglages et suppression des projets, réglages de l'organisation), functions (jouer la fonction devant une connexion).",
          "inputSchema": {
            "type": "object",
            "required": [
              "group"
            ],
            "properties": {
              "group": {
                "enum": [
                  "alerts",
                  "feedback_and_docs",
                  "environments_and_storage",
                  "administer",
                  "functions"
                ],
                "type": "string",
                "description": "The group to load."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Load a tool group",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "link_git_repo",
          "title": "Link a git repository",
          "description": "Keeps the code on GitHub or GitLab: a push to the default branch deploys production, a pull or merge request opens a preview; unlink removes the link.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "repo": {
                "type": "string",
                "description": "\"owner/name\" (GitHub) or \"group/project\" (GitLab)."
              },
              "forge": {
                "enum": [
                  "github",
                  "gitlab"
                ],
                "type": "string",
                "description": "The repository's forge."
              },
              "token": {
                "type": "string",
                "description": "Access token for the forge; it goes to the vault."
              },
              "unlink": {
                "type": "boolean",
                "default": false,
                "description": "true: removes the link and the webhook."
              },
              "project": {
                "type": "string",
                "description": "The project."
              },
              "base_url": {
                "type": "string",
                "description": "Address of a self-hosted GitLab."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Link a git repository",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "apply_plan",
          "title": "Apply a plan",
          "description": "Applies a plan computed by plan_deploy (what it changes goes live); discard: true drops it without applying anything.",
          "inputSchema": {
            "type": "object",
            "required": [
              "plan_id"
            ],
            "properties": {
              "wait": {
                "type": "boolean",
                "default": true,
                "description": "true: answers once done."
              },
              "discard": {
                "type": "boolean",
                "default": false,
                "description": "true: drop the plan instead of applying it."
              },
              "plan_id": {
                "type": "string",
                "description": "The plan returned by plan_deploy."
              },
              "project": {
                "type": "string",
                "description": "The project."
              },
              "timeout_seconds": {
                "type": "integer",
                "default": 300,
                "description": "Longest wait, in seconds."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Apply a plan",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "rollback_app",
          "title": "Roll back to a previous version",
          "description": "Puts a previous version of an environment back online (the previous one by default, or to); the live version is replaced.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "to": {
                "type": "integer",
                "description": "The target version number; without it, the previous active version."
              },
              "wait": {
                "type": "boolean",
                "default": true,
                "description": "true: answers once done."
              },
              "project": {
                "type": "string",
                "description": "The project."
              },
              "approval_id": {
                "type": "string",
                "description": "Approval granted, when the organization requires an approval for a rollback in production."
              },
              "environment": {
                "type": "string",
                "default": "production",
                "description": "Production or a preview."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Roll back to a previous version",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "create_preview",
          "title": "Create a preview",
          "description": "A preview environment for a branch, with its own address.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "from": {
                "type": "string",
                "default": "production",
                "description": "Reference environment."
              },
              "name": {
                "type": "string",
                "description": "Name of the environment (otherwise, the branch)."
              },
              "wait": {
                "type": "boolean",
                "default": true,
                "description": "true: answers once done."
              },
              "branch": {
                "type": "string",
                "description": "The Git branch."
              },
              "project": {
                "type": "string",
                "description": "The project."
              },
              "ttl_hours": {
                "type": "integer",
                "default": 24,
                "description": "Lifetime of the preview, in hours."
              },
              "copy_database": {
                "type": "boolean",
                "default": false,
                "description": "Copy the production data (otherwise empty databases): needs data.backup on its databases."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Create a preview",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "request_access_link",
          "title": "Share an app with a link",
          "description": "Share an internal app, show it to a client or a tester without a while account: requests a sharing link (access link); a person creates it and passes it on in while. With dev_address: the workstation's dev address (its dev server), 7 days at most.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "days": {
                "type": "integer",
                "description": "The proposed expiry: 1, 7 or 30 days (otherwise 7)."
              },
              "name": {
                "type": "string",
                "description": "The proposed name of the link (\"Dupont client demo\")."
              },
              "project": {
                "type": "string",
                "description": "The project."
              },
              "dev_address": {
                "type": "string",
                "description": "The name of a dev address (what follows -dev- in <project>-dev-<name>): share it rather than an environment."
              },
              "environment": {
                "type": "string",
                "default": "production",
                "description": "Production or a preview."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Share an app with a link",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "backup_database",
          "title": "Back up a database",
          "description": "Starts a backup of a database declared in while.yaml, and a test restore on a throwaway database that proves it.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "wait": {
                "type": "boolean",
                "default": false,
                "description": "Wait for the backup (and its restore test) to receive its id and its result."
              },
              "project": {
                "type": "string",
                "description": "The project."
              },
              "database": {
                "type": "string",
                "description": "Database name; the first declared by default."
              },
              "environment": {
                "type": "string",
                "default": "production",
                "description": "Production or a preview."
              },
              "test_restore": {
                "type": "boolean",
                "default": true,
                "description": "Restore it to a throwaway database, to prove it."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Back up a database",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "restore_backup",
          "title": "Restore a database",
          "description": "Restores a database from a backup (the last successful one by default) or to a point in time; its current data is replaced, with an approval in production.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "wait": {
                "type": "boolean",
                "default": false,
                "description": "true: answers once done."
              },
              "reason": {
                "type": "string",
                "description": "Why restore, in one sentence for the person who approves."
              },
              "instant": {
                "type": "string",
                "description": "Restore the database to this instant (ISO 8601), 14 days at most; excludes backup_id."
              },
              "project": {
                "type": "string",
                "description": "The project."
              },
              "database": {
                "type": "string",
                "description": "Database name; the first declared by default."
              },
              "backup_id": {
                "type": "string",
                "description": "The backup (get_environment { view: \"backups\" }); the last successful one by default."
              },
              "approval_id": {
                "type": "string",
                "description": "The granted approval (its id), when the action needs one."
              },
              "environment": {
                "type": "string",
                "default": "production",
                "description": "Production or a preview."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Restore a database",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "list_tasks",
          "title": "List the scheduled jobs",
          "description": "An environment's scheduled jobs, their schedule, their last runs and the next one.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "task": {
                "type": "string",
                "description": "Name of a task, for its detailed history."
              },
              "limit": {
                "type": "integer",
                "default": 20,
                "maximum": 200,
                "description": "Number of runs in the detailed history."
              },
              "project": {
                "type": "string",
                "description": "The project."
              },
              "environment": {
                "type": "string",
                "default": "production",
                "description": "Production or a preview."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List the scheduled jobs",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "run_task",
          "title": "Run a job",
          "description": "Runs one of the app's scheduled jobs from its while.yaml now, without waiting for its time: the app's code, in its environment; while runs nothing else.",
          "inputSchema": {
            "type": "object",
            "required": [
              "task"
            ],
            "properties": {
              "env": {
                "type": "object",
                "description": "Extra variables for this run only.",
                "additionalProperties": {
                  "type": "string"
                }
              },
              "args": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "maxItems": 20,
                "description": "Arguments appended to the command, for example [\"--since\", \"2026-10-12\"]."
              },
              "task": {
                "type": "string",
                "description": "Name of the task (crons[].name)."
              },
              "wait": {
                "type": "boolean",
                "default": false,
                "description": "true: answers once done."
              },
              "project": {
                "type": "string",
                "description": "The project."
              },
              "catch_up": {
                "type": "object",
                "required": [
                  "start"
                ],
                "properties": {
                  "end": {
                    "type": "string",
                    "description": "End of the period (included); the start by default."
                  },
                  "start": {
                    "type": "string",
                    "description": "Start of the period: 2026-10-12, or an ISO 8601 instant."
                  }
                },
                "description": "Period to catch up: the run is counted \"catch_up\" and receives it as variables.",
                "additionalProperties": false
              },
              "approval_id": {
                "type": "string",
                "description": "Approval granted, if the organization requires one for a task in production."
              },
              "environment": {
                "type": "string",
                "default": "production",
                "description": "Production or a preview."
              },
              "timeout_seconds": {
                "type": "integer",
                "default": 300,
                "maximum": 1800,
                "description": "Longest wait, in seconds."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Run a job",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "acknowledge_announcement",
          "title": "Acknowledge an announcement",
          "description": "Records that an announcement from the while team has been read.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "The id of the announcement (id, in the announcements)."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Acknowledge an announcement",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "explain_access",
          "title": "Explain access",
          "description": "Who has access to what, in sentences; with who and permission, yes or no and why (the chain that grants it, or what is missing); activity: what this identity did with it.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "who": {
                "type": "string",
                "description": "An address, group:<name>, service_account:<name>, app:<project>/<service>, task:<project>/<task>, or token:<id or name>."
              },
              "scope": {
                "type": "object",
                "properties": {
                  "type": {
                    "enum": [
                      "organization"
                    ],
                    "type": "string",
                    "description": "The whole organization."
                  },
                  "paths": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 100,
                    "description": "Patterns, e.g. \"/notes/**\"."
                  },
                  "table": {
                    "type": "string",
                    "description": "\"schema.table\"."
                  },
                  "schema": {
                    "type": "string",
                    "description": "PostgreSQL schema."
                  },
                  "columns": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 1600,
                    "description": "The table's columns."
                  },
                  "project": {
                    "type": "string",
                    "description": "Project name."
                  },
                  "database": {
                    "type": "string",
                    "description": "Database name."
                  },
                  "connection": {
                    "type": "string",
                    "description": "Connection name."
                  },
                  "environment": {
                    "type": "string",
                    "description": "The environment."
                  }
                },
                "description": "{}: the organization; otherwise down to a table, or a connection.",
                "additionalProperties": false
              },
              "project": {
                "type": "string",
                "description": "Shortcut for scope.project."
              },
              "activity": {
                "type": "boolean",
                "default": true,
                "description": "With who: what the identity did (log, calls)."
              },
              "permission": {
                "enum": [
                  "org.view",
                  "org.admin",
                  "access.grant",
                  "roles.define",
                  "projects.create",
                  "app.use",
                  "project.view",
                  "project.deploy",
                  "project.configure",
                  "tasks.run",
                  "project.destroy",
                  "data.read",
                  "data.write",
                  "data.schema",
                  "data.backup",
                  "connection.read",
                  "connection.write",
                  "connection.configure",
                  "log.read",
                  "log.export"
                ],
                "type": "string",
                "description": "With who: \"can X <permission> on the scope?\"."
              },
              "organization": {
                "type": "string",
                "description": "The organization."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Explain access",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "request_access",
          "title": "Request access",
          "description": "Requests a permission for the person (or their agent): whoever can grant it decides in while.",
          "inputSchema": {
            "type": "object",
            "required": [
              "reason"
            ],
            "properties": {
              "for": {
                "type": "string",
                "description": "For an app that will call a connection: app:<project>/<service> or task:<project>/<task>, role connection-caller (or connection-writer), scope { connection }."
              },
              "days": {
                "type": "integer",
                "default": 7,
                "maximum": 90,
                "minimum": 1,
                "description": "Duration, in days; not used for an app (for), whose right has no expiry."
              },
              "role": {
                "type": "string",
                "description": "The role (missing.proposed_role)."
              },
              "tool": {
                "type": "string",
                "description": "Or the id of a reserved tool (view existing)."
              },
              "renew": {
                "type": "string",
                "description": "One of your assignments to extend (only days and reason count)."
              },
              "scope": {
                "type": "object",
                "properties": {
                  "type": {
                    "enum": [
                      "organization"
                    ],
                    "type": "string",
                    "description": "The whole organization."
                  },
                  "paths": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 100,
                    "description": "Patterns, e.g. \"/notes/**\"."
                  },
                  "table": {
                    "type": "string",
                    "description": "\"schema.table\"."
                  },
                  "schema": {
                    "type": "string",
                    "description": "PostgreSQL schema."
                  },
                  "columns": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 1600,
                    "description": "The table's columns."
                  },
                  "project": {
                    "type": "string",
                    "description": "Project name."
                  },
                  "database": {
                    "type": "string",
                    "description": "Database name."
                  },
                  "connection": {
                    "type": "string",
                    "description": "Connection name."
                  },
                  "environment": {
                    "type": "string",
                    "description": "The environment."
                  }
                },
                "description": "{}: the organization; otherwise down to a table, or a connection.",
                "additionalProperties": false
              },
              "reason": {
                "type": "string",
                "description": "Why (\"Q4 audit\"), read by whoever decides."
              },
              "permission": {
                "enum": [
                  "org.view",
                  "org.admin",
                  "access.grant",
                  "roles.define",
                  "projects.create",
                  "app.use",
                  "project.view",
                  "project.deploy",
                  "project.configure",
                  "tasks.run",
                  "project.destroy",
                  "data.read",
                  "data.write",
                  "data.schema",
                  "data.backup",
                  "connection.read",
                  "connection.write",
                  "connection.configure",
                  "log.read",
                  "log.export"
                ],
                "type": "string",
                "description": "Or a permission (the smallest role that grants it)."
              },
              "organization": {
                "type": "string",
                "description": "The organization."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Request access",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "get_activity_log",
          "title": "Read the organization's activity log",
          "description": "The organization's activity log, append-only and chained: who did what and through what (a person, an agent, the API, a task, while), filterable.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "tab": {
                "enum": [
                  "all",
                  "agents",
                  "security",
                  "approvals"
                ],
                "type": "string",
                "default": "all",
                "description": "Ready-made filter."
              },
              "via": {
                "enum": [
                  "agent",
                  "app",
                  "task",
                  "interface",
                  "browser",
                  "api",
                  "while"
                ],
                "type": "string",
                "description": "What the action went through."
              },
              "who": {
                "type": "string",
                "description": "An identity, written as for explain_access (what it did)."
              },
              "limit": {
                "type": "integer",
                "default": 50,
                "maximum": 200,
                "minimum": 1,
                "description": "Maximum number of items returned."
              },
              "since": {
                "type": "string",
                "description": "Start: 30m, 24h, 7d, a date (2026-10-18) or an ISO 8601 instant."
              },
              "until": {
                "type": "string",
                "description": "End, same format; a date alone counts the whole day."
              },
              "cursor": {
                "type": "string",
                "description": "The \"next\" of a previous response."
              },
              "family": {
                "type": "string",
                "description": "Families, separated by commas: deploy, data, security, access, permissions, approval, task, alert, connection, app, observation, loop (agents' wake-ups)."
              },
              "person": {
                "type": "string",
                "description": "Address or name (partial) of the person, or \"while\"."
              },
              "verify": {
                "type": "boolean",
                "default": false,
                "description": "Check the log's chain instead of reading it."
              },
              "project": {
                "type": "string",
                "description": "Project name."
              },
              "resource": {
                "type": "string",
                "description": "Text searched in the object (\"carnet\", \"main.reservations\"), or id or type of resource."
              },
              "assignment": {
                "type": "string",
                "description": "An assignment's history (its id): granted, revoked, expired, flagged, kept."
              },
              "organization": {
                "type": "string",
                "description": "The organization."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Read the organization's activity log",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_connections",
          "title": "Read connections",
          "description": "The organization's external APIs, called through while: without connection, their list; connection, its detail, its rules and how to call it; view limits, the call limits; bindings, a federated connection's bindings.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "view": {
                "enum": [
                  "detail",
                  "limits",
                  "bindings"
                ],
                "type": "string",
                "default": "detail",
                "description": "The view returned."
              },
              "since": {
                "type": "string",
                "description": "With connection: the call log since this date (2026-10-01); 7 days by default."
              },
              "until": {
                "type": "string",
                "description": "With connection and since: up to this date (now by default)."
              },
              "refusal": {
                "type": "boolean",
                "description": "With since: refusals only."
              },
              "connection": {
                "type": "string",
                "description": "Connection name (meteo): its detail."
              },
              "organization": {
                "type": "string",
                "description": "The organization."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Read connections",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "declare_connection",
          "title": "Declare a connection",
          "description": "Declares an external API (domain, authentication without a secret, callers), to be approved; a person enters the secret in while.",
          "inputSchema": {
            "type": "object",
            "required": [
              "name"
            ],
            "properties": {
              "apps": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "maxItems": 20,
                "description": "Calling services and tasks (web, task:charger); by default, those of the while.yaml that declare it."
              },
              "name": {
                "type": "string",
                "description": "Lowercase, digits, hyphens: weather, accounting."
              },
              "read": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Patterns read with POST, allowed during learning: /api/v1/searches."
              },
              "label": {
                "type": "string",
                "description": "The displayed name (\"Pennylane\")."
              },
              "model": {
                "enum": [
                  "anthropic",
                  "openai",
                  "mistral",
                  "snowflake",
                  "snowflake_pat"
                ],
                "type": "string",
                "description": "An AI or Snowflake (account, user, role, warehouse): domain and recipe set automatically."
              },
              "owner": {
                "type": "string",
                "description": "Email of the owner; by default, the signed-in user."
              },
              "rules": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "method",
                    "pattern"
                  ],
                  "properties": {
                    "read": {
                      "type": "boolean",
                      "description": "A POST that only reads."
                    },
                    "method": {
                      "type": "string",
                      "description": "HTTP method."
                    },
                    "pattern": {
                      "type": "string",
                      "description": "Path, e.g. /api/v1/slots/*/close."
                    },
                    "approve_each_call": {
                      "type": "boolean",
                      "description": "true: each call waits for an approval."
                    }
                  },
                  "additionalProperties": false
                },
                "maxItems": 100,
                "description": "Approved with the declaration, they apply from the learning period on; federated: required. A POST that reads: its pattern also in read."
              },
              "domain": {
                "type": "string",
                "description": "API host name, no path: api.example.com."
              },
              "update": {
                "type": "boolean",
                "description": "An existing connection: read becomes the wanted list; removing applies at once, adding goes through approval."
              },
              "project": {
                "type": "string",
                "description": "The project of the calling apps; by default, the token's."
              },
              "direction": {
                "enum": [
                  "read",
                  "write"
                ],
                "type": "string",
                "default": "read",
                "description": "The apps will also write (POST, PUT, PATCH, DELETE)."
              },
              "organization": {
                "type": "string",
                "description": "The organization."
              },
              "learning_days": {
                "type": "integer",
                "default": 7,
                "maximum": 30,
                "minimum": 1,
                "description": "Days of learning."
              },
              "authentication": {
                "type": "object",
                "properties": {
                  "type": {
                    "enum": [
                      "none",
                      "header",
                      "parameter",
                      "basic",
                      "bearer",
                      "oauth2",
                      "session",
                      "jwt",
                      "federated"
                    ],
                    "type": "string",
                    "description": "The recipe's kind."
                  },
                  "model": {
                    "enum": [
                      "google",
                      "salesforce",
                      "microsoft",
                      "azure",
                      "generic"
                    ],
                    "type": "string",
                    "description": "The provider, for model or federated."
                  }
                },
                "description": "Recipe, no secret: none; header {name, prefix}; parameter {name}; basic; bearer; oauth2 {token_url|issuer, scope, client_auth basic|body, header}; session {login_url, token_field, duration_seconds}; jwt {mode exchange|client_assertion|direct, token_url|issuer, alg RS256|ES256, duration_s, claims {iss, aud, scope, sub}, client_id, scope}, signed by while; model google {client_email, scopes}, salesforce {client_id, sub}, microsoft {tenant_id, client_id, scope, x5t}; federated: google {project_number, pool, provider, scopes, service_account?}, azure {tenant, client_id, scope}, generic {exchange_url}."
              },
              "rate_per_minute": {
                "type": "integer",
                "default": 600,
                "maximum": 60000,
                "minimum": 1,
                "description": "Calls allowed per minute."
              },
              "secondary_domains": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "maxItems": 10,
                "description": "Hosts relayed without a key (/~<host>/…)."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Declare a connection",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "call_connection",
          "title": "Call a connection's API",
          "description": "Calls the HTTP API of a third party that the organization declared as a connection (its name and domain: list_connections), on its base address, within its rules and limits; while adds the authentication and keeps a record of the call.",
          "inputSchema": {
            "type": "object",
            "required": [
              "connection"
            ],
            "properties": {
              "body": {
                "description": "Request body: an object (sent as JSON) or text."
              },
              "call": {
                "type": "string",
                "description": "Id of a held call: its state and, once run, its result."
              },
              "path": {
                "type": "string",
                "description": "Path at the provider, with its query string: /api/v1/slots?site=origines."
              },
              "type": {
                "type": "string",
                "description": "Type of the body (Content-Type), if it is not JSON."
              },
              "method": {
                "enum": [
                  "GET",
                  "HEAD",
                  "POST",
                  "PUT",
                  "PATCH",
                  "DELETE",
                  "OPTIONS"
                ],
                "type": "string",
                "default": "GET",
                "description": "HTTP method."
              },
              "connection": {
                "type": "string",
                "description": "Connection name (list_connections)."
              },
              "organization": {
                "type": "string",
                "description": "The organization."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Call a connection's API",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "get_organization",
          "title": "Read organizations",
          "description": "Without organization, your organizations; otherwise, view detail (members, groups, approvers), existing (what exists for the person, to_say), map (projects, databases, connections), rules (approvals, budget), branding, private_network, private_networks, private_destination, private_network_log, vpn_ingress.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "view": {
                "enum": [
                  "detail",
                  "existing",
                  "map",
                  "rules",
                  "branding",
                  "private_network",
                  "private_networks",
                  "private_destination",
                  "private_network_log",
                  "vpn_ingress"
                ],
                "type": "string",
                "default": "detail",
                "description": "The view returned."
              },
              "minutes": {
                "type": "integer",
                "maximum": 1440,
                "minimum": 1,
                "description": "60 by default."
              },
              "destination": {
                "type": "string",
                "description": "network/destination."
              },
              "organization": {
                "type": "string",
                "description": "The organization."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Read organizations",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "invite_member",
          "title": "Invite a person",
          "description": "Invites a person with a role on an app (project; otherwise the whole organization); for an internal app, role access and project, in one confirmation. An address with no email (.test, .invalid…) is refused.",
          "inputSchema": {
            "type": "object",
            "required": [
              "email"
            ],
            "properties": {
              "role": {
                "enum": [
                  "owner",
                  "admin",
                  "developer",
                  "reader",
                  "access",
                  "external"
                ],
                "type": "string",
                "description": "On an app (project): access to use it, or reader, developer, admin. On the whole organization: developer by default; external sees only what it is granted. People who only use your internal apps: Access on the app (access and project)."
              },
              "email": {
                "type": "string",
                "description": "The person's address."
              },
              "reason": {
                "type": "string",
                "description": "The reason for the assignment (in the log); \"member of the organization\" by default."
              },
              "resend": {
                "type": "boolean",
                "description": "true: sends the pending invitation again (a new link, once an hour), without changing anything else."
              },
              "project": {
                "type": "string",
                "description": "The app where the role is given; without it: the whole organization."
              },
              "organization": {
                "type": "string",
                "description": "The organization."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Invite a person",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "grant_role",
          "title": "Grant a role",
          "description": "Grants a role to an identity (a person, a group, a service account, an app) on a scope, until a date; only what one holds oneself, never to oneself. Access for an address in the company's domain: it waits for their first sign-in.",
          "inputSchema": {
            "type": "object",
            "required": [
              "who",
              "role",
              "scope",
              "reason"
            ],
            "properties": {
              "who": {
                "type": "string",
                "description": "An address, group:<name>, service_account:<name>, app:<project>/<service> or task:<project>/<task>."
              },
              "days": {
                "type": "integer",
                "maximum": 3650,
                "minimum": 1,
                "description": "Duration, in days."
              },
              "role": {
                "type": "string",
                "description": "A built-in role (owner, admin, developer, reader, access, data-reader, connection-caller, connection-writer, service-caller) or one of the organization's (review_access { view: \"roles\" })."
              },
              "scope": {
                "type": "object",
                "properties": {
                  "type": {
                    "enum": [
                      "organization"
                    ],
                    "type": "string",
                    "description": "The whole organization."
                  },
                  "paths": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 100,
                    "description": "Patterns, e.g. \"/notes/**\"."
                  },
                  "table": {
                    "type": "string",
                    "description": "\"schema.table\"."
                  },
                  "schema": {
                    "type": "string",
                    "description": "PostgreSQL schema."
                  },
                  "columns": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 1600,
                    "description": "The table's columns."
                  },
                  "project": {
                    "type": "string",
                    "description": "Project name."
                  },
                  "database": {
                    "type": "string",
                    "description": "Database name."
                  },
                  "connection": {
                    "type": "string",
                    "description": "Connection name."
                  },
                  "environment": {
                    "type": "string",
                    "description": "The environment."
                  }
                },
                "description": "{}: the organization; otherwise down to a table, or a connection.",
                "additionalProperties": false
              },
              "until": {
                "type": "string",
                "description": "End date (included): 2026-11-30."
              },
              "reason": {
                "type": "string",
                "description": "Why (\"Q4 audit\"): it goes to the log and is read in the sentence."
              },
              "organization": {
                "type": "string",
                "description": "The organization."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Grant a role",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "revoke_role",
          "title": "Revoke a role",
          "description": "Removes an assignment at once; the last owner stays.",
          "inputSchema": {
            "type": "object",
            "required": [
              "assignment",
              "reason"
            ],
            "properties": {
              "reason": {
                "type": "string",
                "description": "Why (in the log)."
              },
              "assignment": {
                "type": "string",
                "description": "The assignment's id."
              },
              "organization": {
                "type": "string",
                "description": "The organization."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Revoke a role",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "create_token",
          "title": "Create an API token",
          "description": "Creates an API token for a project or for the organization, with its permissions, its environments and its lifetime; it is returned only once. Not by an agent connected through OAuth: a person creates it in while.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "days": {
                "type": "integer",
                "default": 30,
                "maximum": 365,
                "minimum": 0,
                "description": "Lifetime in days (30 by default, 0 without expiry)."
              },
              "name": {
                "type": "string",
                "description": "What it is for (\"GitLab CI\")."
              },
              "scope": {
                "enum": [
                  "project",
                  "organization"
                ],
                "type": "string",
                "default": "project",
                "description": "A project, or the organization."
              },
              "project": {
                "type": "string",
                "description": "The project."
              },
              "permissions": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "deploy and read by default."
              },
              "environments": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "maxItems": 20,
                "description": "Where it can act (production, previews, or names); without a list, everywhere."
              },
              "organization": {
                "type": "string",
                "description": "For an organization token: its name; optional with an organization token."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Create an API token",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "update_connection",
          "title": "Configure a connection",
          "description": "One setting per call: method and pattern request a rule; lock: true ends the learning, the rules drawn from the observed calls apply, the rest is refused (both pending approval). caller, window and calls set a call limit, remove_limit removes it.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "lock": {
                "type": "boolean",
                "description": "true: end the learning."
              },
              "read": {
                "type": "boolean",
                "description": "A POST that only reads."
              },
              "calls": {
                "type": "integer",
                "maximum": 100000000,
                "minimum": 1,
                "description": "The number of calls allowed per window."
              },
              "caller": {
                "type": "string",
                "description": "Who is limited (agent:<id>, group:finance, app:boutique/web…)."
              },
              "method": {
                "enum": [
                  "GET",
                  "HEAD",
                  "POST",
                  "PUT",
                  "PATCH",
                  "DELETE",
                  "OPTIONS",
                  "*"
                ],
                "type": "string",
                "description": "HTTP method."
              },
              "reason": {
                "type": "string",
                "description": "Why this rule, in one sentence."
              },
              "window": {
                "enum": [
                  "minute",
                  "hour",
                  "day",
                  "month"
                ],
                "type": "string",
                "description": "The window."
              },
              "pattern": {
                "type": "string",
                "description": "Path, e.g. /api/v1/slots/*/close."
              },
              "connection": {
                "type": "string",
                "description": "Connection name (list_connections)."
              },
              "organization": {
                "type": "string",
                "description": "The organization."
              },
              "remove_limit": {
                "type": "string",
                "description": "The limit to remove (its id, list_connections { view: \"limits\" })."
              },
              "approve_each_call": {
                "type": "boolean",
                "default": false,
                "description": "true: each call waits for an approval."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Configure a connection",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "set_connection_binding",
          "title": "Request or configure a federated binding",
          "description": "Without binding, requests (pending approval) that a production app call a federated connection (OIDC), with a short token signed by while, without a secret; federation must be enabled there. With binding: resume: true resumes a suspended binding; approve_production_deploys checks or unchecks the approval of its production deploys.",
          "inputSchema": {
            "type": "object",
            "required": [
              "connection"
            ],
            "properties": {
              "caller": {
                "type": "string",
                "description": "A request: the app's service (web), or \"task:<name>\"."
              },
              "reason": {
                "type": "string",
                "description": "Why (in the log)."
              },
              "resume": {
                "type": "boolean",
                "description": "true: resume the binding."
              },
              "binding": {
                "type": "string",
                "description": "The id of the binding."
              },
              "project": {
                "type": "string",
                "description": "The app's project."
              },
              "connection": {
                "type": "string",
                "description": "Name of the federated connection."
              },
              "organization": {
                "type": "string",
                "description": "The organization."
              },
              "approve_production_deploys": {
                "type": "boolean",
                "description": "true: its production deploys wait for an approval; false: they do not."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Request or configure a federated binding",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [],
      "prompts": []
    },
    "instructions": "A while trial without an account, online for a limited time and not for production: the first deploy_app (or upload_source, write_files) without a key creates the trial and returns the app's address, trial_key and to_say.\nEach later call carries trial_key as the trial argument. to_say is the message for the user, with the link that keeps the app by signing up.\nA trial is one app, in production only, without workers or tasks, described by a while.yaml at its root (project, services, port, health), as with an account.\nThe other tools act on the user's while account: calling one asks the user to sign in, then the call goes on."
  },
  "changes": {
    "total": 0,
    "latest": []
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}