Quickstart
Prerequisites
- A running A2A agent with a valid agent card at
/.well-known/agent-card.json - Node.js installed (for npx)
- Agent Stack running (default:
http://127.0.0.1:8333) - The proxy installed (
npx i-am-bee/agentstack-a2a-proxy)
Connect Your Agent
-
Start your A2A agent and note its URL (e.g.,
http://localhost:8080) - Run the proxy pointing to your agent:
How It Works
The proxy creates a bridge between your A2A agent and Agent Stack by:- Intercepting agent card requests - Captures
/.well-known/agent-card.jsonrequests from any A2A client - Adding Agent Details extension - Automatically injects the necessary AgentDetail extension data that enables the agent to work within the Agent Stack ecosystem
- Auto-registration - Automatically registers the modified agent with the Agent Stack, making it immediately available
The proxy supports agents using
jsonrpc and http_json transport protocols.Configuration Options
Custom Proxy Port
By default, the proxy runs on port 8000. To use a different port:Custom Platform URL
If your Agent Stack is running on a different URL:Disable Auto-Registration
To run the proxy without automatically registering with Agent Stack:Custom Agent Details
You can customize the agent details extension data by providing a JSON file:Available Options
| Option | Alias | Description | Default |
|---|---|---|---|
--port | -p | Port to run the proxy server on | 8000 |
--auto-register | -a | Enable/disable auto-registration with Agent Stack | true |
--platform-url | -P | Platform URL to register with | http://127.0.0.1:8333 |
--custom-data | -c | Path to custom agent detail JSON file | - |