Skip to main content
Glama

copilot-agents-mcp

Servidor MCP local para lanzar agentes de GitHub Copilot en la nube, consultar su estado y leer los modelos de Copilot.

No se despliega. Se ejecuta en tu máquina con stdio o, si lo pides, con HTTP en 127.0.0.1.

Requisitos

  • Node.js 22.18 o posterior (en Windows también).

  • Un token de GitHub con el permiso «Agent tasks: read and write» en los repositorios donde lances tareas. Hace falta para lanzar, leer una tarea y listar los modelos. No hace falta para listar las herramientas.

Related MCP server: Strata Coder

Cómo preparar el entorno

bash scripts/setup

Ejecutarlo

npx -y github:daniel-saezv/copilot-agents-mcp

Eso abre el servidor por stdio. Para HTTP:

npx -y github:daniel-saezv/copilot-agents-mcp --http --port 3333

El proceso escucha solo en 127.0.0.1. La ruta es /mcp. También acepta /mcp/readonly, /mcp/x/{toolset} y las cabeceras X-MCP-Toolsets, X-MCP-Tools, X-MCP-Exclude-Tools, X-MCP-Readonly y X-MCP-Features.

El vigilante es otro proceso. create_agent_task lo arranca desacoplado. También puedes lanzarlo tú:

npx -y github:daniel-saezv/copilot-agents-mcp watch

Consulta cada tarea hasta completed, failed, timed_out, cancelled o idle. Guarda el estado en un archivo local y, al volver a arrancar, retoma las que no han terminado. Avisa una sola vez por tarea.

Configurarlo en un cliente MCP

El token vive en el entorno del proceso, no en los argumentos ni en un archivo.

Stdio:

{
  "mcpServers": {
    "copilot-agents": {
      "command": "npx",
      "args": ["-y", "github:daniel-saezv/copilot-agents-mcp"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "github_pat_…",
        "COPILOT_AGENTS_NOTIFY_URL": "https://ejemplo.invalid/aviso"
      }
    }
  }
}

HTTP: arranca el proceso con el token en el entorno y apunta el cliente a http://127.0.0.1:3333/mcp. El cliente no envía el token de GitHub.

Herramientas

Por defecto están copilot_tasks y copilot_models. Los toolsets copilot_automations y copilot_agent_merge piden --features=agent_automations y --features=agent_merge. En esta versión no tienen herramientas.

Herramienta

Toolset

Solo lectura

Descripción

create_agent_task

copilot_tasks

no

Lanza una tarea del agente de Copilot en la nube. El modelo se envía tal cual. Si ese modelo ya se vio rechazado, no llama a la API y lista los modelos vistos aceptados.

get_agent_task

copilot_tasks

sí

Lee una vez el estado de una tarea del agente de Copilot.

list_copilot_models

copilot_models

sí

Lee /agents/swe/models y devuelve id, nombre, vendor, preview, el precio por tokens o el multiplier, y la promo si existe.

create_agent_task recibe repo (owner/name), prompt, model y, si quieres, base_ref, head_ref, custom_agent y create_pull_request. El modelo se envía tal cual: no hay una lista en el código. La API responde 201 y puede rechazar el modelo después. Si ya se vio ese rechazo, la herramienta corta con isError y lista los modelos vistos aceptados. Si el rechazo llega más tarde, el mismo error queda en el estado y en el aviso.

get_agent_task hace una sola lectura. list_copilot_models pide a GraphQL (viewer.copilotEndpoints.api) la base de la API de Copilot y, en cada llamada, lee {api}/agents/swe/models. No guarda caché ni mezcla tareas. La respuesta cita esa URL y fetched_at. Si GraphQL o el GET no responden 200, o el formato no cuadra, devuelve un error y no inventa modelos. Los precios salen tal cual, con batch_size. token_prices es obligatorio salvo que el modelo traiga billing.multiplier. policy es opcional: si no viene, la salida pone policy.state a null; si viene, state es un string.

Aviso al terminar

El aviso es una notificación del sistema (toast de Windows, osascript en macOS, notify-send en Linux) y, si configuras la URL, un POST JSON.

Variables:

  • COPILOT_AGENTS_NOTIFY_URL: URL del POST. Si no está, no hay POST.

  • COPILOT_AGENTS_NOTIFY_AUTHORIZATION: valor de la cabecera Authorization. Si no está, el POST no lleva esa cabecera.

  • COPILOT_AGENTS_STATE_PATH: archivo de estado. Por defecto, ~/.copilot-agents-mcp/state.json.

  • COPILOT_AGENTS_POLL_INTERVAL_MS: pausa entre lecturas. Por defecto, 15000.

  • COPILOT_AGENTS_LOG: si está, el vigilante añade su error estándar a ese archivo.

El POST lleva Content-Type: application/json y este cuerpo:

{
  "task_id": "0ad0914d-889f-4221-bdae-42074c1ab62e",
  "repo": "octocat/hello-world",
  "state": "completed",
  "requested_model": "grok-4.7",
  "resolved_model": "sweagent-capi:grok-4.7",
  "pull_request": {
    "id": 42,
    "number": 7,
    "html_url": "https://github.com/octocat/hello-world/pull/7"
  },
  "branch": { "head_ref": "copilot/demo", "base_ref": "main" },
  "artifacts": [
    { "type": "pull", "id": 42 },
    { "type": "branch", "head_ref": "copilot/demo", "base_ref": "main" }
  ],
  "error": null,
  "usage": { "type": "ai_credits", "amount": 344355000, "amount_human": 0.344355 },
  "created_at": "2026-11-22T00:00:00Z",
  "updated_at": "2026-11-22T00:01:00Z",
  "completed_at": "2026-11-22T00:05:00Z"
}

resolved_model es sessions[].model tal como lo devuelve la API, o null. branch sale de artifacts. pull_request.id es el id interno del artefacto, no el número de la pull request. number y html_url salen del artefacto si vienen. Si no, se piden con GET /repos/{owner}/{repo}/pulls?head={owner}:{head_ref}&state=all y se usa la entrada con esa id. head_ref es el del artefacto de rama o, si no hay, el de la sesión. Si no se pueden resolver, number y html_url van a null y el motivo se añade a COPILOT_AGENTS_LOG. El aviso se envía igual.

error es null o el texto del fallo. Si el modelo no está disponible, incluye los modelos vistos aceptados. usage.amount es el valor crudo. Con ai_credits, la API lo da en nano unidades y amount_human es amount / 1e9: 344355000 sale como 0.344355. Con premium_requests, amount_human es el mismo número.

Si notify-send, osascript o el toast de Windows no arranca, el vigilante escribe el motivo en COPILOT_AGENTS_LOG (por ejemplo ENOENT notify-send) y sigue con el POST.

Repetir un aviso

El vigilante avisa una vez. notified_at guarda ese momento. Para repetir el aviso de una tarea ya terminada, sin lanzar otra:

  1. Espera a que el vigilante haya salido. Si la tarea ya se avisó, ese proceso ya no está.

  2. Copia el archivo de estado y pon notified_at en null para esa tarea. Deja state como está.

  3. Arranca watch con COPILOT_AGENTS_STATE_PATH apuntando a la copia.

Hace falta el token. El vigilante no vuelve a leer la tarea de agente. Recalcula amount_human desde usage.amount y, si faltan number o html_url, llama a la API de pull requests.

mkdir -p "$HOME/reaviso"
cp "${COPILOT_AGENTS_STATE_PATH:-$HOME/.copilot-agents-mcp/state.json}" "$HOME/reaviso/state.json"
node --input-type=module -e 'import { readFileSync, writeFileSync } from "node:fs"; const path = `${process.env.HOME}/reaviso/state.json`; const state = JSON.parse(readFileSync(path, "utf8")); state.tasks[process.argv[1]].notified_at = null; writeFileSync(path, `${JSON.stringify(state, null, 2)}\n`);' -- ID-DE-LA-TAREA
GITHUB_PERSONAL_ACCESS_TOKEN=github_pat_… \
COPILOT_AGENTS_STATE_PATH="$HOME/reaviso/state.json" \
COPILOT_AGENTS_NOTIFY_URL=http://127.0.0.1:9/aviso \
COPILOT_AGENTS_LOG="$HOME/reaviso/watch.log" \
npx -y github:daniel-saezv/copilot-agents-mcp watch

Sustituye ID-DE-LA-TAREA y la URL del POST. El proceso sale cuando ha enviado el aviso.

Variables del token

GITHUB_PERSONAL_ACCESS_TOKEN es la que se usa. Si no está, se aceptan GH_TOKEN y, en último lugar, GITHUB_TOKEN. El token no se escribe en archivos, logs ni fixtures.

Otras variables del servidor, iguales que en el MCP oficial: GITHUB_TOOLSETS, GITHUB_TOOLS, GITHUB_EXCLUDE_TOOLS y GITHUB_READ_ONLY.

Desarrollo

bash scripts/setup
npm test
npm run typecheck
npm run lint
npm run build

npm run build genera dist/. prepare lo hace al instalar desde GitHub, porque Node no ejecuta TypeScript dentro de node_modules.

Las reglas para agentes están en AGENTS.md.

Licencia

MIT.

La referencia comunitaria fvegiard/copilot-cloud-agent-mcp es MIT y no se copia código suyo. Los fixtures de la API de tareas vienen de github/rest-api-description (MIT).

Available Tools

3 tools
create_agent_taskLanzar tarea de CopilotA

Lanza una tarea del agente de Copilot en la nube. El modelo se envía tal cual. Si ese modelo ya se vio rechazado, no llama a la API y lista los modelos vistos aceptados.

Inputs: repo (required), model (required), prompt (required), base_ref, +3 more. Returns: repo, state, task_id, html_url, +2 more

get_agent_taskEstado de una tareaB
Read-onlyIdempotent

Lee una vez el estado de una tarea del agente de Copilot.

Inputs: task_id (required), repo. Returns: repo, error, state, usage, +9 more

list_copilot_modelsModelos de CopilotA
Read-onlyIdempotent

Lee /agents/swe/models y devuelve id, nombre, vendor, preview, el precio por tokens o el multiplier, y la promo si existe.

Inputs: no named parameters. Returns: models, source

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 3 tools

    Disambiguation4/5

    The three tools target clearly distinct actions: launching a task, reading task status, and listing available models. The only blur is that create_agent_task embeds a model-listing fallback behavior, which slightly overlaps with list_copilot_models, but an agent can still tell them apart.

    Naming Consistency4/5

    All three names follow a snake_case verb_noun pattern (create_agent_task, get_agent_task, list_copilot_models), which is predictable. The minor deviation is that the noun changes between agent_task and copilot_models, and 'copilot' is redundantly embedded in one name.

    Tool Count3/5

    Three tools is quite thin for a task-lifecycle server; launching and reading a task without any other lifecycle operations leaves little room for real workflows. The count is defensible for a narrow wrapper, but it sits at the borderline of feeling under-scoped.

    Completeness2/5

    The surface covers launch, single status read, and model listing, but there is no way to cancel/stop a task, list existing tasks, wait or poll for completion, or retrieve logs/artifacts. These gaps will likely force agents into dead ends during real task management.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      Enables a primary coding agent to delegate bounded implementation and repair tasks to a local OpenAI-compatible model that edits a copy of the project, runs configured checks, and returns artifacts for review. Exposes stdio tools for capability discovery, task submission, progress polling, artifact reading, and cancellation.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables an AI assistant to delegate coding tasks to local Codex or Claude Code CLIs, monitor their progress, read results, continue sessions, and browse the files in user-approved project workspaces. It exposes these capabilities over Streamable HTTP through a Cloudflare tunnel or locally over stdio, so a remote or cloud client can drive agents running on the user's own machine.
      60 npm
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables coding agents and IDEs to request multi-model code review, architectural planning, and technical consultation over stdio, returning actionable diffs and SARIF diagnostics.
      3
      MIT