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:
- MCP endpoint:
https://edge.a24labs.net/mcp
POST without a token returns401withWWW-Authenticate: Bearer resource_metadata="https://edge.a24labs.net/.well-known/oauth-protected-resource"(MCP authorization spec). - Protected Resource Metadata:
https://edge.a24labs.net/.well-known/oauth-protected-resource
RFC 9728: the MCP resource and its authorization server. - Authorization server metadata:
https://id.a24labs.net/realms/a24labs/.well-known/openid-configuration
Issuer, token and JWKS endpoints. - AWP auth discovery:
https://edge.a24labs.net/discovery/v1/authentication
The PAT exchange (mint) block: token endpoint, grant type, required claims. - 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.
#!/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
| Family | xAI |
|---|---|
| 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. |
| Status | Available |
| Recipe | https://agents.a24labs.net/recipes/grokbot/ · recipe.json |
| MCP URL | https://edge.a24labs.net/mcp |
| PRM URL | https://edge.a24labs.net/.well-known/oauth-protected-resource |
| Token endpoint | https://frontdoor.a24labs.net/v1/oauth/token |
Cursor
| Family | xAI |
|---|---|
| Auth method | pat_swap (origin local) |
| Token step | PAT swap: export the JWT before launching Cursor; mcp.json interpolates it with ${env:}. OAuth later. |
| Status | Available |
| Recipe | https://agents.a24labs.net/recipes/cursor/ · recipe.json |
| MCP URL | https://edge.a24labs.net/mcp |
| PRM URL | https://edge.a24labs.net/.well-known/oauth-protected-resource |
| Token endpoint | https://frontdoor.a24labs.net/v1/oauth/token |
Anthropic
Claude Code
| Family | Anthropic |
|---|---|
| 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. |
| Status | Available |
| Recipe | https://agents.a24labs.net/recipes/claude-code/ · recipe.json |
| MCP URL | https://edge.a24labs.net/mcp |
| PRM URL | https://edge.a24labs.net/.well-known/oauth-protected-resource |
| Token endpoint | https://frontdoor.a24labs.net/v1/oauth/token |
Claude Desktop
| Family | Anthropic |
|---|---|
| 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. |
| Status | Not yet available on PROD. |
| Recipe | https://agents.a24labs.net/recipes/claude-desktop/ · recipe.json |
| MCP URL | https://edge.a24labs.net/mcp |
| PRM URL | https://edge.a24labs.net/.well-known/oauth-protected-resource |
| Token endpoint | https://frontdoor.a24labs.net/v1/oauth/token |
OpenAI
ChatGPT
| Family | OpenAI |
|---|---|
| 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. |
| Status | Not yet available on PROD. |
| Recipe | https://agents.a24labs.net/recipes/chatgpt/ · recipe.json |
| MCP URL | https://edge.a24labs.net/mcp |
| PRM URL | https://edge.a24labs.net/.well-known/oauth-protected-resource |
| Token endpoint | https://frontdoor.a24labs.net/v1/oauth/token |
Codex CLI
| Family | OpenAI |
|---|---|
| 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. |
| Status | Available |
| Recipe | https://agents.a24labs.net/recipes/openai-codex-cli/ · recipe.json |
| MCP URL | https://edge.a24labs.net/mcp |
| PRM URL | https://edge.a24labs.net/.well-known/oauth-protected-resource |
| Token endpoint | https://frontdoor.a24labs.net/v1/oauth/token |
Gemini CLI
| Family | |
|---|---|
| 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. |
| Status | Available |
| Recipe | https://agents.a24labs.net/recipes/gemini-cli/ · recipe.json |
| MCP URL | https://edge.a24labs.net/mcp |
| PRM URL | https://edge.a24labs.net/.well-known/oauth-protected-resource |
| Token endpoint | https://frontdoor.a24labs.net/v1/oauth/token |
AI Studio
| Family | |
|---|---|
| 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. |
| Status | Not yet available on PROD. |
| Recipe | https://agents.a24labs.net/recipes/google-ai-studio/ · recipe.json |
| MCP URL | https://edge.a24labs.net/mcp |
| PRM URL | https://edge.a24labs.net/.well-known/oauth-protected-resource |
| Token endpoint | https://frontdoor.a24labs.net/v1/oauth/token |
AWP
awp CLI
| Family | AWP |
|---|---|
| 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. |
| Status | Not yet available on PROD. |
| Recipe | https://agents.a24labs.net/recipes/awp-cli/ · recipe.json |
| MCP URL | https://edge.a24labs.net/mcp |
| PRM URL | https://edge.a24labs.net/.well-known/oauth-protected-resource |
| Token endpoint | https://frontdoor.a24labs.net/v1/oauth/token |
AWP Desktop
| Family | AWP |
|---|---|
| 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. |
| Status | Not yet available on PROD. |
| Recipe | https://agents.a24labs.net/recipes/awp-desktop/ · recipe.json |
| MCP URL | https://edge.a24labs.net/mcp |
| PRM URL | https://edge.a24labs.net/.well-known/oauth-protected-resource |
| Token endpoint | https://frontdoor.a24labs.net/v1/oauth/token |
Machine-readable: /start.json · /llms.txt · /recipes.json · /catalog.json · No-script start page: /start/