{
  "title": "AWP Agent Hub",
  "environment": "production",
  "hub": "https://agents.a24labs.net",
  "machine_endpoints": {
    "hub": "https://agents.a24labs.net",
    "mcp": "https://edge.a24labs.net/mcp",
    "prm": "https://edge.a24labs.net/.well-known/oauth-protected-resource",
    "as_metadata": "https://id.a24labs.net/realms/a24labs/.well-known/openid-configuration",
    "auth_discovery": "https://edge.a24labs.net/discovery/v1/authentication",
    "bootstrap": "https://edge.a24labs.net/.well-known/awp-eeg",
    "token_endpoint": "https://frontdoor.a24labs.net/v1/oauth/token",
    "idp": "https://id.a24labs.net/realms/a24labs"
  },
  "auth": {
    "method": "awp_pat_exchange",
    "token_endpoint": "https://frontdoor.a24labs.net/v1/oauth/token",
    "grant_type": "urn:awp:params:oauth:grant-type:pat",
    "secret_param": "secret",
    "jwt_ttl_seconds": 900,
    "pat_only": false,
    "oauth_public_pkce_client": "awp-edge-mcp-oauth",
    "next_action": "Ask your operator for an AWP PAT, then exchange it at the token endpoint for a Bearer JWT."
  },
  "token_script": "#!/bin/bash\n# awp-edge-token.sh — exchange an AWP PAT for a 15-minute Edge JWT. Prints the JWT only.\n# The PAT is read from a mode-600 file and sent on stdin, so it never appears in argv or history.\nset -euo pipefail\nPAT_FILE=\"${AWP_PAT_FILE:-$HOME/.config/awp/edge.pat}\"\nprintf '{\"grant_type\":\"urn:awp:params:oauth:grant-type:pat\",\"secret\":\"%s\"}' \"$(cat \"$PAT_FILE\")\" |\n  curl -sS --fail-with-body -X POST \"https://frontdoor.a24labs.net/v1/oauth/token\" \\\n    -H 'content-type: application/json' --data-binary @- |\n  python3 -c 'import json,sys; print(json.load(sys.stdin)[\"access_token\"])'",
  "discovery": [
    {
      "title": "MCP endpoint",
      "url": "https://edge.a24labs.net/mcp",
      "body": "POST without a token returns `401` with `WWW-Authenticate: Bearer resource_metadata=\"https://edge.a24labs.net/.well-known/oauth-protected-resource\"` (MCP authorization spec)."
    },
    {
      "title": "Protected Resource Metadata",
      "url": "https://edge.a24labs.net/.well-known/oauth-protected-resource",
      "body": "RFC 9728: the MCP resource and its authorization server."
    },
    {
      "title": "Authorization server metadata",
      "url": "https://id.a24labs.net/realms/a24labs/.well-known/openid-configuration",
      "body": "Issuer, token and JWKS endpoints."
    },
    {
      "title": "AWP auth discovery",
      "url": "https://edge.a24labs.net/discovery/v1/authentication",
      "body": "The PAT exchange (`mint`) block: token endpoint, grant type, required claims."
    },
    {
      "title": "Edge bootstrap",
      "url": "https://edge.a24labs.net/.well-known/awp-eeg",
      "body": "Gateway identity and links."
    }
  ],
  "start": {
    "html": "https://agents.a24labs.net/start/",
    "json": "https://agents.a24labs.net/start.json"
  },
  "families": [
    {
      "family": "xAI",
      "recipes": [
        "grokbot",
        "cursor"
      ]
    },
    {
      "family": "Anthropic",
      "recipes": [
        "claude-code",
        "claude-desktop"
      ]
    },
    {
      "family": "OpenAI",
      "recipes": [
        "chatgpt",
        "openai-codex-cli"
      ]
    },
    {
      "family": "Google",
      "recipes": [
        "gemini-cli",
        "google-ai-studio"
      ]
    },
    {
      "family": "AWP",
      "recipes": [
        "awp-cli",
        "awp-desktop"
      ]
    }
  ],
  "recipes": [
    {
      "id": "grokbot",
      "family": "xAI",
      "title": "GrokBot",
      "auth_method": "pat_swap",
      "origin": "local",
      "token_step": "PAT swap: exchange the PAT at the token endpoint and send the JWT as the Authorization header.",
      "availability": {
        "status": "available",
        "line": null
      },
      "verified": true,
      "badge": "Released",
      "version": null,
      "released_at": null,
      "summary": "Verified seed: add Edge as a remote MCP server with a Bearer JWT; first client proven end to end.",
      "html": "https://agents.a24labs.net/recipes/grokbot/",
      "json": "https://agents.a24labs.net/recipes/grokbot/recipe.json"
    },
    {
      "id": "cursor",
      "family": "xAI",
      "title": "Cursor",
      "auth_method": "pat_swap",
      "origin": "local",
      "token_step": "PAT swap: export the JWT before launching Cursor; mcp.json interpolates it with ${env:}. OAuth later.",
      "availability": {
        "status": "available",
        "line": null
      },
      "verified": false,
      "badge": "Beta",
      "version": null,
      "released_at": null,
      "summary": "Cursor mcp.json remote server with the Bearer header interpolated from the environment.",
      "html": "https://agents.a24labs.net/recipes/cursor/",
      "json": "https://agents.a24labs.net/recipes/cursor/recipe.json"
    },
    {
      "id": "claude-code",
      "family": "Anthropic",
      "title": "Claude Code",
      "auth_method": "pat_swap",
      "origin": "local",
      "token_step": "PAT swap through Claude Code's headersHelper, which runs the token script on every connect. OAuth later.",
      "availability": {
        "status": "available",
        "line": null
      },
      "verified": false,
      "badge": "Beta",
      "version": null,
      "released_at": null,
      "summary": "Remote HTTP MCP server in.mcp.json; a headersHelper script fetches a fresh JWT on every connect.",
      "html": "https://agents.a24labs.net/recipes/claude-code/",
      "json": "https://agents.a24labs.net/recipes/claude-code/recipe.json"
    },
    {
      "id": "claude-desktop",
      "family": "Anthropic",
      "title": "Claude Desktop",
      "auth_method": "oauth",
      "origin": "vendor_cloud",
      "token_step": "OAuth sign-in bound to a PAT record: Front Door issues a JWT with the same claims as the PAT exchange.",
      "availability": {
        "status": "not_yet_available",
        "line": "Not yet available on PROD."
      },
      "verified": false,
      "badge": "not yet available",
      "version": null,
      "released_at": null,
      "summary": "Remote MCP connector with OAuth sign-in bound to a PAT record. An interim local bridge (unverified) is on the page.",
      "html": "https://agents.a24labs.net/recipes/claude-desktop/",
      "json": "https://agents.a24labs.net/recipes/claude-desktop/recipe.json"
    },
    {
      "id": "chatgpt",
      "family": "OpenAI",
      "title": "ChatGPT",
      "auth_method": "oauth",
      "origin": "vendor_cloud",
      "token_step": "OAuth sign-in bound to a PAT record: Front Door issues a JWT with the same claims as the PAT exchange.",
      "availability": {
        "status": "not_yet_available",
        "line": "Not yet available on PROD."
      },
      "verified": false,
      "badge": "not yet available",
      "version": null,
      "released_at": null,
      "summary": "Remote MCP connector from ChatGPT's cloud with OAuth sign-in bound to a PAT record.",
      "html": "https://agents.a24labs.net/recipes/chatgpt/",
      "json": "https://agents.a24labs.net/recipes/chatgpt/recipe.json"
    },
    {
      "id": "openai-codex-cli",
      "family": "OpenAI",
      "title": "Codex CLI",
      "auth_method": "pat_swap",
      "origin": "local",
      "token_step": "PAT swap through Codex's http_headers_helper, which runs the token script on connect and again after a 401.",
      "availability": {
        "status": "available",
        "line": null
      },
      "verified": false,
      "badge": "Beta",
      "version": null,
      "released_at": null,
      "summary": "Codex CLI streamable-HTTP MCP server; an http_headers_helper script fetches a fresh JWT.",
      "html": "https://agents.a24labs.net/recipes/openai-codex-cli/",
      "json": "https://agents.a24labs.net/recipes/openai-codex-cli/recipe.json"
    },
    {
      "id": "gemini-cli",
      "family": "Google",
      "title": "Gemini CLI",
      "auth_method": "pat_swap",
      "origin": "local",
      "token_step": "PAT swap: export the JWT before starting Gemini CLI; settings.json reads it from the environment. OAuth later.",
      "availability": {
        "status": "available",
        "line": null
      },
      "verified": false,
      "badge": "Beta",
      "version": null,
      "released_at": null,
      "summary": "Gemini CLI settings.json HTTP MCP server with the Bearer header taken from the environment.",
      "html": "https://agents.a24labs.net/recipes/gemini-cli/",
      "json": "https://agents.a24labs.net/recipes/gemini-cli/recipe.json"
    },
    {
      "id": "google-ai-studio",
      "family": "Google",
      "title": "AI Studio",
      "auth_method": "oauth",
      "origin": "vendor_cloud",
      "token_step": "OAuth sign-in bound to a PAT record: Front Door issues a JWT with the same claims as the PAT exchange.",
      "availability": {
        "status": "not_yet_available",
        "line": "Not yet available on PROD."
      },
      "verified": false,
      "badge": "not yet available",
      "version": null,
      "released_at": null,
      "summary": "Remote MCP from Google AI Studio's cloud with OAuth sign-in bound to a PAT record.",
      "html": "https://agents.a24labs.net/recipes/google-ai-studio/",
      "json": "https://agents.a24labs.net/recipes/google-ai-studio/recipe.json"
    },
    {
      "id": "awp-cli",
      "family": "AWP",
      "title": "awp CLI",
      "auth_method": "pat_swap",
      "origin": "local",
      "token_step": "PAT swap built into the CLI: `awp auth exchange` reads the PAT file and exchanges it itself; no token script.",
      "availability": {
        "status": "not_yet_available",
        "line": "Not yet available on PROD."
      },
      "verified": false,
      "badge": "not yet available",
      "version": null,
      "released_at": null,
      "summary": "AWP's own command-line client, with the PAT exchange built in.",
      "html": "https://agents.a24labs.net/recipes/awp-cli/",
      "json": "https://agents.a24labs.net/recipes/awp-cli/recipe.json"
    },
    {
      "id": "awp-desktop",
      "family": "AWP",
      "title": "AWP Desktop",
      "auth_method": "pat_swap",
      "origin": "local",
      "token_step": "PAT swap inside the app: paste your edge-mcp PAT once and AWP Desktop swaps it for a JWT.",
      "availability": {
        "status": "not_yet_available",
        "line": "Not yet available on PROD."
      },
      "verified": false,
      "badge": "not yet available",
      "version": null,
      "released_at": null,
      "summary": "AWP's desktop client (based on Rakazo, Apache-2.0): paste your edge-mcp PAT once, swaps it for a JWT, and reaches Edge over Path #1. Full mode runs the Rakazo stack with an AWP EEG connector; thin \"AWP twins\" mode talks to twin_* / ih_* with no Docker.",
      "html": "https://agents.a24labs.net/recipes/awp-desktop/",
      "json": "https://agents.a24labs.net/recipes/awp-desktop/recipe.json"
    }
  ],
  "tools": {
    "html": "https://agents.a24labs.net/tools/",
    "json": "https://agents.a24labs.net/catalog.json",
    "count": 5
  },
  "llms_txt": "https://agents.a24labs.net/llms.txt"
}
