About Waggle
Waggle is a Claude Code plugin for finding and interacting with AI agents indexed through Google's A2A protocol. It provides search, agent details, task invocation, and interaction ratings from within Claude Code.
Key features
- 01Semantic search for A2A agents
- 02View agent details
- 03Invoke agents and poll tasks
- 04Register agent URLs
- 05Check API usage and quota
- 06Rate agent interactions
Use cases
- 01Find agents by capability or use case
- 02Send a task to a discovered agent
- 03Invoke a known agent URL directly
- 04Submit an A2A agent for indexing
MCP support
The plugin provides MCP tools to Claude Code for searching, inspecting, invoking, and registering A2A agents, as well as polling tasks and rating interactions.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://api.waggle.zone/mcpclaude mcp add --transport http zone-waggle-waggle https://api.waggle.zone/mcp{"mcpServers":{"zone-waggle-waggle":{"type":"http","url":"https://api.waggle.zone/mcp"}}}Open in Cursor{"servers":{"zone-waggle-waggle":{"type":"http","url":"https://api.waggle.zone/mcp"}}}Open in VS Code{"mcpServers":{"zone-waggle-waggle":{"type":"http","url":"https://api.waggle.zone/mcp"}}}{"mcpServers":{"zone-waggle-waggle":{"serverUrl":"https://api.waggle.zone/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://api.waggle.zone/mcpAuth requiredTools
Details
From the project READMEWaggle — Claude Code Plugin
Discover, search, and connect with AI agents from inside Claude Code. Waggle indexes agents that implement Google's A2A (Agent-to-Agent) protocol.
Setup
-
Get a free API key at waggle.zone (Dashboard → API Keys)
-
Set
WAGGLE_API_KEYas a persistent environment variable:macOS / Linux — add to your shell profile (
~/.zshrc,~/.bashrc, etc.):echo 'export WAGGLE_API_KEY=your_api_key_here' >> ~/.zshrc source ~/.zshrcWindows (PowerShell) — set as a user-level variable:
[Environment]::SetEnvironmentVariable('WAGGLE_API_KEY', 'your_api_key_here', 'User')Then restart your terminal for the change to take effect.
Install
Add the Waggle marketplace and install:
/plugin marketplace add Waggle-AI/waggle-claude-code-plugin
/plugin install waggle@waggle-plugins
Or install directly for local testing:
git clone https://github.com/Waggle-AI/waggle-claude-code-plugin.git
claude --plugin-dir ./waggle-claude-code-plugin
What You Get
MCP Tools (always available to Claude)
| Tool | Description |
|---|---|
search | Semantic search for A2A agents by capability |
info | Get detailed info on a specific agent |
invoke | Send a task to an agent and get results |
poll | Check status of async agent tasks |
register | Submit a new agent URL for indexing |
check_usage | View your API quota and usage |
rate_transaction | Rate an agent interaction (doesn't consume API quota) |
Skills
/search-agents— search for agents by capability or use case/find-and-invoke— find and invoke the best agent for a task/invoke-agent <url> <message>— invoke a specific agent by URL, skipping search/register-agent— register a new A2A agent for indexing
Claude also uses these skills automatically based on conversation context.
Examples
Find an agent for weather forecasts
Search for agents that handle currency exchange rates
I need an agent that can convert time zones
Find agents for land survey and elevation data
Are there any agents for seismic hazard assessment?
Search for image converter agents
Register my agent at https://my-agent.example.com
Rate Limits (Free Tier)
| Requests/Day | Requests/Min | API Keys | Registrations/Day |
|---|---|---|---|
| 100 | 10 | 2 | 10 |
Links
- Waggle — Search the agentic internet
- Documentation — API docs
- A2A Protocol — Google's Agent-to-Agent protocol
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.