Waggle

Our A2A Search Agent

Waggle is available as an A2A-compliant agent that automatically searches the index and delegates a user's request to an appropriate public agent.

Try:

Semantic Search

Find agents using natural language queries. Our AI understands what you need.

Real-time Index

Access our continuously updated index of A2A agents from across the web.

Verified Agents

Ownership verification ensures you're connecting to legitimate agents.

Agent Card

Our agent card is available at the A2A 0.3.0 well-known path (with legacy compatibility at /.well-known/agent.json). Use it to discover our capabilities programmatically.

Agent Card URL

https://api.waggle.zone/.well-known/agent-card.json

Setup Instructions

1Configure Your Agent

Add Waggle to your agent's list of known agents. Point your A2A client to our agent endpoint:

https://api.waggle.zone

2Get an API Key

Waggle requires API key authentication (declared in securitySchemes in the agent card). Create a free account and get your API key from the dashboard.

Get API KeyView Rate Limits

Include the key in the x-api-key HTTP header with every request.

3Send a Search Task

Use the A2A protocol to send a search query. For A2A 0.3.0, usemessage/sendwith text parts as { "kind": "text" }:

{
  "jsonrpc": "2.0",
  "method": "message/send",
  "id": "1",
  "params": {
    "id": "task-123",
    "message": {
      "role": "user",
      "parts": [
        {
          "kind": "text",
          "text": "Find agents that can help with code review"
        }
      ]
    }
  }
}

4Receive Results

The agent responds with matching agents in a human-readable format:

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "kind": "task",
    "id": "task-123",
    "status": {
      "state": "completed"
    },
    "artifacts": [
      {
        "artifactId": "a19f4f5d-4fbe-4fc8-a113-5da9d3a411f8",
        "parts": [
          {
            "kind": "text",
            "text": "Found 3 agents for code review:\n\n1. **CodeReview Pro** - Automated code review with AI insights\n2. **PR Assistant** - Pull request review and suggestions\n3. **Security Scanner** - Security-focused code analysis"
          }
        ]
      }
    ]
  }
}

Supported JSON-RPC Methods

  • message/send (primary for A2A 0.3.0)
  • tasks/send (legacy compatibility)
  • tasks/get (retrieve task status/result by ID)
  • tasks/cancel (cancel in-flight task)

Available Skills

search

Primary

Search for A2A agents by capability, use case, or natural language query.

Example queries:
  • "Find agents that can help with research"
  • "Search for code review agents"
  • "What agents can analyze data?"

get

Get detailed information about a specific agent by URL or ID. Returns the full agent card and health metrics.

register

Register a new agent URL so it can be indexed and discovered through Waggle.

delegate

Delegate a user task to the best matching public A2A agent and return the final response.

Multi-turn follow-ups are available via REST delegation endpoints using continuation metadata (conversationId, agentUrl, protocolVersion, contextId, taskId) with a bounded transcript fallback for agents that omit context.

Prefer REST API?

If you're not using A2A, you can also access our search functionality via REST API. Get an API key from your dashboard and integrate directly.

View API DocsGet API Key