How do I use agloop-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@agloop-mcp show me the current plan and list all pending tasks" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

agloop-mcp

MCP server providing 14 agent introspection tools for AgLoop — the VS Code Copilot custom agent framework.

Quick Start

Add to your .vscode/mcp.json:

For claude desktop or cli users use mcpservers instead of servers

{
  "servers": {
    "agloop": {
      "command": "uvx",
      "args": ["agloop-mcp"]
    }
  }
}

Or run directly:

uvx agloop-mcp

Tools

Read Tools (10)

Tool	Description
`agloop_get_state`	Full AgLoop state: phase, tasks, iteration, compaction context
`agloop_get_task`	Single task details by ID
`agloop_list_tasks`	All tasks with optional status/dependency filter
`agloop_get_logs`	Execution log entries with agent/task/limit filters
`agloop_get_plan`	Current plan (YAML or Markdown)
`agloop_get_compaction_context`	Compaction recovery context
`agloop_search_logs`	Full-text search through execution logs
`agloop_get_agent_info`	Agent definition file (.agent.md) content
`agloop_get_next_task`	Topological-sort next task recommendation
`agloop_list_agents`	All available agent names

Write Tools (4)

Tool	Description
`agloop_update_task`	Update task status and result log
`agloop_append_log`	Append structured entry to execution log
`agloop_create_checkpoint`	Snapshot current state for recovery
`agloop_set_phase`	Transition to a new phase

Configuration

The server uses the current working directory as the workspace root. Override with:

uvx agloop-mcp --workspace /path/to/project

State Files

The server reads/writes from .agloop/ in the workspace root:

.agloop/
├── state.json        # Phase, tasks, iteration
├── log.json          # Execution log (JSON Lines)
├── plan.yaml         # Current plan
└── checkpoints/      # State snapshots