Codex Agentic Gateway
/install codex-gateway
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 \x3Cbase64url-credential> |
How it works
- Send a GraphQL query (no credential).
- Server returns
402 Payment RequiredwithWWW-Authenticate: Payment ...challenges. - Client solves one challenge and retries with
Authorization: Payment \x3Ccredential>. - Server returns GraphQL data +
Payment-Receiptheader.
Constraints
- Query only. Mutations and subscriptions return
403in MPP mode. - If a valid API key or bearer token is also present, API auth takes precedence.
Rules
- Never print raw credentials.
- Only use MPP for
queryoperations. - Before constructing any query, read
references/query-templates.mdbelow 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 |
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install codex-gateway - After installation, invoke the skill by name or use
/codex-gateway - Provide required inputs per the skill's parameter spec and get structured output
What is Codex Agentic Gateway?
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... It is an AI Agent Skill for Claude Code / OpenClaw, with 115 downloads so far.
How do I install Codex Agentic Gateway?
Run "/install codex-gateway" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Codex Agentic Gateway free?
Yes, Codex Agentic Gateway is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Codex Agentic Gateway support?
Codex Agentic Gateway is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Codex Agentic Gateway?
It is built and maintained by Neal O'Grady (@nealo); the current version is v1.0.0.