copilot-cloud-agent-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| create_taskA | Start a new Copilot cloud-agent task on a repository. POST /agents/repos/{owner}/{repo}/tasks Args: owner: Repo owner (user or org login). repo: Repo name. prompt: Natural-language instruction for the agent. base_ref: Branch the agent should base work on (defaults to repo default). head_ref: Branch the agent should push work to (optional). model: Optional model override. Known values: claude-sonnet-4.6, claude-opus-4.6, gpt-5.2-codex, gpt-5.3-codex, gpt-5.4, claude-sonnet-4.5, claude-opus-4.5. Omit for auto-selection. create_pull_request: If true, the agent opens a PR when done. Returns:
Task object including |
| list_tasksA | List Copilot cloud-agent tasks. If both Args: owner: Optional repo owner. repo: Optional repo name. state: Filter by states (any of queued, in_progress, completed, failed, idle, waiting_for_user, timed_out, cancelled). is_archived: Include archived tasks. since: ISO 8601 timestamp; only tasks updated after this. sort: updated_at or created_at. direction: asc or desc. per_page: 1–100, default 30. page: page number, default 1. creator_id: Repo-scoped only — filter by creator user IDs. |
| get_taskA | Get a single task (with its sessions) by ID. Prefers the repo-scoped endpoint when owner+repo are provided: GET /agents/repos/{owner}/{repo}/tasks/{task_id} Otherwise: GET /agents/tasks/{task_id} The response includes a |
| wait_for_taskA | Poll a task until it reaches a terminal state, or timeout. Terminal states: completed, failed, timed_out, cancelled. Non-terminal (will keep polling): queued, in_progress, idle, waiting_for_user. Args:
task_id: Task ID returned by Returns:
Final task object plus |
| get_org_permissionsA | Get an org's Copilot coding-agent repo-access setting. GET /orgs/{org}/copilot/coding-agent/permissions
Returns: {enabled_repositories: all|selected|none, selected_repositories_url}
Requires |
| set_org_permissionsA | Set whether all, selected, or no repos in an org can use the cloud agent. PUT /orgs/{org}/copilot/coding-agent/permissions
Requires |
| list_org_enabled_reposA | List repos in an org that have cloud-agent access enabled. GET /orgs/{org}/copilot/coding-agent/permissions/repositories
Requires |
| set_org_selected_reposB | Replace the org's selected-repos list for cloud-agent access. PUT /orgs/{org}/copilot/coding-agent/permissions/repositories
Only meaningful when |
| enable_repo_for_orgC | Add one repo to the org's selected cloud-agent list. PUT /orgs/{org}/copilot/coding-agent/permissions/repositories/{repository_id}
Requires |
| disable_repo_for_orgA | Remove one repo from the org's selected cloud-agent list. DELETE /orgs/{org}/copilot/coding-agent/permissions/repositories/{repository_id}
Requires |
| list_known_modelsA | Return the model strings accepted by Omit |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 11 tools
The tools cleanly separate into task management (create, get, list, wait) and org permission management (enable, disable, get, set, list). No overlapping purposes; each tool targets a distinct API operation.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., create_task, get_org_permissions). No mixing of conventions or vague verbs.
11 tools cover two focused domains (task lifecycle and org permissions) without redundancy or bloat. The scope is appropriate for a Copilot cloud-agent server.
Task management is well-covered (create, get, list, wait) but lacks a cancel/stop tool, which is a noticeable gap given that `cancelled` is a terminal state. Org permissions are fully covered.