Skip to main content
The Codex skill gives your AI coding agent structured knowledge of the Codex GraphQL API — operations, auth patterns, query templates, and best practices — so it can write valid, runnable queries without searching docs first. 
https://github.com/company-z/codex-dashboard/tree/main/skills/codex-supergraph

​
Skill vs MCP

The Codex Docs MCP lets your AI search the documentation. The skill gives it direct knowledge of the API surface so it can generate queries immediately.
Codex SkillCodex Docs MCP
How it worksPreloaded API knowledge — operations, auth, templatesSearches docs on demand via MCP protocol
Best forGenerating runnable queries fastLooking up specific fields, types, or guides
Needs network?No — works offlineYes — queries the MCP server
Use both together for the best experience: the skill handles query generation and the MCP fills in details when needed.

​
What’s included

The skill packages everything an AI agent needs to work with the Codex API:
  • Operation map — Which query, mutation, or subscription to use for each task (pricing, charting, token discovery, events, wallets, holders, launchpads)
  • Auth patterns — API key, bearer token, and MPP payment flows with header formats
  • Query templates — Ready-to-use GraphQL for common operations like filterTokens, getTokenPrices, getBars, and WebSocket subscriptions
  • Endpoint playbook — Decision guide for choosing the right operation based on intent
  • Session preflight — Required getNetworks call to validate network IDs before making requests

​
Setup

Clone the skill into your project:
git clone https://github.com/company-z/codex-dashboard.git /tmp/codex-dashboard
cp -r /tmp/codex-dashboard/skills/codex-supergraph .claude/skills/codex-supergraph
rm -rf /tmp/codex-dashboard
Claude Code will automatically pick up skills from the .claude/skills/ directory.

​
How it works

Once installed, your AI agent uses the skill to:
  1. Pick the right operation — Maps intent (e.g. “get trending tokens”) to the correct GraphQL query (filterTokens)
  2. Set the correct auth — Chooses between API key headers and MPP payment flow based on context
  3. Generate valid GraphQL — Uses templates to produce runnable queries with proper variables and selection sets
  4. Follow best practices — Validates network IDs first, keeps selection sets minimal, batches subscriptions

​
Example

Ask your agent:
“Get the top 10 trending tokens on Solana with prices and volume.”
The skill guides it to generate: 
query {
  filterTokens(
    filters: { network: [1399811149] }
    rankings: { attribute: trendingScore24, direction: DESC }
    limit: 10
  ) {
    results {
      token {
        info {
          address
          name
          symbol
        }
      }
      priceUSD
      volume24
    }
  }
}
Run it with: 
curl -sS https://graph.codex.io/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: $CODEX_API_KEY" \
  -d '{"query": "..."}'
Or via MPP without an API key — the skill knows both auth paths. The skill covers the full Codex API surface — queries, mutations, and subscriptions across token discovery, pricing, charts, events, wallets, launchpads, and more. See the GraphQL Reference for all available operations.
Pair both the skill and the Codex Docs MCP for the best results. The skill gives your agent fast query generation, while the MCP provides access to the full docs when it needs to look up specific fields or types.