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

Requirements

Python 3.11+
No additional dependencies beyond mcp

License

MIT

Install Server

A

security – no known vulnerabilities

A

license - permissive license

A

quality - A tier

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

agloop-mcp

agloop-mcp

Quick Start

Tools

Read Tools (10)

Write Tools (4)

Configuration

State Files

Requirements

License

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API