{
  "environment": "production",
  "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
      },
      "environment": "production",
      "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.",
      "client": "GrokBot (AddMcpServer)",
      "html": "https://agents.a24labs.net/recipes/grokbot/",
      "json": "https://agents.a24labs.net/recipes/grokbot/recipe.json",
      "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"
      },
      "steps": [
        {
          "title": "Get a PAT",
          "body": "Ask your operator for an AWP PAT, then exchange it at the token endpoint for a Bearer JWT. Save it to `~/.config/awp/edge.pat` with mode 600. Never paste it into chat or commit it."
        },
        {
          "title": "Install the token script",
          "body": "Save as `~/.config/awp/awp-edge-token.sh` (chmod 700). It prints a Bearer JWT valid for 15 minutes."
        },
        {
          "title": "Configure GrokBot (AddMcpServer)",
          "body": "Add the config below."
        },
        {
          "title": "Load the token",
          "body": "Run `awp-edge-token.sh` and paste the JWT into the connector's Authorization header through a secure channel. It expires after 15 minutes; re-run and update the header when calls start returning 401."
        },
        {
          "title": "Get your twin connected",
          "body": "Paste the prompts below into the agent, in order."
        }
      ],
      "config": [
        {
          "title": "AddMcpServer",
          "path": "GrokBot connector settings",
          "lang": "json",
          "body": "{\n \"name\": \"awp-edge\",\n \"url\": \"https://edge.a24labs.net/mcp\",\n \"headers\": { \"Authorization\": \"Bearer <JWT from awp-edge-token.sh>\" }\n}"
        }
      ],
      "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\"])'",
      "token_response_example": "{\n  \"access_token\": \"<JWT>\",\n  \"token_type\": \"Bearer\",\n  \"expires_in\": 900,\n  \"scope\": \"...\"\n}",
      "prompts": [
        {
          "prompt": "List the tools the awp-edge MCP server exposes.",
          "expect": "5 tools on this Edge (fewer if your PAT lacks a capability)."
        },
        {
          "tool": "discovery",
          "prompt": "Call the awp-edge tool discovery with limit 5 and list the resource ids it returns.",
          "expect": "Up to five resources labelled STORE (evidence.source=awp-store)."
        },
        {
          "tool": "workspace_search",
          "prompt": "Call workspace_search with query \"agents hub\" and limit 5.",
          "expect": "Up to five STORE results."
        },
        {
          "tool": "project_query",
          "prompt": "Call project_query with {\"id\": \"<project-id>\"}. Use id only; free-text query is unsupported.",
          "expect": "One project, or a clear bad-args error if you pass query."
        }
      ],
      "oauth": {
        "note": "For clients that support OAuth sign-in instead of a static header.",
        "authorization_server": "https://id.a24labs.net/realms/a24labs",
        "client_id": "awp-edge-mcp-oauth",
        "pkce": "S256"
      }
    },
    {
      "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
      },
      "environment": "production",
      "verified": false,
      "badge": "Beta",
      "version": null,
      "released_at": null,
      "summary": "Cursor mcp.json remote server with the Bearer header interpolated from the environment.",
      "client": "Cursor",
      "html": "https://agents.a24labs.net/recipes/cursor/",
      "json": "https://agents.a24labs.net/recipes/cursor/recipe.json",
      "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"
      },
      "steps": [
        {
          "title": "Get a PAT",
          "body": "Ask your operator for an AWP PAT, then exchange it at the token endpoint for a Bearer JWT. Save it to `~/.config/awp/edge.pat` with mode 600. Never paste it into chat or commit it."
        },
        {
          "title": "Install the token script",
          "body": "Save as `~/.config/awp/awp-edge-token.sh` (chmod 700). It prints a Bearer JWT valid for 15 minutes."
        },
        {
          "title": "Configure Cursor",
          "body": "Add the config below."
        },
        {
          "title": "Load the token",
          "body": "Cursor reads ${env:AWP_EDGE_JWT} from the environment it was launched from. Re-export and relaunch after 15 minutes."
        },
        {
          "title": "Get your twin connected",
          "body": "Paste the prompts below into the agent, in order."
        }
      ],
      "config": [
        {
          "title": "Cursor MCP config",
          "path": "~/.cursor/mcp.json",
          "lang": "json",
          "body": "{\n \"mcpServers\": {\n \"awp-edge\": {\n \"url\": \"https://edge.a24labs.net/mcp\",\n \"headers\": { \"Authorization\": \"Bearer ${env:AWP_EDGE_JWT}\" }\n }\n }\n}"
        },
        {
          "title": "Start Cursor with a fresh token",
          "path": "shell",
          "lang": "bash",
          "body": "export AWP_EDGE_JWT=\"$(~/.config/awp/awp-edge-token.sh)\"\ncursor."
        }
      ],
      "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\"])'",
      "token_response_example": "{\n  \"access_token\": \"<JWT>\",\n  \"token_type\": \"Bearer\",\n  \"expires_in\": 900,\n  \"scope\": \"...\"\n}",
      "prompts": [
        {
          "prompt": "List the tools the awp-edge MCP server exposes.",
          "expect": "5 tools on this Edge (fewer if your PAT lacks a capability)."
        },
        {
          "tool": "discovery",
          "prompt": "Call the awp-edge tool discovery with limit 5 and list the resource ids it returns.",
          "expect": "Up to five resources labelled STORE (evidence.source=awp-store)."
        },
        {
          "tool": "workspace_search",
          "prompt": "Call workspace_search with query \"agents hub\" and limit 5.",
          "expect": "Up to five STORE results."
        },
        {
          "tool": "project_query",
          "prompt": "Call project_query with {\"id\": \"<project-id>\"}. Use id only; free-text query is unsupported.",
          "expect": "One project, or a clear bad-args error if you pass query."
        }
      ],
      "oauth": {
        "note": "For clients that support OAuth sign-in instead of a static header.",
        "authorization_server": "https://id.a24labs.net/realms/a24labs",
        "client_id": "awp-edge-mcp-oauth",
        "pkce": "S256"
      }
    },
    {
      "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
      },
      "environment": "production",
      "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.",
      "client": "Claude Code (CLI)",
      "html": "https://agents.a24labs.net/recipes/claude-code/",
      "json": "https://agents.a24labs.net/recipes/claude-code/recipe.json",
      "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"
      },
      "steps": [
        {
          "title": "Get a PAT",
          "body": "Ask your operator for an AWP PAT, then exchange it at the token endpoint for a Bearer JWT. Save it to `~/.config/awp/edge.pat` with mode 600. Never paste it into chat or commit it."
        },
        {
          "title": "Install the token script",
          "body": "Save as `~/.config/awp/awp-edge-token.sh` (chmod 700). It prints a Bearer JWT valid for 15 minutes."
        },
        {
          "title": "Configure Claude Code (CLI)",
          "body": "Add the config below."
        },
        {
          "title": "Load the token",
          "body": "The headers helper runs the token script each time Claude Code connects, so the 15-minute JWT never sits in a config file. Run `/mcp` in Claude Code to reconnect after it expires."
        },
        {
          "title": "Get your twin connected",
          "body": "Paste the prompts below into the agent, in order."
        }
      ],
      "config": [
        {
          "title": "Headers helper",
          "path": "~/.config/awp/edge-headers.sh (chmod 700)",
          "lang": "bash",
          "body": "#!/bin/bash\n# Prints the Authorization header as JSON for Claude Code's headersHelper.\nprintf '{\"Authorization\":\"Bearer %s\"}\\n' \"$(\"$HOME/.config/awp/awp-edge-token.sh\")\""
        },
        {
          "title": "Project MCP config",
          "path": ".mcp.json (project root)",
          "lang": "json",
          "body": "{\n \"mcpServers\": {\n \"awp-edge\": {\n \"type\": \"http\",\n \"url\": \"https://edge.a24labs.net/mcp\",\n \"headersHelper\": \"~/.config/awp/edge-headers.sh\"\n }\n }\n}"
        },
        {
          "title": "One-off alternative (token expires in 15 min)",
          "path": "shell",
          "lang": "bash",
          "body": "claude mcp add --transport http awp-edge https://edge.a24labs.net/mcp \\\n --header \"Authorization: Bearer $(~/.config/awp/awp-edge-token.sh)\""
        }
      ],
      "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\"])'",
      "token_response_example": "{\n  \"access_token\": \"<JWT>\",\n  \"token_type\": \"Bearer\",\n  \"expires_in\": 900,\n  \"scope\": \"...\"\n}",
      "prompts": [
        {
          "prompt": "List the tools the awp-edge MCP server exposes.",
          "expect": "5 tools on this Edge (fewer if your PAT lacks a capability)."
        },
        {
          "tool": "discovery",
          "prompt": "Call the awp-edge tool discovery with limit 5 and list the resource ids it returns.",
          "expect": "Up to five resources labelled STORE (evidence.source=awp-store)."
        },
        {
          "tool": "workspace_search",
          "prompt": "Call workspace_search with query \"agents hub\" and limit 5.",
          "expect": "Up to five STORE results."
        },
        {
          "tool": "project_query",
          "prompt": "Call project_query with {\"id\": \"<project-id>\"}. Use id only; free-text query is unsupported.",
          "expect": "One project, or a clear bad-args error if you pass query."
        }
      ],
      "oauth": {
        "note": "For clients that support OAuth sign-in instead of a static header.",
        "authorization_server": "https://id.a24labs.net/realms/a24labs",
        "client_id": "awp-edge-mcp-oauth",
        "pkce": "S256"
      }
    },
    {
      "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."
      },
      "environment": "production",
      "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.",
      "client": "Claude Desktop",
      "html": "https://agents.a24labs.net/recipes/claude-desktop/",
      "json": "https://agents.a24labs.net/recipes/claude-desktop/recipe.json",
      "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"
      },
      "planned_flow": [
        "Add `https://edge.a24labs.net/mcp` as a remote MCP connector in Claude Desktop.",
        "Claude follows the `401` challenge to the Protected Resource Metadata and the authorization server.",
        "You sign in through Front Door (authorization code + PKCE) and pick the PAT record the connection is bound to.",
        "Front Door issues a JWT with the same claims as the PAT exchange: one twin workspace, its capabilities, no org_admin. Revoking the PAT ends access."
      ],
      "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\"])'",
      "token_response_example": "{\n  \"access_token\": \"<JWT>\",\n  \"token_type\": \"Bearer\",\n  \"expires_in\": 900,\n  \"scope\": \"...\"\n}",
      "interim": {
        "title": "Interim: local mcp-remote bridge",
        "summary": "A local workaround, not this card's flow: Claude Desktop starts mcp-remote on your machine, which carries a PAT-swap JWT to Edge. It uses the PAT exchange, so it works before OAuth sign-in is available. Beta until EEG, like the other Beta cards.",
        "config": [
          {
            "title": "Desktop config",
            "path": "~/Library/Application Support/Claude/claude_desktop_config.json",
            "lang": "json",
            "body": "{\n \"mcpServers\": {\n \"awp-edge\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"mcp-remote\", \"https://edge.a24labs.net/mcp\", \"--header\", \"Authorization:${AWP_EDGE_AUTH}\"],\n \"env\": { \"AWP_EDGE_AUTH\": \"Bearer <JWT from awp-edge-token.sh>\" }\n }\n }\n}"
          }
        ],
        "load_token": "Paste a fresh JWT into AWP_EDGE_AUTH and restart Claude Desktop. The JWT lasts 15 minutes, so this suits short sessions; Claude Code's headers helper is the better fit for long ones.",
        "notes": [
          "Write `Authorization:${AWP_EDGE_AUTH}` with no space after the colon; the value carries the space after `Bearer`."
        ]
      },
      "prompts": [
        {
          "prompt": "List the tools the awp-edge MCP server exposes.",
          "expect": "5 tools on this Edge (fewer if your PAT lacks a capability)."
        },
        {
          "tool": "discovery",
          "prompt": "Call the awp-edge tool discovery with limit 5 and list the resource ids it returns.",
          "expect": "Up to five resources labelled STORE (evidence.source=awp-store)."
        },
        {
          "tool": "workspace_search",
          "prompt": "Call workspace_search with query \"agents hub\" and limit 5.",
          "expect": "Up to five STORE results."
        },
        {
          "tool": "project_query",
          "prompt": "Call project_query with {\"id\": \"<project-id>\"}. Use id only; free-text query is unsupported.",
          "expect": "One project, or a clear bad-args error if you pass query."
        }
      ]
    },
    {
      "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."
      },
      "environment": "production",
      "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.",
      "client": "ChatGPT",
      "html": "https://agents.a24labs.net/recipes/chatgpt/",
      "json": "https://agents.a24labs.net/recipes/chatgpt/recipe.json",
      "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"
      },
      "planned_flow": [
        "Add `https://edge.a24labs.net/mcp` as a remote MCP connector in ChatGPT.",
        "ChatGPT follows the `401` challenge to the Protected Resource Metadata and the authorization server.",
        "You sign in through Front Door (authorization code + PKCE) and pick the PAT record the connection is bound to.",
        "Front Door issues a JWT with the same claims as the PAT exchange: one twin workspace, its capabilities, no org_admin. Revoking the PAT ends access."
      ],
      "prompts": [
        {
          "prompt": "List the tools the awp-edge MCP server exposes.",
          "expect": "5 tools on this Edge (fewer if your PAT lacks a capability)."
        },
        {
          "tool": "discovery",
          "prompt": "Call the awp-edge tool discovery with limit 5 and list the resource ids it returns.",
          "expect": "Up to five resources labelled STORE (evidence.source=awp-store)."
        },
        {
          "tool": "workspace_search",
          "prompt": "Call workspace_search with query \"agents hub\" and limit 5.",
          "expect": "Up to five STORE results."
        },
        {
          "tool": "project_query",
          "prompt": "Call project_query with {\"id\": \"<project-id>\"}. Use id only; free-text query is unsupported.",
          "expect": "One project, or a clear bad-args error if you pass query."
        }
      ]
    },
    {
      "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
      },
      "environment": "production",
      "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.",
      "client": "OpenAI Codex CLI",
      "html": "https://agents.a24labs.net/recipes/openai-codex-cli/",
      "json": "https://agents.a24labs.net/recipes/openai-codex-cli/recipe.json",
      "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"
      },
      "steps": [
        {
          "title": "Get a PAT",
          "body": "Ask your operator for an AWP PAT, then exchange it at the token endpoint for a Bearer JWT. Save it to `~/.config/awp/edge.pat` with mode 600. Never paste it into chat or commit it."
        },
        {
          "title": "Install the token script",
          "body": "Save as `~/.config/awp/awp-edge-token.sh` (chmod 700). It prints a Bearer JWT valid for 15 minutes."
        },
        {
          "title": "Configure OpenAI Codex CLI",
          "body": "Add the config below."
        },
        {
          "title": "Load the token",
          "body": "Codex runs the helper (through `sh -c`, with HOME and PATH) when it connects and again when Edge answers 401 or 403, so the 15-minute JWT is renewed without a restart. Use one method: an explicit bearer token takes precedence over the helper's Authorization header."
        },
        {
          "title": "Get your twin connected",
          "body": "Paste the prompts below into the agent, in order."
        }
      ],
      "config": [
        {
          "title": "Headers helper",
          "path": "~/.config/awp/edge-headers.sh (chmod 700)",
          "lang": "bash",
          "body": "#!/bin/bash\n# Prints the Authorization header as JSON for Codex's http_headers_helper.\nprintf '{\"Authorization\":\"Bearer %s\"}\\n' \"$(\"$HOME/.config/awp/awp-edge-token.sh\")\""
        },
        {
          "title": "Codex config",
          "path": "~/.codex/config.toml",
          "lang": "toml",
          "body": "[mcp_servers.awp-edge]\nurl = \"https://edge.a24labs.net/mcp\"\nhttp_headers_helper = \"~/.config/awp/edge-headers.sh\""
        },
        {
          "title": "Alternative: token from the environment (expires in 15 min)",
          "path": "~/.codex/config.toml + shell",
          "lang": "bash",
          "body": "# config.toml: replace http_headers_helper with\n# bearer_token_env_var = \"AWP_EDGE_JWT\"\nexport AWP_EDGE_JWT=\"$(~/.config/awp/awp-edge-token.sh)\"\ncodex"
        }
      ],
      "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\"])'",
      "token_response_example": "{\n  \"access_token\": \"<JWT>\",\n  \"token_type\": \"Bearer\",\n  \"expires_in\": 900,\n  \"scope\": \"...\"\n}",
      "prompts": [
        {
          "prompt": "List the tools the awp-edge MCP server exposes.",
          "expect": "5 tools on this Edge (fewer if your PAT lacks a capability)."
        },
        {
          "tool": "discovery",
          "prompt": "Call the awp-edge tool discovery with limit 5 and list the resource ids it returns.",
          "expect": "Up to five resources labelled STORE (evidence.source=awp-store)."
        },
        {
          "tool": "workspace_search",
          "prompt": "Call workspace_search with query \"agents hub\" and limit 5.",
          "expect": "Up to five STORE results."
        },
        {
          "tool": "project_query",
          "prompt": "Call project_query with {\"id\": \"<project-id>\"}. Use id only; free-text query is unsupported.",
          "expect": "One project, or a clear bad-args error if you pass query."
        }
      ],
      "oauth": {
        "note": "For clients that support OAuth sign-in instead of a static header.",
        "authorization_server": "https://id.a24labs.net/realms/a24labs",
        "client_id": "awp-edge-mcp-oauth",
        "pkce": "S256"
      }
    },
    {
      "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
      },
      "environment": "production",
      "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.",
      "client": "Gemini CLI",
      "html": "https://agents.a24labs.net/recipes/gemini-cli/",
      "json": "https://agents.a24labs.net/recipes/gemini-cli/recipe.json",
      "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"
      },
      "steps": [
        {
          "title": "Get a PAT",
          "body": "Ask your operator for an AWP PAT, then exchange it at the token endpoint for a Bearer JWT. Save it to `~/.config/awp/edge.pat` with mode 600. Never paste it into chat or commit it."
        },
        {
          "title": "Install the token script",
          "body": "Save as `~/.config/awp/awp-edge-token.sh` (chmod 700). It prints a Bearer JWT valid for 15 minutes."
        },
        {
          "title": "Configure Gemini CLI",
          "body": "Add the config below."
        },
        {
          "title": "Load the token",
          "body": "Gemini CLI resolves $AWP_EDGE_JWT when it loads settings.json. Re-export and restart after 15 minutes."
        },
        {
          "title": "Get your twin connected",
          "body": "Paste the prompts below into the agent, in order."
        }
      ],
      "config": [
        {
          "title": "Gemini settings",
          "path": "~/.gemini/settings.json",
          "lang": "json",
          "body": "{\n \"mcpServers\": {\n \"awp-edge\": {\n \"httpUrl\": \"https://edge.a24labs.net/mcp\",\n \"headers\": { \"Authorization\": \"Bearer $AWP_EDGE_JWT\" }\n }\n }\n}"
        },
        {
          "title": "Start Gemini with a fresh token",
          "path": "shell",
          "lang": "bash",
          "body": "export AWP_EDGE_JWT=\"$(~/.config/awp/awp-edge-token.sh)\"\ngemini"
        }
      ],
      "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\"])'",
      "token_response_example": "{\n  \"access_token\": \"<JWT>\",\n  \"token_type\": \"Bearer\",\n  \"expires_in\": 900,\n  \"scope\": \"...\"\n}",
      "prompts": [
        {
          "prompt": "List the tools the awp-edge MCP server exposes.",
          "expect": "5 tools on this Edge (fewer if your PAT lacks a capability)."
        },
        {
          "tool": "discovery",
          "prompt": "Call the awp-edge tool discovery with limit 5 and list the resource ids it returns.",
          "expect": "Up to five resources labelled STORE (evidence.source=awp-store)."
        },
        {
          "tool": "workspace_search",
          "prompt": "Call workspace_search with query \"agents hub\" and limit 5.",
          "expect": "Up to five STORE results."
        },
        {
          "tool": "project_query",
          "prompt": "Call project_query with {\"id\": \"<project-id>\"}. Use id only; free-text query is unsupported.",
          "expect": "One project, or a clear bad-args error if you pass query."
        }
      ],
      "oauth": {
        "note": "For clients that support OAuth sign-in instead of a static header.",
        "authorization_server": "https://id.a24labs.net/realms/a24labs",
        "client_id": "awp-edge-mcp-oauth",
        "pkce": "S256"
      }
    },
    {
      "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."
      },
      "environment": "production",
      "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.",
      "client": "Google AI Studio",
      "html": "https://agents.a24labs.net/recipes/google-ai-studio/",
      "json": "https://agents.a24labs.net/recipes/google-ai-studio/recipe.json",
      "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"
      },
      "planned_flow": [
        "Add `https://edge.a24labs.net/mcp` as a remote MCP server in Google AI Studio.",
        "AI Studio follows the `401` challenge to the Protected Resource Metadata and the authorization server.",
        "You sign in through Front Door (authorization code + PKCE) and pick the PAT record the connection is bound to.",
        "Front Door issues a JWT with the same claims as the PAT exchange: one twin workspace, its capabilities, no org_admin. Revoking the PAT ends access."
      ],
      "prompts": [
        {
          "prompt": "List the tools the awp-edge MCP server exposes.",
          "expect": "5 tools on this Edge (fewer if your PAT lacks a capability)."
        },
        {
          "tool": "discovery",
          "prompt": "Call the awp-edge tool discovery with limit 5 and list the resource ids it returns.",
          "expect": "Up to five resources labelled STORE (evidence.source=awp-store)."
        },
        {
          "tool": "workspace_search",
          "prompt": "Call workspace_search with query \"agents hub\" and limit 5.",
          "expect": "Up to five STORE results."
        },
        {
          "tool": "project_query",
          "prompt": "Call project_query with {\"id\": \"<project-id>\"}. Use id only; free-text query is unsupported.",
          "expect": "One project, or a clear bad-args error if you pass query."
        }
      ]
    },
    {
      "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."
      },
      "environment": "production",
      "verified": false,
      "badge": "not yet available",
      "version": null,
      "released_at": null,
      "summary": "AWP's own command-line client, with the PAT exchange built in.",
      "client": "awp CLI 0.3.0",
      "html": "https://agents.a24labs.net/recipes/awp-cli/",
      "json": "https://agents.a24labs.net/recipes/awp-cli/recipe.json",
      "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"
      },
      "planned_flow": [
        "Download awp 0.3.0 from `https://downloads.a24labs.net/awp/awp-v0.3.0/` and check it against the SHA-256 pins on this page.",
        "`awp --env prod auth exchange` reads your PAT from `~/.config/awp/edge.pat` and exchanges it at `https://frontdoor.a24labs.net/v1/oauth/token`. PROD Edge uses a public certificate, so no CA bundle is needed.",
        "`awp --env prod auth header --json` prints the Authorization header for Claude Code's headersHelper or Codex's http_headers_helper.",
        "Until then, use the token script with the Claude Code or Codex CLI card."
      ],
      "prompts": [
        {
          "prompt": "List the tools the awp-edge MCP server exposes.",
          "expect": "5 tools on this Edge (fewer if your PAT lacks a capability)."
        },
        {
          "tool": "discovery",
          "prompt": "Call the awp-edge tool discovery with limit 5 and list the resource ids it returns.",
          "expect": "Up to five resources labelled STORE (evidence.source=awp-store)."
        },
        {
          "tool": "workspace_search",
          "prompt": "Call workspace_search with query \"agents hub\" and limit 5.",
          "expect": "Up to five STORE results."
        },
        {
          "tool": "project_query",
          "prompt": "Call project_query with {\"id\": \"<project-id>\"}. Use id only; free-text query is unsupported.",
          "expect": "One project, or a clear bad-args error if you pass query."
        }
      ]
    },
    {
      "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."
      },
      "environment": "production",
      "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.",
      "client": "AWP Desktop",
      "html": "https://agents.a24labs.net/recipes/awp-desktop/",
      "json": "https://agents.a24labs.net/recipes/awp-desktop/recipe.json",
      "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"
      },
      "planned_flow": [
        "Download AWP Desktop from `https://downloads.a24labs.net/awp-desktop/` once it is published. Nothing is downloadable yet.",
        "Paste your edge-mcp PAT once; AWP Desktop swaps it for a JWT and reaches `https://edge.a24labs.net/mcp` 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."
      ],
      "prompts": [
        {
          "prompt": "List the tools the awp-edge MCP server exposes.",
          "expect": "5 tools on this Edge (fewer if your PAT lacks a capability)."
        },
        {
          "tool": "discovery",
          "prompt": "Call the awp-edge tool discovery with limit 5 and list the resource ids it returns.",
          "expect": "Up to five resources labelled STORE (evidence.source=awp-store)."
        },
        {
          "tool": "workspace_search",
          "prompt": "Call workspace_search with query \"agents hub\" and limit 5.",
          "expect": "Up to five STORE results."
        },
        {
          "tool": "project_query",
          "prompt": "Call project_query with {\"id\": \"<project-id>\"}. Use id only; free-text query is unsupported.",
          "expect": "One project, or a clear bad-args error if you pass query."
        }
      ]
    }
  ]
}
