Waggle — Claude Code MCP server: agent search and setup
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.
claude mcp add --transport http waggle https://api.waggle.zone/mcpWhat Waggle 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.
What it helps with
- 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 for the agent
- 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.comto the directory.
How to install Waggle
Platform CLI: remote server
claude mcp add --transport http waggle https://api.waggle.zone/mcpPlatform CLI: remote server
codex mcp add waggle --url https://api.waggle.zone/mcpConfig file
{
"mcpServers": {
"waggle": {
"url": "https://api.waggle.zone/mcp"
}
}
}Config file
{
"servers": {
"waggle": {
"type": "http",
"url": "https://api.waggle.zone/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http waggle https://api.waggle.zone/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Waggle
How do I install Waggle in Claude Code?
Add the MCP server with claude mcp add --transport http waggle https://api.waggle.zone/mcp. Set the WAGGLE_API_KEY environment variable to configure access.
What does Waggle do?
Waggle searches A2A agents, retrieves their details, and sends them tasks. It can also check asynchronous task status and submit agents for indexing.
Does Waggle require an API key?
Yes. Store your Waggle key in the WAGGLE_API_KEY environment variable before configuring the server.
