{"cli_capabilities":["isolated_profile_v1","desktop_events_v1"],"endpoint":"https://api.ample.computer/mcp","tools":[{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Delete app"},"description":"Delete an app and its releases; preserve shared servers and declared resources\n\nApps are addressed by deployment ID, not name: a name can be shared, an ID cannot. Find it with `ample app list`.","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"The app's deployment ID (dep_…) from `ample app list`","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"},"yes":{"default":false,"enum":[true,false],"type":"boolean"}},"required":["id","execution_key"],"type":"object"},"name":"ample_app_delete","title":"Delete app"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Get app"},"description":"Read an app's deployment status","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"The app's deployment ID (dep_…) from `ample app list`","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_app_get","title":"Get app"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"List apps"},"description":"List deployed apps, including static sites without a server","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_app_list","title":"List apps"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Rename app"},"description":"Rename an app: --title is what the person sees, --link gives it <link>.ample.run (its last few links keep working)","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"The app's deployment ID (dep_…)","type":"string"},"link":{"type":"string"},"title":{"type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_app_rename","title":"Rename app"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":false,"title":"Create agent credential"},"description":"Provision an agent credential with a secret shown only once","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"name":{"type":"string"},"scope":{"type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["name","scope","execution_key"],"type":"object"},"name":"ample_auth_agent_create","title":"Create agent credential"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"List agent credentials"},"description":"List agent credentials without exposing secrets","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_auth_agent_list","title":"List agent credentials"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Revoke agent credential"},"description":"Revoke a credential and all its access tokens","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_auth_agent_revoke","title":"Revoke agent credential"},{"annotations":{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":false,"title":"Claim account by email"},"description":"Keep this account: email the person a link that makes them its owner","inputSchema":{"additionalProperties":false,"properties":{"email":{"description":"Email of the person who should own the account","type":"string"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["email","execution_key"],"type":"object"},"name":"ample_auth_claim","title":"Claim account by email"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":false,"title":"Sign up"},"description":"Register a free autonomous account; returns credentials, quotas, expiry, and claim URL. With --connect-code, joins the person's own account instead","inputSchema":{"additionalProperties":false,"properties":{"connect_code":{"description":"Connect code from the person's prompt (ample_connect_...): credentials on their own account instead of a new one, with nothing to claim","type":"string"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"name":{"type":"string"},"request_key":{"description":"Random UUID retained to retrieve registration after a disconnect","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_auth_signup","title":"Sign up"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":false,"title":"Create API token"},"description":"Create a new scoped token","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"expires":{"description":"Expiry duration (e.g. \"1h\", \"7d\", \"90d\")","type":"string"},"name":{"description":"Token name (must be unique)","type":"string"},"scope":{"description":"Comma-separated scopes (e.g. \"servers:read,servers:exec\")","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["name","scope","expires","execution_key"],"type":"object"},"name":"ample_auth_token_create","title":"Create API token"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"List API tokens"},"description":"List all tokens","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_auth_token_list","title":"List API tokens"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Revoke API token"},"description":"Revoke a token by ID","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"Token ID (e.g. tok_a1b2c3d4)","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_auth_token_revoke","title":"Revoke API token"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Show current account"},"description":"Show current identity and scopes","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_auth_whoami","title":"Show current account"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":false,"title":"Create bucket"},"description":"Create an object-storage bucket (returns S3 credentials)","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"name":{"description":"Bucket name (lowercase letters, digits, hyphens)","type":"string"},"quota_mb":{"description":"Size quota in MB (defaults to 1024); writes are suspended while the bucket holds more","type":"integer"},"region":{"description":"Where the data lives: ams (default), fra, lhr, sjc, ord, iad, sin, nrt, or global","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["name","execution_key"],"type":"object"},"name":"ample_bucket_create","title":"Create bucket"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Get bucket credentials"},"description":"Show the bucket's S3 credentials and endpoint","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"Bucket ID or name","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_bucket_credentials","title":"Get bucket credentials"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Delete bucket"},"description":"Delete a bucket and all objects in it","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"Bucket ID or name","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"},"yes":{"default":false,"description":"Skip confirmation","enum":[true,false],"type":"boolean"}},"required":["id","execution_key"],"type":"object"},"name":"ample_bucket_delete","title":"Delete bucket"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Get bucket"},"description":"Get bucket details (including live usage and over_quota)","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"Bucket ID or name","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_bucket_get","title":"Get bucket"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"List bucket"},"description":"List buckets","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_bucket_list","title":"List bucket"},{"annotations":{"destructiveHint":true,"openWorldHint":true,"readOnlyHint":false,"title":"Publish bucket"},"description":"Serve the bucket's objects publicly (the response has public_url)","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"Bucket ID or name","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_bucket_publish","title":"Publish bucket"},{"annotations":{"destructiveHint":true,"openWorldHint":true,"readOnlyHint":false,"title":"Write bucket object"},"description":"Write one object: text, base64 data, a public https URL Ample downloads, or a local file (any size; it goes straight to storage)","inputSchema":{"additionalProperties":false,"properties":{"content_type":{"description":"Content-Type to store (guessed from the key's extension otherwise)","type":"string"},"data_base64":{"description":"The object's content, base64-encoded","type":"string"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"file":{"description":"A local file to upload","type":"string"},"id":{"description":"Bucket ID or name","type":"string"},"key":{"description":"Object key, for example videos/launch.mp4","type":"string"},"source_url":{"description":"A public https URL Ample downloads the object from (up to 95 MiB)","type":"string"},"text":{"description":"The object's content as text","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","key","execution_key"],"type":"object"},"name":"ample_bucket_put","title":"Write bucket object"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Rotate bucket key"},"description":"Rotate the bucket's S3 key (old key stops working)","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"Bucket ID or name","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_bucket_rotate_key","title":"Rotate bucket key"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Unpublish bucket"},"description":"Stop serving the bucket publicly","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"Bucket ID or name","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_bucket_unpublish","title":"Unpublish bucket"},{"annotations":{"destructiveHint":true,"openWorldHint":true,"readOnlyHint":false,"title":"Get bucket upload URL"},"description":"Get a presigned URL that takes one PUT of an object straight to storage, for files of any size","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"Bucket ID or name","type":"string"},"key":{"description":"Object key, for example videos/launch.mp4","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","key","execution_key"],"type":"object"},"name":"ample_bucket_upload_url","title":"Get bucket upload URL"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Set budget"},"description":"Set budget limits","inputSchema":{"additionalProperties":false,"properties":{"daily_max":{"description":"Daily maximum spend in USD","type":"number"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"hard_stop":{"default":false,"description":"Hard stop when budget exceeded (kill VMs)","enum":[true,false],"type":"boolean"},"monthly_max":{"description":"Monthly maximum spend in USD","type":"number"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_budget_set","title":"Set budget"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Show budget"},"description":"Show budget status","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_budget_status","title":"Show budget"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":false,"title":"Create database"},"description":"Create a managed database. Bind it to an app with `ample deploy --database DATABASE_URL=<name>`, which injects its connection string. An app that needs a database and binds none gets one of its own automatically, so create one only to share it between apps or set it up first","inputSchema":{"additionalProperties":false,"properties":{"engine":{"description":"Engine: postgres, mysql, redis, or mongodb","type":"string"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"name":{"description":"Database name","type":"string"},"region":{"description":"Region","type":"string"},"size":{"description":"Instance size (defaults to s-1vcpu-1gb)","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["name","engine","execution_key"],"type":"object"},"name":"ample_database_create","title":"Create database"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Delete database"},"description":"Delete a managed database and its data. Refused while a deployment binds it","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"Database ID or name","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"},"yes":{"default":false,"description":"Skip confirmation","enum":[true,false],"type":"boolean"}},"required":["id","execution_key"],"type":"object"},"name":"ample_database_delete","title":"Delete database"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Get database"},"description":"Get database details","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"Database ID or name","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_database_get","title":"Get database"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"List database"},"description":"List managed databases","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_database_list","title":"List database"},{"annotations":{"destructiveHint":true,"openWorldHint":true,"readOnlyHint":false,"title":"Deploy app"},"description":"Deploy a local app/workspace and wait until it is live\n\nThis command blocks until the release is live or fails, then exits: 0 = live, 1 = failed, 2 = needs input (a preflight question to answer). Ample remembers your last deploy (content-addressed), so re-running with no source or config changes is a no-op that reports the app as already live instead of rebuilding. Only re-run `ample deploy` after a real change or to retry a failure — do not poll it for status. With `--format json` the result always carries top-level `status` (\"live\"), `unchanged` (bool), `deployment_id`, and `server_id` fields.","inputSchema":{"additionalProperties":false,"properties":{"build_command":{"description":"Explicit build command override","type":"string"},"database":{"description":"Bind an existing managed database (repeatable): `--database DATABASE_URL=my-db` injects its connection string as DATABASE_URL, so no other database is provisioned for it. The database is named by its name or ID (`ample database list`). Saved, so redeploys keep the binding; `--database DATABASE_URL=` drops it","items":{"type":"string"},"type":"array"},"env":{"description":"Encrypted environment variable (repeatable, e.g. --env KEY=value or --env KEY to prompt)","items":{"type":"string"},"type":"array"},"env_file":{"description":"Dotenv-style file to import as encrypted environment variables","items":{"type":"string"},"type":"array"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"force":{"default":false,"description":"Deploy even from a home/system directory (bypasses the safety guard). Also forces a full redeploy: it skips the unchanged/no-op short-circuit, so the release is rebuilt and re-activated even when nothing changed","enum":[true,false],"type":"boolean"},"health_path":{"default":"/","description":"Path the health check requests. Rarely needed: any answer below HTTP 500 counts as healthy, including a 404 from an app with no page at /","type":"string"},"health_timeout_secs":{"description":"Maximum seconds to wait for the service health check","type":"integer"},"idempotency_key":{"description":"Idempotency key for safe retries","type":"string"},"ignore_packaging_candidate":{"description":"Mark a detected packaging candidate as intentionally excluded","items":{"type":"string"},"type":"array"},"include":{"description":"Include a verified gitignored file or directory in the deploy package","items":{"type":"string"},"type":"array"},"install_command":{"description":"Explicit install command override","type":"string"},"kind":{"description":"Service kind: `web` (default, HTTP health-gated + public-capable), `worker` (non-HTTP background process; never gets a public URL), or `static`. Omit for `web`. `--kind worker` cannot be combined with `--public`","enum":["web","worker","static"],"type":"string"},"link":{"description":"Wire this app to a sibling Ample server (repeatable). `--link PB=my-pb-server` injects `PB_URL` and framework public URL variables using the live HTTP endpoint, so a localhost default doesn't follow the app into production. TARGET may be a bare server name/ID, deployment ID, hostname, or full HTTP URL. A server with multiple live HTTP apps requires a deployment ID. An explicit `--env` of the same key wins; the mapping is saved so redeploys keep the wiring","items":{"type":"string"},"type":"array"},"name":{"description":"Server/app name (defaults to directory name if omitted)","type":"string"},"path":{"default":".","description":"Project directory to deploy, or one service name from ample.toml","type":"string"},"port":{"description":"Explicit listen and health-check port (omitted means auto-assign)","type":"integer"},"preflight":{"default":false,"description":"Run local deployment advisor checks without contacting the Ample API","enum":[true,false],"type":"boolean"},"private":{"default":false,"description":"Deploy privately (no public URL). Overrides a saved `public = true` from prior deploys","enum":[true,false],"type":"boolean"},"public":{"default":false,"description":"Publicly expose with generated URL (the default for web/static apps)","enum":[true,false],"type":"boolean"},"release_command":{"description":"Optional one-off command to run before the release is considered live (e.g. migrations)","type":"string"},"runtime":{"description":"Explicit runtime override when source detection is ambiguous","type":"string"},"service_or_path":{"default":".","description":"Project directory to deploy, or one service name from ample.toml","type":"string"},"size":{"description":"VM size (e.g. s-1vcpu-256mb). Omit to let Ample pick a runtime-safe size — a node app that installs dependencies at runtime is given enough memory automatically instead of OOMing the small default","type":"string"},"start":{"description":"Start command inside the VM. Optional when Ample can infer it from the source probe","type":"string"},"target_mode":{"description":"Deployment target mode. Hosted paid accounts default to reusing the included server when omitted","enum":["new-server","existing-server","included-server"],"type":"string"},"target_server":{"description":"Existing server ID/name to reuse for this deployment","type":"string"},"template":{"description":"Optional internal template override","type":"string"},"volume":{"description":"Persistent volume to mount before the app first boots (ID or name:/mount/path)","type":"string"},"wait_secs":{"default":600,"description":"Maximum seconds to wait for build/activation, including operation watches","type":"integer"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_deploy","title":"Deploy app"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Read Ample docs"},"description":"Read embedded CLI documentation (compatibility alias)","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"topic":{"default":"agents","enum":["agents","llms"],"type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_docs","title":"Read Ample docs"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Read agent guide"},"description":"Print the agent playbook (plan → answer → deploy workflow, contracts, footguns)","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"snippet":{"default":false,"description":"Print a short block to merge into this repo's AGENTS.md / CLAUDE.md","enum":[true,false],"type":"boolean"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_docs_agents","title":"Read agent guide"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Read llms.txt"},"description":"Print the llms.txt-style condensed command and manifest reference","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_docs_llms","title":"Read llms.txt"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Read MCP docs"},"description":"Print the generated MCP tool catalog or registry metadata","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"local":{"default":false,"enum":[true,false],"type":"boolean"},"registry":{"default":false,"enum":[true,false],"type":"boolean"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_docs_mcp","title":"Read MCP docs"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Read remote MCP docs"},"description":"Print remote MCP authentication, workspace, and recovery instructions","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_docs_remote","title":"Read remote MCP docs"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":false,"title":"Add domain"},"description":"Add a custom domain to a deployment","inputSchema":{"additionalProperties":false,"properties":{"deployment_id":{"type":"string"},"domain":{"type":"string"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["deployment_id","domain","execution_key"],"type":"object"},"name":"ample_domain_add","title":"Add domain"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"List domain"},"description":"List domains for a deployment","inputSchema":{"additionalProperties":false,"properties":{"deployment_id":{"type":"string"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["deployment_id","execution_key"],"type":"object"},"name":"ample_domain_list","title":"List domain"},{"annotations":{"destructiveHint":true,"openWorldHint":true,"readOnlyHint":false,"title":"Verify domain"},"description":"Verify DNS for a custom domain and activate it","inputSchema":{"additionalProperties":false,"properties":{"domain":{"type":"string"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["domain","execution_key"],"type":"object"},"name":"ample_domain_verify","title":"Verify domain"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Disable email"},"description":"Disable new sends and immediately revoke the app's email credential","inputSchema":{"additionalProperties":false,"properties":{"app":{"type":"string"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["app","execution_key"],"type":"object"},"name":"ample_email_disable","title":"Disable email"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":false,"title":"Enable email"},"description":"Enable email and return its status. No email is sent. If can_send is false, tell the person next_action before building. Deploy --force afterward to inject credentials","inputSchema":{"additionalProperties":false,"properties":{"app":{"description":"App name or deployment ID (use an ID when names are ambiguous)","type":"string"},"display_name":{"type":"string"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"reply_to":{"description":"Replies go here; sending addresses are not inboxes. Empty clears it","type":"string"},"sender":{"description":"Address prefix, for example hello or receipts; never a different domain","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["app","execution_key"],"type":"object"},"name":"ample_email_enable","title":"Enable email"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Get email"},"description":"Inspect one email's status and delivery events; bodies are available only for tests","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_email_get","title":"Get email"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"List email"},"description":"List the app's recent captured tests and delivery outcomes","inputSchema":{"additionalProperties":false,"properties":{"app":{"type":"string"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["app","execution_key"],"type":"object"},"name":"ample_email_list","title":"List email"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":false,"title":"Preview email"},"description":"Capture rendered HTML/text and get a private 15-minute desktop/mobile preview link. Sends nothing. Links may contain login codes: do not share publicly","inputSchema":{"additionalProperties":false,"properties":{"app":{"type":"string"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"from":{"type":"string"},"html":{"description":"Rendered email HTML. Keep templates and variables in the app","type":"string"},"idempotency_key":{"description":"Stable unique ID for this logical email. Reuse after a timeout; never blindly generate a new key","type":"string"},"reply_to":{"type":"string"},"subject":{"type":"string"},"test":{"default":false,"description":"Capture without delivering or consuming the real-send allowance","enum":[true,false],"type":"boolean"},"text":{"description":"Plain-text alternative, rendered by your app","type":"string"},"to":{"description":"Recipient addresses. Real sends consume one allowance unit per recipient","items":{"type":"string"},"type":"array"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["app","to","subject","text","idempotency_key","execution_key"],"type":"object"},"name":"ample_email_preview","title":"Preview email"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Token email rotate"},"description":"Revoke the old token; deploy --force afterward to inject its replacement","inputSchema":{"additionalProperties":false,"properties":{"app":{"type":"string"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["app","execution_key"],"type":"object"},"name":"ample_email_rotate_token","title":"Token email rotate"},{"annotations":{"destructiveHint":true,"openWorldHint":true,"readOnlyHint":false,"title":"Send email"},"description":"Send a real email only when the person requests it; use preview or --test otherwise. Templates are rendered in the app. Accepted is not proof of inbox placement","inputSchema":{"additionalProperties":false,"properties":{"app":{"type":"string"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"from":{"type":"string"},"html":{"description":"Rendered email HTML. Keep templates and variables in the app","type":"string"},"idempotency_key":{"description":"Stable unique ID for this logical email. Reuse after a timeout; never blindly generate a new key","type":"string"},"reply_to":{"type":"string"},"subject":{"type":"string"},"test":{"default":false,"description":"Capture without delivering or consuming the real-send allowance","enum":[true,false],"type":"boolean"},"text":{"description":"Plain-text alternative, rendered by your app","type":"string"},"to":{"description":"Recipient addresses. Real sends consume one allowance unit per recipient","items":{"type":"string"},"type":"array"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["app","to","subject","text","idempotency_key","execution_key"],"type":"object"},"name":"ample_email_send","title":"Send email"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Status email"},"description":"Whether the app can send now (can_send, blocked_by, next_action), credential binding and the monthly allowance","inputSchema":{"additionalProperties":false,"properties":{"app":{"type":"string"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["app","execution_key"],"type":"object"},"name":"ample_email_status","title":"Status email"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Update email"},"description":"Change sender prefix, display name or reply-to; templates remain in your app","inputSchema":{"additionalProperties":false,"properties":{"app":{"description":"App name or deployment ID (use an ID when names are ambiguous)","type":"string"},"display_name":{"type":"string"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"reply_to":{"description":"Replies go here; sending addresses are not inboxes. Empty clears it","type":"string"},"sender":{"description":"Address prefix, for example hello or receipts; never a different domain","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["app","execution_key"],"type":"object"},"name":"ample_email_update","title":"Update email"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Cancel execution"},"description":"Cancel remote execution; accepted cloud mutations may already have completed","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_execution_cancel","title":"Cancel execution"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Get execution"},"description":"Wait up to 45 seconds for the result of a call that answered status running; answers running again while it works. Never replays it.","inputSchema":{"additionalProperties":false,"properties":{"id":{"description":"execution_id of that call","type":"string"},"wait_secs":{"maximum":45,"minimum":0,"type":"integer"}},"required":["id"],"type":"object"},"name":"ample_execution_get","title":"Get execution"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Initialize project"},"description":"Plan this repo and write ample.toml, with onboarding guidance\n\nRuns `ample plan --write`, lifts legacy .ample/config.toml settings into the manifest, and prints the AGENTS.md snippet + .gitignore recommendation. Never edits files ample doesn't own.","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"path":{"default":".","description":"Path to the app repo (defaults to the current directory)","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_init","title":"Initialize project"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Create or update scheduled job"},"description":"Run a command or an HTTP request on one of your services on a schedule\n\nThe job runs inside the service's server with its environment, directory and database, whether or not the app has traffic. Give one schedule (--schedule cron with --timezone, or --every) and one target (--command, or --request for a web service; the request carries an Ample-Job-Token header equal to the app's AMPLE_JOB_TOKEN). Re-running with the same arguments changes nothing; different arguments update the job. Test it right away with `ample job run <name> --wait`.","inputSchema":{"additionalProperties":false,"properties":{"command":{"description":"Shell command to run in the service's directory, e.g. \"node scripts/report.js\"","type":"string"},"every":{"description":"Run at a fixed interval instead, e.g. 5m, 1h","type":"string"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"name":{"description":"Job name (lowercase letters, digits, hyphens)","type":"string"},"request":{"description":"HTTP request to the service instead, e.g. \"POST /tasks/report\"","type":"string"},"retries":{"description":"Retries after a failed run (0-5, default 0)","type":"integer"},"schedule":{"description":"Cron schedule: minute hour day-of-month month day-of-week, e.g. \"0 8 * * *\", or @hourly/@daily","type":"string"},"service":{"description":"Service it runs on: deployment ID or app name","type":"string"},"timeout":{"description":"Longest a run may take before it is stopped, e.g. 10m (default 10m, capped by the plan)","type":"string"},"timezone":{"description":"Time zone for --schedule (IANA name, e.g. America/New_York; default UTC)","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["name","service","execution_key"],"type":"object"},"name":"ample_job_create","title":"Create or update scheduled job"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Delete scheduled job"},"description":"Delete a job and its run history","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"name":{"description":"Job name or ID","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["name","execution_key"],"type":"object"},"name":"ample_job_delete","title":"Delete scheduled job"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Get scheduled job"},"description":"Show a job: schedule, next run, limits and its last few runs","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"name":{"description":"Job name or ID","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["name","execution_key"],"type":"object"},"name":"ample_job_get","title":"Get scheduled job"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"List scheduled jobs"},"description":"List scheduled jobs and when each runs next","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"service":{"description":"Only jobs on this service (deployment ID or app name)","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_job_list","title":"List scheduled jobs"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Pause scheduled job"},"description":"Stop a job from running on its schedule (manual runs still work)","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"name":{"description":"Job name or ID","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["name","execution_key"],"type":"object"},"name":"ample_job_pause","title":"Pause scheduled job"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Resume scheduled job"},"description":"Resume a paused job's schedule","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"name":{"description":"Job name or ID","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["name","execution_key"],"type":"object"},"name":"ample_job_resume","title":"Resume scheduled job"},{"annotations":{"destructiveHint":true,"openWorldHint":true,"readOnlyHint":false,"title":"Run job now"},"description":"Run a job now\n\nWith --wait it is synchronous: it returns when the run finishes, exits 0 if it succeeded and 1 if it failed (the result has the output and, on failure, who should act and how).","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"name":{"description":"Job name or ID","type":"string"},"wait":{"default":false,"description":"Wait for the run to finish","enum":[true,false],"type":"boolean"},"wait_secs":{"description":"Most seconds to wait with --wait (default: the job's timeout plus 3 minutes)","type":"integer"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["name","execution_key"],"type":"object"},"name":"ample_job_run","title":"Run job now"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"List job runs"},"description":"Show a job's recent runs, newest first","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"limit":{"default":20,"description":"How many runs (default 20, at most 100)","type":"integer"},"name":{"description":"Job name or ID","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["name","execution_key"],"type":"object"},"name":"ample_job_runs","title":"List job runs"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Read logs"},"description":"Tail build/runtime logs for a deployment","inputSchema":{"additionalProperties":false,"properties":{"deployment_id":{"description":"Deployment ID or manifest service name. Defaults to the current service's last deployment","type":"string"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"follow":{"default":false,"description":"Stream new entries as they are written. Polls every second","enum":[true,false],"type":"boolean"},"kind":{"default":"all","description":"Filter by log kind: build, runtime, job (scheduled job runs), or all (default)","type":"string"},"tail":{"default":200,"description":"Show only the last N entries","type":"integer"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_logs","title":"Read logs"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Get operation"},"description":"Read an existing operation without starting another deployment","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"type":"string"},"wait_secs":{"default":0,"description":"Wait up to this many seconds for a state change or completion","type":"integer"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_operation","title":"Get operation"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Plan deploy"},"description":"Analyze the repo and plan its infrastructure before deploying\n\nDetects every deployable service (monorepos included), proposes the topology (servers, databases, volumes, links), and lists open questions with options and safe defaults. Exits 0 when the plan is ready, 2 when blocking questions remain — resolve them with `--answer <path>=<value>` (or edit ample.toml) and re-run. `--write` pins the plan to a checked-in ample.toml that deploys then consume; detection still fills anything the manifest leaves unpinned.","inputSchema":{"additionalProperties":false,"properties":{"answers":{"description":"Answer an open question in ample.toml (repeatable): --answer services.web.start=\"node build\". Applied before re-planning, so plan → answer → plan converges to ready","items":{"type":"string"},"type":"array"},"env_files":{"description":"Env file the deploy will be given (repeatable), as the deploy's own `--env-file` takes it: its keys count as provided, and the file itself is not a packaging question","items":{"type":"string"},"type":"array"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"offline":{"default":false,"description":"Skip the remote-state overlay (no API access; plan is repo-local)","enum":[true,false],"type":"boolean"},"path":{"default":".","description":"Path to the app repo (defaults to the current directory)","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"},"write":{"default":false,"description":"Write ample.toml with the proposed plan. Open questions become `# TODO(ample):` comments naming their --answer path. Refuses to overwrite an existing ample.toml (edit it or use --answer instead)","enum":[true,false],"type":"boolean"}},"required":["execution_key"],"type":"object"},"name":"ample_plan","title":"Plan deploy"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Get recipe"},"description":"Inspect one published recipe contract (prerequisites, tested configuration, limitations, evidence, binding, next actions)","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"markdown":{"default":false,"description":"Print the Markdown representation instead of JSON","enum":[true,false],"type":"boolean"},"recipe_id":{"description":"Recipe id, e.g. page:recipes:rest-api:express:persistent-state","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["recipe_id","execution_key"],"type":"object"},"name":"ample_recipe_get","title":"Get recipe"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Plan from recipe"},"description":"Prepare a side-effect-free deployment plan for a recipe against a workspace or server you own\n\nRequires an account token with servers:read. Returns constraint results, missing inputs, blockers, resource changes, cost estimate, required scopes and, when every check passes, an approval summary with a signed plan token and the typed handoff to the existing `ample deploy` flow. It never provisions or bills anything and `ready_for_approval` is not approval.","inputSchema":{"additionalProperties":false,"properties":{"compliance_requirements":{"description":"Hard constraint: compliance requirement (repeatable)","items":{"type":"string"},"type":"array"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"inputs":{"description":"Recipe input as KEY=VALUE (repeatable). Secret-looking keys must use secret references, never literal credentials","items":{"type":"string"},"type":"array"},"project":{"description":"Workspace id (ws_...) or server id/name you own","type":"string"},"recipe_id":{"description":"Recipe id","type":"string"},"recipe_revision":{"description":"Recipe revision from `ample recipe get`; defaults to the current revision","type":"string"},"region":{"description":"Hard constraint: deployment region","type":"string"},"required_capabilities":{"description":"Hard constraint: required capability (repeatable)","items":{"type":"string"},"type":"array"},"runtime_version":{"description":"Hard constraint: runtime and version, e.g. \"node 22\"","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["recipe_id","project","execution_key"],"type":"object"},"name":"ample_recipe_plan","title":"Plan from recipe"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Search recipes"},"description":"Search the published deployment recipe catalog by task, stack and explicit constraints\n\nPublic and read-only. `matches` lists recipes whose stated hard constraints are all verified; `needsVerification` lists recipes with a detail to confirm, and a recipe a requested constraint rules out is set aside. Recipes are worked examples: any app deploys with `ample plan` and `ample deploy` whether or not one matches. Facet ids come from `ample recipe search` results or the catalog index (`/v1/catalog`).","inputSchema":{"additionalProperties":false,"properties":{"budget_amount":{"description":"Hard constraint: monthly budget amount (requires --budget-currency and --budget-scope)","type":"number"},"budget_currency":{"description":"Three-letter currency code for --budget-amount, e.g. USD","type":"string"},"budget_scope":{"description":"Whether the budget covers platform charges only or all dependencies","enum":["platform-only","all-dependencies"],"type":"string"},"compliance_requirements":{"description":"Hard constraint: compliance requirement such as HIPAA (repeatable)","items":{"type":"string"},"type":"array"},"cursor":{"description":"Continue a previous search from its nextCursor","type":"string"},"data_sensitivity":{"description":"Hard constraint: data sensitivity","enum":["public","internal","confidential","regulated"],"type":"string"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"framework_ids":{"description":"Framework facet id (repeatable; OR within the list)","items":{"type":"string"},"type":"array"},"industry_ids":{"description":"Industry facet id (repeatable)","items":{"type":"string"},"type":"array"},"limit":{"default":5,"description":"Results per page (1 to 20)","type":"integer"},"max_request_duration_seconds":{"description":"Hard constraint: maximum request duration in seconds","type":"number"},"migration_source_ids":{"description":"Migration source facet id (repeatable)","items":{"type":"string"},"type":"array"},"minimum_memory_mib":{"description":"Hard constraint: minimum memory in MiB","type":"integer"},"minimum_vcpu":{"description":"Hard constraint: minimum vCPU","type":"number"},"primitive_ids":{"description":"Required primitive id (repeatable; every listed primitive is required)","items":{"type":"string"},"type":"array"},"query":{"description":"Natural-language task, stack and constraints (1 to 2000 characters)","type":"string"},"region":{"description":"Hard constraint: deployment region","type":"string"},"required_capabilities":{"description":"Hard constraint: required capability such as gpu, redis, websockets (repeatable)","items":{"type":"string"},"type":"array"},"runtime_version":{"description":"Hard constraint: runtime and version, e.g. \"node 22\"","type":"string"},"workload_ids":{"description":"Workload facet id (repeatable; OR within the list)","items":{"type":"string"},"type":"array"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["query","execution_key"],"type":"object"},"name":"ample_recipe_search","title":"Search recipes"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":false,"title":"Report a problem"},"description":"Send a problem report to the Ample team\n\nUse it when an Ample tool fails on Ample's side, returns an error that does not say what to do, or does not do what its description says. With the failed call's execution_id, Ample attaches that call's tool and error (from a shell, the last failed command's error is attached), so the message needs only what you were doing and what happened. Returns the report's id.","inputSchema":{"additionalProperties":false,"properties":{"app":{"description":"The app the problem is about, if any","type":"string"},"contact":{"description":"Email for a reply","type":"string"},"execution_id":{"description":"The execution_id of the failed call, from its result","type":"string"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"kind":{"default":"error","description":"error (something failed), friction (it worked but was confusing or needed a workaround) or feedback (a missing feature or a suggestion)","enum":["error","friction","feedback"],"type":"string"},"message":{"description":"What you were doing and what went wrong. No secrets, environment values or personal details","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["message","execution_key"],"type":"object"},"name":"ample_report","title":"Report a problem"},{"annotations":{"destructiveHint":true,"openWorldHint":true,"readOnlyHint":false,"title":"Copy files to server"},"description":"Copy files to/from a server (scp-style)\n\nUpload:   ample server cp ./local.txt my-server:/remote.txt Download: ample server cp my-server:/remote.txt ./local.txt","inputSchema":{"additionalProperties":false,"properties":{"dest":{"description":"Destination path (local or server:remote)","type":"string"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"src":{"description":"Source path (local or server:remote)","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["src","dest","execution_key"],"type":"object"},"name":"ample_server_cp","title":"Copy files to server"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":false,"title":"Create server"},"description":"Create a new server","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"name":{"description":"Server name (idempotent — returns existing if name matches)","type":"string"},"size":{"description":"VM size (e.g., s-1vcpu-1gb)","type":"string"},"template":{"default":"empty","description":"Template: node-22, node-24, python-3.12 (also static sites), php-8.5, ruby-3.4, jvm-21, dotnet-10, elixir-1.18, elixir-1.20, or ubuntu-24.04 (Go, Rust and other self-contained binaries); empty is a bare VM","type":"string"},"volume":{"description":"Attach volume (format: name:/mount/path)","type":"string"},"wait":{"default":false,"description":"Wait until server is running","enum":[true,false],"type":"boolean"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["name","size","execution_key"],"type":"object"},"name":"ample_server_create","title":"Create server"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Destroy server"},"description":"Destroy a server","inputSchema":{"additionalProperties":false,"properties":{"destroy_live_deployments":{"default":false,"description":"Also destroy live public deployments owned by this server","enum":[true,false],"type":"boolean"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"Server ID or name","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"},"yes":{"default":false,"description":"Skip confirmation","enum":[true,false],"type":"boolean"}},"required":["id","execution_key"],"type":"object"},"name":"ample_server_destroy","title":"Destroy server"},{"annotations":{"destructiveHint":true,"openWorldHint":true,"readOnlyHint":false,"title":"Run command on server"},"description":"Execute a command on a server","inputSchema":{"additionalProperties":false,"properties":{"command":{"description":"Command to run (everything after --). One element is a shell command line (pipes, &&, cd); several are a program and its arguments, each passed as-is, e.g. [\"sh\", \"-c\", \"uname -a; node --version\"]","items":{"type":"string"},"type":"array"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"Server ID or name","type":"string"},"stream":{"default":false,"description":"Stream output as it's produced","enum":[true,false],"type":"boolean"},"timeout_secs":{"default":600,"description":"How long the command may run before it is stopped (seconds, up to 3600)","type":"integer"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_server_exec","title":"Run command on server"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Get server"},"description":"Get server details","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"Server ID or name","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_server_get","title":"Get server"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Keep server awake"},"description":"Keep a running server from being treated as idle for a while, e.g. during a series of commands\n\nWithout --for or --release it shows what holds the server. Code inside the server can hold it too: `ample-awake -- <command>`. Holds are capped by the plan; held time is billed like any running time.","inputSchema":{"additionalProperties":false,"properties":{"duration":{"description":"How long, e.g. 30m (at most the plan's hold limit)","type":"string"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"Server ID or name","type":"string"},"reason":{"description":"Why, shown in the server's hold status","type":"string"},"release":{"default":false,"description":"Drop the hold now","enum":[true,false],"type":"boolean"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_server_keep_awake","title":"Keep server awake"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"List server"},"description":"List servers","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"status":{"description":"Filter by status","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_server_list","title":"List server"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Pause server"},"description":"Pause a server (snapshot to disk, stop billing)","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"Server ID or name","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_server_pause","title":"Pause server"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Resize server"},"description":"Resize a server in place (pause, cold boot with the new vCPU/memory; short restart, data kept)","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"Server ID or name","type":"string"},"size":{"description":"New VM size (e.g. s-4vcpu-8gb)","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","size","execution_key"],"type":"object"},"name":"ample_server_resize","title":"Resize server"},{"annotations":{"destructiveHint":true,"openWorldHint":true,"readOnlyHint":false,"title":"Resume server"},"description":"Resume a paused server","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"Server ID or name","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_server_resume","title":"Resume server"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Delete service"},"description":"Stop a service and remove it (its directory on the server is kept)","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"Service (deployment) ID","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"},"yes":{"default":false,"enum":[true,false],"type":"boolean"}},"required":["id","execution_key"],"type":"object"},"name":"ample_service_delete","title":"Delete service"},{"annotations":{"destructiveHint":true,"openWorldHint":true,"readOnlyHint":false,"title":"Restart service"},"description":"Restart a service, for example after updating its files","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"Service (deployment) ID","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_service_restart","title":"Restart service"},{"annotations":{"destructiveHint":true,"openWorldHint":true,"readOnlyHint":false,"title":"Start service"},"description":"Run a command from a directory on an existing server as a supervised service\n\nRe-running with the same arguments is a no-op; after changing files in the directory, use `ample service restart`.","inputSchema":{"additionalProperties":false,"properties":{"command":{"description":"Command to run, e.g. \"npm start\"; a web service listens on $PORT on 0.0.0.0","type":"string"},"dir":{"description":"Absolute directory on the server the command runs from, e.g. /srv/app","type":"string"},"env":{"description":"Environment variables KEY=VALUE (stored encrypted)","items":{"type":"string"},"type":"array"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"health_path":{"default":"/","description":"Path the health check requests. Rarely needed: any answer below HTTP 500 counts as healthy, including a 404 from an app with no page at /","type":"string"},"kind":{"description":"`web` (default, HTTP health-checked) or `worker` (no HTTP, never public)","enum":["web","worker"],"type":"string"},"name":{"description":"Service name (also its URL name)","type":"string"},"port":{"description":"Port the service listens on (default: one Ample assigns, in $PORT)","type":"integer"},"public":{"default":false,"description":"Give the service a public URL","enum":[true,false],"type":"boolean"},"server":{"description":"Server ID or name that holds the service directory","type":"string"},"wait_secs":{"default":180,"description":"Seconds to wait for the service to start","type":"integer"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["server","name","dir","command","execution_key"],"type":"object"},"name":"ample_service_start","title":"Start service"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Show service status"},"description":"Show whether a service is running and how often it restarted","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"Service (deployment) ID","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_service_status","title":"Show service status"},{"annotations":{"destructiveHint":true,"openWorldHint":true,"readOnlyHint":false,"title":"Plan and deploy"},"description":"Reconcile the whole ample.toml topology (databases, volumes, services, domains)\n\nWhere `ample deploy <service>` applies one service, `ample up` applies the entire manifest in dependency order: it ensures every `[databases.*]` and `[volumes.*]` exists, deploys each `[services.*]` (a service linking to X deploys after X), then attaches each `[domains.*]`. It is idempotent and never destructive — existing databases/volumes are matched by name and left untouched, unchanged services are content-addressed no-ops, and a resource absent from the manifest is only reported, never removed. A failed resource blocks its dependents but independent siblings still proceed; re-running `ample up` resumes. `--dry-run` prints the ordered action plan without mutating anything. With `--format json` the result is a stable object: `{ \"status\": \"applied\"|\"partial\"|\"failed\"|\"needs_input\"|\"planned\", \"resources\": [...] }`; exit 0 when everything applied (or dry-run), 2 when required input is missing, and 1 for other failures. Required input produces `needs_input`.","inputSchema":{"additionalProperties":false,"properties":{"dry_run":{"default":false,"description":"Compute and print the reconcile plan without making any changes. Read-only list calls are still used to annotate what already exists (and degrade gracefully when unauthenticated)","enum":[true,false],"type":"boolean"},"env":{"description":"A value for a service's `{ secret = true }` key, as KEY=VALUE (repeatable; wins over --env-file). Each service gets only the keys it declares","items":{"type":"string"},"type":"array"},"env_file":{"description":"Env file with values for the services' `{ secret = true }` keys (repeatable). Each service gets only the keys it declares","items":{"type":"string"},"type":"array"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"path":{"default":".","description":"Directory containing ample.toml (defaults to the current directory)","type":"string"},"wait_secs":{"description":"Maximum seconds to wait for each service deployment. When omitted, each service keeps the existing health-timeout-plus-300-seconds default","type":"integer"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_up","title":"Plan and deploy"},{"annotations":{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":false,"title":"Create upload link"},"description":"Link taking one file (or, with --archive, a project folder's tar.gz) into a workspace or bucket. Give the person page_url to drop it there, or PUT to upload_url (curl -T). Valid an hour","inputSchema":{"additionalProperties":false,"properties":{"archive":{"default":false,"description":"Take a project folder's tar.gz","enum":[true,false],"type":"boolean"},"bucket":{"description":"Target bucket (ID or name)","type":"string"},"deploy":{"default":false,"description":"Deploy when it arrives","enum":[true,false],"type":"boolean"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"name":{"description":"App name, for --archive","type":"string"},"path":{"description":"Workspace path or bucket key (e.g. public/hero.png)","type":"string"},"workspace":{"description":"Target workspace","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_upload_create","title":"Create upload link"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Check upload"},"description":"An upload's arrival and deploy","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"type":"string"},"wait":{"default":0,"description":"Seconds to wait (at most 50)","type":"integer"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_upload_get","title":"Check upload"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Show usage"},"description":"Show current month's usage","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_usage_current","title":"Show usage"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Attach volume"},"description":"Attach a detached volume before a server first boots","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"mount":{"type":"string"},"server_id":{"type":"string"},"volume_id":{"type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"},"yes":{"default":false,"description":"Skip confirmation","enum":[true,false],"type":"boolean"}},"required":["volume_id","server_id","mount","execution_key"],"type":"object"},"name":"ample_volume_attach","title":"Attach volume"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":false,"title":"Create volume"},"description":"Create a new volume","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"name":{"description":"Volume name","type":"string"},"size":{"description":"Size in MB","type":"integer"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["name","size","execution_key"],"type":"object"},"name":"ample_volume_create","title":"Create volume"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Delete volume"},"description":"Delete a volume (must be detached)","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"Volume ID or name","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"},"yes":{"default":false,"description":"Skip confirmation","enum":[true,false],"type":"boolean"}},"required":["id","execution_key"],"type":"object"},"name":"ample_volume_delete","title":"Delete volume"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Detach volume"},"description":"Detach a volume from its server","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"volume_id":{"type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["volume_id","execution_key"],"type":"object"},"name":"ample_volume_detach","title":"Detach volume"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Get volume"},"description":"Get volume details","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"description":"Volume ID or name","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_volume_get","title":"Get volume"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"List volume"},"description":"List volumes","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_volume_list","title":"List volume"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":false,"title":"Create workspace"},"description":"Create an account-owned source workspace (expires after seven inactive days). With --from-app it holds that live app's current source, and deploying it updates that app","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"from_app":{"description":"A live app (deployment id, name or URL) whose source fills the workspace","type":"string"},"name":{"type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_workspace_create","title":"Create workspace"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Delete workspace"},"description":"Delete workspace source and metadata; deployed applications are retained","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_workspace_delete","title":"Delete workspace"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Download workspace"},"description":"Return an authenticated archive download URL, or save it to a local file","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"type":"string"},"output":{"type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_workspace_download","title":"Download workspace"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Get workspace"},"description":"Read workspace metadata and resolved Git commit","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_workspace_get","title":"Get workspace"},{"annotations":{"destructiveHint":true,"openWorldHint":true,"readOnlyHint":false,"title":"Import into workspace"},"description":"Import a public HTTPS Git repository into an empty workspace","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"type":"string"},"reference":{"type":"string"},"request_key":{"type":"string"},"url":{"type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","url","execution_key"],"type":"object"},"name":"ample_workspace_import","title":"Import into workspace"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"List workspace"},"description":"List source workspaces","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["execution_key"],"type":"object"},"name":"ample_workspace_list","title":"List workspace"},{"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true,"title":"Read workspace file"},"description":"Read a UTF-8 or binary file inside a workspace","inputSchema":{"additionalProperties":false,"properties":{"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"type":"string"},"path":{"type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","path","execution_key"],"type":"object"},"name":"ample_workspace_read","title":"Read workspace file"},{"annotations":{"destructiveHint":true,"openWorldHint":false,"readOnlyHint":false,"title":"Upload workspace"},"description":"Replace workspace source with a bounded tar.gz archive (preserve ample.toml and .ample when editing)","inputSchema":{"additionalProperties":false,"properties":{"data_base64":{"type":"string"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"file":{"type":"string"},"id":{"type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","execution_key"],"type":"object"},"name":"ample_workspace_upload","title":"Upload workspace"},{"annotations":{"destructiveHint":true,"openWorldHint":true,"readOnlyHint":false,"title":"Write workspace file"},"description":"Write a workspace file from text, base64 data, or a public https URL Ample downloads (an image, a file the person shared); --deploy then deploys the workspace","inputSchema":{"additionalProperties":false,"properties":{"data_base64":{"type":"string"},"deploy":{"default":false,"description":"Deploy the workspace after writing and wait for the result","enum":[true,false],"type":"boolean"},"executable":{"default":false,"enum":[true,false],"type":"boolean"},"execution_key":{"description":"Unique key for this intended execution. Reuse after disconnects to retrieve it without replaying mutations.","type":"string"},"id":{"type":"string"},"path":{"type":"string"},"source_url":{"description":"A public https URL to download the file from (up to 16 MiB)","type":"string"},"text":{"type":"string"},"workspace_id":{"description":"Account-owned workspace used as the current directory","type":"string"}},"required":["id","path","execution_key"],"type":"object"},"name":"ample_workspace_write","title":"Write workspace file"}],"transport":"streamable-http","version":"0.1.43"}