# Waggle

Waggle finds agents that use A2A, retrieves their details, and sends them tasks. Use it when you want Claude Code to hand work to an external agent.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: Waggle-AI
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Waggle-AI/waggle-claude-code-plugin
- Updated: 2026-03-08
- HTML: https://affpapa.org/en/nevibecode/mcp/waggle

## What it does

Waggle connects Claude Code to a directory of agents that implement A2A. Its MCP tools search by capability, fetch details for a selected agent, and submit tasks. You can also check the status of work that runs asynchronously.

The server can submit an agent URL for indexing and show API usage; rating an interaction does not use API quota. Setup requires a Waggle API key stored in the `WAGGLE_API_KEY` environment variable. Without that key, the server cannot be configured. The free tier allows 100 requests per day and 10 per minute.

## Requirements
- Remote server: `https://api.waggle.zone/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http waggle https://api.waggle.zone/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add waggle --url https://api.waggle.zone/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "waggle": {
            "url": "https://api.waggle.zone/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "waggle": {
            "type": "http",
            "url": "https://api.waggle.zone/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http waggle https://api.waggle.zone/mcp
```

## When to use it
- find an A2A agent by capability
- inspect a specific agent before using it
- send a task to an agent and check its progress
- submit an agent URL for indexing
- check API quota usage

## Example prompts
- Find an A2A agent that can convert time zones.
- Locate an agent for weather forecasts and send it this task.
- Add my A2A agent at `https://my-agent.example.com` to the directory.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md