Codex Agentic Gateway
by @nealo
Use when the user wants to query the Codex Supergraph and the server returns a 402 challenge. Pays per query via the MPP 402 challenge flow. Only supports qu...
clawhub install codex-gatewayπ About This Skill
name: codex-gateway description: >- Use when the user wants to query the Codex Supergraph and the server returns a 402 challenge. Pays per query via the MPP 402 challenge flow. Only supports queries, not mutations or subscriptions. metadata: author: codex-data version: "1.0"
Codex Machine Payment Protocol (MPP)
Use this skill when the Codex Supergraph returns a 402 Payment Required response. The MPP challenge flow lets you pay per query without needing an API key.
| | |
| --------------------- | --------------------------------------------------------------- |
| HTTP endpoint | https://graph.codex.io/graphql |
| Credential header | Authorization: Payment |
How it works
1. Send a GraphQL query (no credential).
2. Server returns 402 Payment Required with WWW-Authenticate: Payment ... challenges.
3. Client solves one challenge and retries with Authorization: Payment .
4. Server returns GraphQL data + Payment-Receipt header.
Constraints
403 in MPP mode.Rules
query operations.references/query-templates.md below for the correct GraphQL schema. Do not guess query or field names.References
| File | Purpose | | ---- | ------- | | ../codex-supergraph/references/query-templates.md | GraphQL query schema and examples β read before constructing queries | | ../codex-supergraph/references/gotchas.md | Common query failure points | | references/gotchas.md | MPP-specific failure points | | rules/wallets.md | Wallet setup: tempo wallet/request (Tempo) | | references/mpp-flow.md | Auth matrix, challenge details, error codes |
π Constraints
403 in MPP mode.