English Français العربية

Waggle

Official registry Search and web

Discover, search, invoke, and rate A2A (Agent-to-Agent) protocol agents.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http waggle 'https://api.waggle.zone/mcp' --header 'X-Api-Key: <Waggle API key — get one free at https://waggle.zone (Dashboard > API Keys)>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "waggle": {
            "type": "http",
            "url": "https://api.waggle.zone/mcp",
            "headers": {
                "X-Api-Key": "<Waggle API key — get one free at https://waggle.zone (Dashboard > API Keys)>"
            }
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Waggle — Claude Code Plugin
  2. Setup
  3. Install
  4. What You Get
  5. Examples
  6. Rate Limits (Free Tier)
  7. Links

Waggle — 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

  1. Get a free API key at waggle.zone (Dashboard → API Keys)

  2. Set WAGGLE_API_KEY as 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 ~/.zshrc

    Windows (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)
ToolDescription
searchSemantic search for A2A agents by capability
infoGet detailed info on a specific agent
invokeSend a task to an agent and get results
pollCheck status of async agent tasks
registerSubmit a new agent URL for indexing
check_usageView your API quota and usage
rate_transactionRate 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/DayRequests/MinAPI KeysRegistrations/Day
10010210

Frequently asked questions

What is Waggle?

Discover, search, invoke, and rate A2A (Agent-to-Agent) protocol agents.

How do I install Waggle?

It runs as a remote server. In Claude Code: claude mcp add --transport http waggle 'https://api.waggle.zone/mcp' --header 'X-Api-Key: <Waggle API key — get one free at https://waggle.zone (Dashboard > API Keys)>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Waggle need an API key?

Yes. It expects X-Api-Key, which you set in its configuration.

Is Waggle open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Waggle?

It is published by Waggle-AI. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.