AgentsPodium Hosting

agent-gateway

ほかの AI エージェントが、2 つのマシンプロトコル（MCP（Streamable HTTP）と A2A（Agent2Agent JSON-RPC））を通じて AgentsPodium のホスティング（インスタンスの作成、監視、管理）を操作できるようにします。どちらも既存のアカウント API（https://agentspodium.com/api）を利用します。

ゲートウェイは状態も独自のシークレットも保持しません。すべての呼び出しには、呼び出し元自身の AgentsPodium API キー（Authorization: Bearer ak_live_...、またはセッショントークン）が含まれ、それがそのままアカウント API に転送されます。このヘッダーがない場合は常に、https://agentspodium.com/account（「API keys for agents」）と https://hosting.defispace.com/docs/auth を示す JSON 本文とともに 401 を返します。

1 つのプロセスが両方のホスト名に対応し、パスが共通する箇所（GET / のみ）は Host ヘッダーに応じて振り分けます。それ以外はすべて MCP の動作となり、mcp.agentspodium.com と a2a.agentspodium.com は同じ Deployment にルーティングされます。

ローカルで実行する

npm install
npm run build
ACCOUNT_API=https://agentspodium.com/api PORT=3200 npm start
# or, for iteration:
npm run dev

環境変数：

• ACCOUNT_API — アカウント API のベース URL（デフォルトは https://agentspodium.com/api）。
• PORT — HTTP ポート（デフォルトは 3200）。
• A2A_HOST — GET / で A2A の動作を選択するホスト名（デフォルトは a2a.agentspodium.com）。

呼び出し方法

MCP — mcp.agentspodium.com/mcp

Streamable HTTP、ステートレス（セッション ID なし）です。 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": {} }
  }'

ツール：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。さらに、1 つのリソース agentspodium://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" }] } }
  }'

テキストの文法：create <engine> <tier> [name ...]、health <id>、 term <id>、platforms、payment <id>。それ以外の場合は、スキル一覧と正確な JSON 形式を返します。

認証不要で公開：GET /catalog.json（アカウント API の /a2a-catalog のプロキシ）。

デプロイ

docker build -t agentpodium-agent-gateway apps/agent-gateway
# push, then apply:
kubectl apply -f apps/agent-gateway/deploy/gateway.yaml

deploy/gateway.yaml は、名前空間 ap-agentgw、ポート 3200 の Deployment／Service、および共有の akash-gateway Gateway に対する 2 つの HTTPRoute（mcp.agentspodium.com、 a2a.agentspodium.com）を作成します。適用する前に、__IMAGE_TAG__ をビルド済みのイメージタグに置き換えてください。