Start here (no script)

Everything an agent needs to connect to the AWP Edge MCP server in production, as plain HTML with no scripts. Use this page if your fetcher blocks scripts or raw JSON documents.

1. Discovery

The MCP endpoint is https://edge.a24labs.net/mcp. A request without a token gets 401 pointing at the Protected Resource Metadata. The documents, in order:

  1. MCP endpoint: https://edge.a24labs.net/mcp
    POST without a token returns 401 with WWW-Authenticate: Bearer resource_metadata="https://edge.a24labs.net/.well-known/oauth-protected-resource" (MCP authorization spec).
  2. Protected Resource Metadata: https://edge.a24labs.net/.well-known/oauth-protected-resource
    RFC 9728: the MCP resource and its authorization server.
  3. Authorization server metadata: https://id.a24labs.net/realms/a24labs/.well-known/openid-configuration
    Issuer, token and JWKS endpoints.
  4. AWP auth discovery: https://edge.a24labs.net/discovery/v1/authentication
    The PAT exchange (mint) block: token endpoint, grant type, required claims.
  5. Edge bootstrap: https://edge.a24labs.net/.well-known/awp-eeg
    Gateway identity and links.

2. Token (PAT exchange)

Ask your operator for an AWP PAT, then exchange it at the token endpoint for a Bearer JWT. POST the PAT to https://frontdoor.a24labs.net/v1/oauth/token as JSON with grant_type = urn:awp:params:oauth:grant-type:pat and the PAT in secret. The response's access_token is a Bearer JWT valid for 15 minutes. The PAT is never the MCP bearer, and it never goes in chat.

~/.config/awp/awp-edge-token.sh
#!/bin/bash
# awp-edge-token.sh — exchange an AWP PAT for a 15-minute Edge JWT. Prints the JWT only.
# The PAT is read from a mode-600 file and sent on stdin, so it never appears in argv or history.
set -euo pipefail
PAT_FILE="${AWP_PAT_FILE:-$HOME/.config/awp/edge.pat}"
printf '{"grant_type":"urn:awp:params:oauth:grant-type:pat","secret":"%s"}' "$(cat "$PAT_FILE")" |
  curl -sS --fail-with-body -X POST "https://frontdoor.a24labs.net/v1/oauth/token" \
    -H 'content-type: application/json' --data-binary @- |
  python3 -c 'import json,sys; print(json.load(sys.stdin)["access_token"])'

3. MCP

Send Authorization: Bearer <JWT> to https://edge.a24labs.net/mcp (Streamable HTTP). Call whoami where it is listed to confirm the principal and twin workspace.

Cards by family

One card per runtime; the card id is the runtime name the dashboard records.

xAI

GrokBot

FamilyxAI
Auth methodpat_swap (origin local)
Token stepPAT swap: exchange the PAT at the token endpoint and send the JWT as the Authorization header.
StatusAvailable
Recipehttps://agents.a24labs.net/recipes/grokbot/ · recipe.json
MCP URLhttps://edge.a24labs.net/mcp
PRM URLhttps://edge.a24labs.net/.well-known/oauth-protected-resource
Token endpointhttps://frontdoor.a24labs.net/v1/oauth/token

Cursor

FamilyxAI
Auth methodpat_swap (origin local)
Token stepPAT swap: export the JWT before launching Cursor; mcp.json interpolates it with ${env:}. OAuth later.
StatusAvailable
Recipehttps://agents.a24labs.net/recipes/cursor/ · recipe.json
MCP URLhttps://edge.a24labs.net/mcp
PRM URLhttps://edge.a24labs.net/.well-known/oauth-protected-resource
Token endpointhttps://frontdoor.a24labs.net/v1/oauth/token

Anthropic

Claude Code

FamilyAnthropic
Auth methodpat_swap (origin local)
Token stepPAT swap through Claude Code's headersHelper, which runs the token script on every connect. OAuth later.
StatusAvailable
Recipehttps://agents.a24labs.net/recipes/claude-code/ · recipe.json
MCP URLhttps://edge.a24labs.net/mcp
PRM URLhttps://edge.a24labs.net/.well-known/oauth-protected-resource
Token endpointhttps://frontdoor.a24labs.net/v1/oauth/token

Claude Desktop

FamilyAnthropic
Auth methodoauth (origin vendor_cloud)
Token stepOAuth sign-in bound to a PAT record: Front Door issues a JWT with the same claims as the PAT exchange.
StatusNot yet available on PROD.
Recipehttps://agents.a24labs.net/recipes/claude-desktop/ · recipe.json
MCP URLhttps://edge.a24labs.net/mcp
PRM URLhttps://edge.a24labs.net/.well-known/oauth-protected-resource
Token endpointhttps://frontdoor.a24labs.net/v1/oauth/token

OpenAI

ChatGPT

FamilyOpenAI
Auth methodoauth (origin vendor_cloud)
Token stepOAuth sign-in bound to a PAT record: Front Door issues a JWT with the same claims as the PAT exchange.
StatusNot yet available on PROD.
Recipehttps://agents.a24labs.net/recipes/chatgpt/ · recipe.json
MCP URLhttps://edge.a24labs.net/mcp
PRM URLhttps://edge.a24labs.net/.well-known/oauth-protected-resource
Token endpointhttps://frontdoor.a24labs.net/v1/oauth/token

Codex CLI

FamilyOpenAI
Auth methodpat_swap (origin local)
Token stepPAT swap through Codex's http_headers_helper, which runs the token script on connect and again after a 401.
StatusAvailable
Recipehttps://agents.a24labs.net/recipes/openai-codex-cli/ · recipe.json
MCP URLhttps://edge.a24labs.net/mcp
PRM URLhttps://edge.a24labs.net/.well-known/oauth-protected-resource
Token endpointhttps://frontdoor.a24labs.net/v1/oauth/token

Google

Gemini CLI

FamilyGoogle
Auth methodpat_swap (origin local)
Token stepPAT swap: export the JWT before starting Gemini CLI; settings.json reads it from the environment. OAuth later.
StatusAvailable
Recipehttps://agents.a24labs.net/recipes/gemini-cli/ · recipe.json
MCP URLhttps://edge.a24labs.net/mcp
PRM URLhttps://edge.a24labs.net/.well-known/oauth-protected-resource
Token endpointhttps://frontdoor.a24labs.net/v1/oauth/token

AI Studio

FamilyGoogle
Auth methodoauth (origin vendor_cloud)
Token stepOAuth sign-in bound to a PAT record: Front Door issues a JWT with the same claims as the PAT exchange.
StatusNot yet available on PROD.
Recipehttps://agents.a24labs.net/recipes/google-ai-studio/ · recipe.json
MCP URLhttps://edge.a24labs.net/mcp
PRM URLhttps://edge.a24labs.net/.well-known/oauth-protected-resource
Token endpointhttps://frontdoor.a24labs.net/v1/oauth/token

AWP

awp CLI

FamilyAWP
Auth methodpat_swap (origin local)
Token stepPAT swap built into the CLI: awp auth exchange reads the PAT file and exchanges it itself; no token script.
StatusNot yet available on PROD.
Recipehttps://agents.a24labs.net/recipes/awp-cli/ · recipe.json
MCP URLhttps://edge.a24labs.net/mcp
PRM URLhttps://edge.a24labs.net/.well-known/oauth-protected-resource
Token endpointhttps://frontdoor.a24labs.net/v1/oauth/token

AWP Desktop

FamilyAWP
Auth methodpat_swap (origin local)
Token stepPAT swap inside the app: paste your edge-mcp PAT once and AWP Desktop swaps it for a JWT.
StatusNot yet available on PROD.
Recipehttps://agents.a24labs.net/recipes/awp-desktop/ · recipe.json
MCP URLhttps://edge.a24labs.net/mcp
PRM URLhttps://edge.a24labs.net/.well-known/oauth-protected-resource
Token endpointhttps://frontdoor.a24labs.net/v1/oauth/token

Machine-readable: /start.json · /llms.txt · /recipes.json · /catalog.json · No-script start page: /start/