a2a

A2A (Agent-to-Agent) Integration

ContextForge supports A2A (Agent-to-Agent) integration, allowing you to register external AI agents and expose them as MCP tools for seamless integration with other agents and MCP clients.

Overview

A2A integration enables you to:

• Register external AI agents (OpenAI, Anthropic, custom agents)
• Expose agents as MCP tools for universal discovery and access
• Support multiple protocols (JSONRPC, custom formats)
• Manage agent lifecycle through admin UI and APIs
• Monitor performance with comprehensive metrics
• Configure authentication with various auth methods

Quick Start

!!! tip "Base URL" - Direct installs (uvx, pip, or docker run): http://localhost:4444 - Docker Compose (nginx proxy): http://localhost:8080

1. Enable A2A Features

# In your .env file or environment variables
MCPGATEWAY_A2A_ENABLED=true
MCPGATEWAY_A2A_METRICS_ENABLED=true

2. Register an A2A Agent

Via Admin UI:

1. Go to http://localhost:4444/admin
2. Click the "A2A Agents" tab
3. Fill out the "Add New A2A Agent" form
4. Click "Add A2A Agent"

Via REST API:

curl -X POST "http://localhost:4444/a2a" \
  -H "Authorization: Bearer $MCPGATEWAY_BEARER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "hello_world_agent",
    "endpoint_url": "http://localhost:9999/",
    "agent_type": "jsonrpc",
    "description": "External AI agent for hello world functionality",
    "passthrough_headers": ["Authorization", "X-Tenant-Id"],
    "auth_type": "api_key",
    "auth_value": "your-api-key",
    "tags": ["ai", "hello-world"]
  }'

Optional request fields:

Field	Description	Example
passthrough_headers	Header names allowed to pass from the incoming request to this A2A agent. Unset (null) and empty ([]) both block request-header forwarding. TOOL_PRE_INVOKE plugin payloads receive only the non-sensitive subset.	["Authorization", "X-Tenant-Id"]