AgentsPodium Hosting

agent-gateway

Lets other AI agents drive AgentsPodium hosting (create/monitor/manage instances) through two machine protocols — MCP (Streamable HTTP) and A2A (Agent2Agent JSON-RPC) — both backed by the existing account API at https://agentspodium.com/api.

The gateway holds no state and no secrets of its own. Every call carries the caller's own AgentsPodium API key (Authorization: Bearer ak_live_..., or a session token), which is forwarded verbatim to the account API. Missing that header always answers 401 with a JSON body pointing at https://agentspodium.com/account ("API keys for agents") and https://hosting.defispace.com/docs/auth.

One process serves both hostnames, selected by the Host header wherever a path is shared between the two (only GET /); everything else defaults to MCP behaviour, and mcp.agentspodium.com / a2a.agentspodium.com route to the same Deployment.

Run locally

npm install

npm run build ACCOUNT_API=https://agentspodium.com/api PORT=3200 npm start

or, for iteration:

npm run dev

Env vars:

• ACCOUNT_API — base URL of the account API (default https://agentspodium.com/api).
• PORT — HTTP port (default 3200).
• A2A_HOST — hostname that selects A2A behaviour for GET / (default a2a.agentspodium.com).

Calling it

MCP — mcp.agentspodium.com/mcp

Streamable HTTP, stateless (no session id). Requires Accept: application/json, text/event-stream.

# initialize

curl -s -X POST https://mcp.agentspodium.com/mcp \ -H "Authorization: Bearer ak_live_..." \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "initialize", "params": { "protocolVersion": "2025-06-18", "capabilities": {}, "clientInfo": { "name": "example-client", "version": "0.1.0" } } }'

call a tool

curl -s -X POST https://mcp.agentspodium.com/mcp \ -H "Authorization: Bearer ak_live_..." \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{ "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "list_platforms", "arguments": {} } }'

Tools: list_platforms, list_instances, create_instance, get_instance_health, get_instance_term, set_llm_key, pause_instance, resume_instance, rebuild_instance, delete_instance, get_payment_options, set_peers, set_webhook. Plus one resource, agentspodium://docs (the hosting docs).

A2A — a2a.agentspodium.com/

curl -s https://a2a.agentspodium.com/.well-known/agent-card.json

structured (data part)

curl -s -X POST https://a2a.agentspodium.com/ \ -H "Authorization: Bearer ak_live_..." \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "message/send", "params": { "message": { "parts": [{ "kind": "data", "data": { "skill": "create-instance", "params": { "engine": "hermes", "tier": "small", "name": "My Agent" } } }] } } }'

plain text (small command grammar)

curl -s -X POST https://a2a.agentspodium.com/ \ -H "Authorization: Bearer ak_live_..." \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "id": 2, "method": "message/send", "params": { "message": { "parts": [{ "kind": "text", "text": "platforms" }] } } }'

Text grammar: create [name ...], health , term , platforms, payment . Anything else answers with the skill list and the exact JSON shape.

Public, no auth: GET /catalog.json (proxy of the account API's /a2a-catalog).

Deploy

docker build -t agentpodium-agent-gateway apps/agent-gateway

push, then apply:

kubectl apply -f apps/agent-gateway/deploy/gateway.yaml

deploy/gateway.yaml creates namespace ap-agentgw, a Deployment/Service on port 3200, and two HTTPRoutes (mcp.agentspodium.com, a2a.agentspodium.com) against the shared akash-gateway Gateway. Swap __IMAGE_TAG__ for the built image tag before applying.