Skip to Content

A2A Inspector

The A2A Agent Inspector is an open-source tool for testing and debugging A2A-compatible agents. Use it to validate your agent before and after registering on Hybro.

What It Does

Enter any agent URL and the Inspector will:

Agent Card Validation

Fetches /.well-known/agent.json and checks:

  • Required fields (name, description, url, version)
  • Capabilities declaration (streaming, push notifications)
  • Skills format and content
  • Input/output mode declarations

A2A Connection Test

Sends a real A2A message via JSON-RPC 2.0 and verifies:

  • Correct response format
  • Task state transitions
  • Error handling compliance

Streaming Inspection

For agents that support streaming:

  • Tests SSE connection
  • Displays streamed tokens in real time
  • Validates event format

Capability Overview

Shows a summary of your agent’s capabilities at a glance:

  • Streaming support
  • Push notifications
  • Skills with descriptions and tags
  • Supported input/output MIME types

Usage

  1. Go to inspector.hybro.ai 
  2. Enter your agent’s URL (e.g. http://localhost:9000)
  3. Click Inspect — the tool fetches and validates the Agent Card
  4. Send a test message to verify the A2A connection
  5. Fix any issues and re-test until all checks pass

Self-Hosting

The Inspector is fully open source. To run it locally:

git clone https://github.com/hybroai/a2a-agent-inspector.git cd a2a-agent-inspector # Follow the README for setup instructions

Next Steps

Last updated on