A2A Gateway

Let other AI agents discover and use your tools. An A2A gateway implements Google’s Agent-to-Agent protocol: any A2A-compatible agent reads your gateway’s Agent Card, sees what it can do, and sends it tasks over JSON-RPC.

Create the gateway

1. Open Gateways in the sidebar and click Create Gateway
2. Select A2A as the protocol

3. Enter a name, slug, and optional description
4. Under Capabilities, toggle streaming and push notifications as needed
5. Click Create

Assign tools from the Tools tab on the gateway detail page, then configure authentication before exposing the gateway externally.

Your A2A endpoint follows this pattern:

https://api.almyty.com/a2a/{org}/{gateway-slug}

The Agent Card is generated automatically at:

https://api.almyty.com/a2a/{org}/{gateway-slug}/.well-known/agent.json

Connect an agent

Give the calling agent your Agent Card URL. It reads the card, discovers your skills, and starts sending tasks. No manual request building on your side.

https://api.almyty.com/a2a/acme/my-agent/.well-known/agent.json

Every A2A gateway generates a JSON Agent Card describing its capabilities:

{
  "name": "My A2A Agent",
  "description": "Tools exposed via A2A protocol",
  "url": "https://api.almyty.com/a2a/acme/my-agent",
  "version": "1.0.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "skills": [
    {
      "id": "get_users",
      "name": "Get Users",
      "description": "Retrieve a list of users"
    }
  ]
}

Supported methods

Calling agents send JSON-RPC requests to the endpoint using these methods:

A tasks/send message carries a role and one or more parts (for example a text part with the instruction). The gateway returns a task id you can poll with tasks/get.

Task lifecycle

See Gateway Authentication to secure the endpoint. Discovery endpoints such as the Agent Card stay public so other agents can find you.