SkillsAdd

codex-data/skills

codex-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 queries, not mutations or subscriptions.

First seen Mar 18, 2026

Installation

$ npx skills add codex-data/skills --skill codex-gateway
View on skills.sh ↗ GitHub repository ↗

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

azure-aigateway Similar name
microsoft/azure-skills

Configure Azure API Management as an AI Gateway for AI models, MCP tools, and agents. WHEN: sem…

566.3K installs
connecting-lambda-to-api-gateway Similar name
aws/agent-toolkit-for-aws

Connects an existing AWS Lambda function to Amazon API Gateway by creating a REST or HTTP API w…

4.9K installs
creating-api-gateway-stage Similar name
aws/agent-toolkit-for-aws

Creates an API Gateway stage with CloudWatch logging, X-Ray tracing, throttling, WAF integratio…

4.7K installs
neon-ai-gateway Similar name
neondatabase/agent-skills

>- One API and one credential for frontier and open-source LLMs, built into your Neon branch an…

4.1K installs
transitgateway Similar name
aws/agent-toolkit-for-aws

Configures AWS Transit Gateway: creating a hub and attaching VPCs, segmenting traffic with rout…

2.5K installs
okx-onchain-gateway Similar name
okx/onchainos-skills

Onchain transaction gateway across XLayer, Solana, Ethereum, Base, BSC, Arbitrum, Polygon and 2…

9K installs

Also in this package

Other skills from codex-data/skills.

npx skills add codex-data/skills
codex-supergraph 337 agent-payments 7

Browse all from codex-data/skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

License MIT
Default branch main
Open issues 0
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version1.0
Declared agents codex
More metadata
author
codex-data
version
1.0

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,560 B
  • docs SUMMARY.md 216 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 308 installs

SKILL.md

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. For higher volume, get an API key at dashboard.codex.io/signup — see docs.codex.io for details.
HTTP endpoint https://graph.codex.io/graphql
Credential header Authorization: Payment <base64url-credential>

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 <credential>.
  4. Server returns GraphQL data + Payment-Receipt header.

Constraints

  • Query only. Mutations and subscriptions return 403 in 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 query operations.
  • Before constructing any query, read 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](../codex-supergraph/references/query-templates.md) GraphQL query schema and examples — read before constructing queries
[../codex-supergraph/references/gotchas.md](../codex-supergraph/references/gotchas.md) Common query failure points
[references/gotchas.md](references/gotchas.md) MPP-specific failure points
[rules/wallets.md](rules/wallets.md) Wallet setup: tempo wallet/request (Tempo)
[references/mpp-flow.md](references/mpp-flow.md) Auth matrix, challenge details, error codes

Links