概述

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`

How it works

Send a GraphQL query (no credential).
Server returns 402 Payment Required with WWW-Authenticate: Payment ... challenges.
Client solves one challenge and retries with Authorization: Payment .
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	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

Links

Website: www.codex.io
Documentation: docs.codex.io
Get an API key: dashboard.codex.io/signup

版本历史

共 2 个版本

v1.0.1 当前

2026-06-11 17:55
v1.0.0

2026-05-07 07:22 安全安全

安全检测

腾讯云安全 (Keen)

队列中

腾讯云安全 (Sanbu)

队列中

Codex Agentic Gateway

概述