Agent skill

Okx MCP Skill

by holon-run in holon-run/uxc

Use OKX OnchainOS MCP through UXC for token discovery, market data, wallet balance, and swap execution planning.

MITAuto-check passedAgent Workflows

Install Okx MCP Skill

skills CLI
$ npx skills add holon-run/uxc --skill okx-mcp-skill -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install holon-run/uxc okx-mcp-skill --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/holon-run/uxc.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/okx-mcp-skill .claude/skills/okx-mcp-skill && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
okx-mcp-skill
GitHub stars
116
Token cost
~1.1k tokens
SKILL.md length
377 words
Files
4 (incl. scripts, references)
Skills in repo
62
Repo updated
First seen
Licence
MIT

At a glance

Use OKX OnchainOS MCP through UXC for token discovery, market data, wallet balance, and swap execution planning.

  • Works in 5 steps: Confirm endpoint and protocol with… → Configure credential/binding for… → Use fixed link command by default → …
  • Tasks need OKX MCP tools such as token search/ranking/holder
  • SKILL.md covers Prerequisites, Quick Trial Key, Core Workflow and Capability Map, plus 3 more sections
  • Runs Shell scripts from its folder; reaches web3.okx.com; needs OKX_ACCESS_KEY

What it does

Okx MCP Skill is an agent skill from holon-run/uxc. Use OKX OnchainOS MCP through UXC for token discovery, market data, wallet balance, and swap execution planning. Use when tasks need OKX MCP tools such as token search/ranking/holder, price/trades/candlesticks/index, balance queries, and DEX quote/swap flows with help-first schema inspection and safe auth handling.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/usage-patterns.md` and `scripts/validate.sh`).

It sits in Agent Workflows, covering MCP servers and Stock and market analysis. It works with OKX and Model Context Protocol. The repository describes itself as: A unified CLI for discovering and invoking tools across OpenAPI, MCP, GraphQL, gRPC, and JSON-RPC. The licence is MIT.

When your agent uses it

  • Tasks need OKX MCP tools such as token search/ranking/holder
  • Price/trades/candlesticks/index
  • Balance queries
  • DEX quote/swap flows with help-first schema inspection and safe auth handling

Example prompts

  • “/okx-mcp-skill”

Requirements

  • A Bash shell
  • A credential in OKX_ACCESS_KEY

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Confirm endpoint and protocol with help-first probing
  2. Configure credential/binding for repeatable auth
  3. Use fixed link command by default
  4. Inspect operation schema before execution
  5. Prefer read operations first, then high-impact operations.

What it can do on your machine

Read from SKILL.md and the folder at commit 562d47c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Shell), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • web3.okx.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • OKX_ACCESS_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Okx MCP Skill loads about 1.1k tokens when it runs, and up to ~1.9k if it reads all its reference files. Until then it costs about 83 tokens; SKILL.md has 377 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~83
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from holon-run/uxc at commit 562d47c, republished under its MIT licence (© holon-run). 377 words, ~1,136 tokens.

Download SKILL.mdSave it as .claude/skills/okx-mcp-skill/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
okx-mcp-skill
description
Use OKX OnchainOS MCP through UXC for token discovery, market data, wallet balance, and swap execution planning. Use when tasks need OKX MCP tools such as token search/ranking/holder, price/trades/candlesticks/index, balance queries, and DEX quote/swap flows with help-first schema inspection and safe auth handling.

OKX MCP Skill

Use this skill to run OKX MCP operations through uxc.

Reuse the uxc skill for shared protocol discovery, output parsing, and generic auth/binding flows.

Prerequisites

  • uxc is installed and available in PATH.
  • Network access to https://web3.okx.com/api/v1/onchainos-mcp.
  • OKX Onchain API key is available for real calls.

Quick Trial Key

For quick read-only trial, OKX docs currently expose a shared demo key:

  • d573a84c-8e79-4a35-b0c6-427e9ad2478d

Example:

  • uxc auth credential set okx-mcp --auth-type api_key --api-key-header OK-ACCESS-KEY --secret d573a84c-8e79-4a35-b0c6-427e9ad2478d

Use your own key for regular usage, stability, and production workflows.

Core Workflow

  1. Confirm endpoint and protocol with help-first probing:
    • uxc https://web3.okx.com/api/v1/onchainos-mcp -h
  2. Configure credential/binding for repeatable auth:
    • uxc auth credential set okx-mcp --auth-type api_key --api-key-header OK-ACCESS-KEY --secret-env OKX_ACCESS_KEY
    • uxc auth credential set okx-mcp --auth-type api_key --api-key-header OK-ACCESS-KEY --secret-op op://Engineering/okx/OK-ACCESS-KEY
    • uxc auth binding add --id okx-mcp --host web3.okx.com --path-prefix /api/v1/onchainos-mcp --scheme https --credential okx-mcp --priority 100
  3. Use fixed link command by default:
    • command -v okx-mcp-cli
    • If missing, create it: uxc link okx-mcp-cli https://web3.okx.com/api/v1/onchainos-mcp
    • okx-mcp-cli -h
  4. Inspect operation schema before execution:
    • okx-mcp-cli dex-okx-market-price -h
    • okx-mcp-cli dex-okx-market-token-search -h
    • okx-mcp-cli dex-okx-balance-total-value -h
    • okx-mcp-cli dex-okx-dex-quote -h
  5. Prefer read operations first, then high-impact operations.

Capability Map

  • Market:
    • dex-okx-market-price
    • dex-okx-market-trades
    • dex-okx-market-candlesticks
    • dex-okx-market-candlesticks-history
    • dex-okx-index-current-price
    • dex-okx-index-historical-price
  • Token discovery/enrichment:
    • dex-okx-market-token-search
    • dex-okx-market-token-ranking
    • dex-okx-market-token-holder
    • dex-okx-market-token-basic-info
    • dex-okx-market-token-price-info
  • Wallet:
    • dex-okx-balance-chains
    • dex-okx-balance-total-value
    • dex-okx-balance-total-token-balances
    • dex-okx-balance-specific-token-balance
  • Swap:
    • dex-okx-dex-aggregator-supported-chains
    • dex-okx-dex-liquidity
    • dex-okx-dex-quote
    • dex-okx-dex-approve-transaction
    • dex-okx-dex-swap
    • dex-okx-dex-solana-swap-instruction
Show full SKILL.md (159 more words)Show less

ChainIndex Quick Reference

  • Ethereum: 1
  • BSC: 56
  • XLayer: 196
  • Solana: 501
  • Base: 8453
  • Arbitrum: 42161

Always prefer runtime discovery (dex-okx-market-price-chains / dex-okx-dex-aggregator-supported-chains / dex-okx-balance-chains) when possible.

Guardrails

  • Keep automation on JSON output envelope; do not rely on --text.
  • Parse stable fields first: ok, kind, protocol, data, error.
  • Use okx-mcp-cli as default command path.
  • okx-mcp-cli <operation> ... is equivalent to uxc https://web3.okx.com/api/v1/onchainos-mcp <operation> ....
  • If call result contains Request header OK-ACCESS-KEY can not be empty:
    • confirm auth binding matches endpoint with uxc auth binding match https://web3.okx.com/api/v1/onchainos-mcp
    • update credential with explicit header: uxc auth credential set okx-mcp --auth-type api_key --api-key-header OK-ACCESS-KEY --secret-env OKX_ACCESS_KEY
    • confirm credential has a secret source (--secret-env, --secret-op, or literal --secret)
  • For high-impact operations require explicit user confirmation:
    • dex-okx-dex-approve-transaction
    • dex-okx-dex-swap
    • dex-okx-dex-solana-swap-instruction
  • Solana caveat from OKX docs:
    • for market candles/trades, use wSOL token address So11111111111111111111111111111111111111112
    • for some price contexts, SOL system address 11111111111111111111111111111111 may also appear in docs
    • when data is empty on Solana, verify operation-level address expectation first.

References

  • Invocation patterns:
    • references/usage-patterns.md

© holon-run, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts, references) in skills/okx-mcp-skill of holon-run/uxc.

  • SKILL.md
  • agents/openai.yaml
  • references/usage-patterns.md
  • scripts/validate.sh

Open the folder on GitHubat commit 562d47c

Compare with similar skills

Okx MCP Skill next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Okx MCP Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Okx MCP Skill this skillholon-run/uxc116—~1.1kAutomated safety check: PassMIT
Okx Sentiment Trackerdex-original/okx-agent-trade-kit1101 repos~3.8kAutomated safety check: PassMIT
Portfolio Managertradermonty/claude-trading-skills3k5 repos~6.5kAutomated safety check: PassMIT
Polymarket Tennislivetennisapi/livetennisapi-mcp152—~3kAutomated safety check: PassMIT
Openbb Data Fetchermonarchjuno/vibe-investing299—~2.9kAutomated safety check: NotesMIT
Gate Exchange CrossexLeoYeAI/openclaw-master-skills2.2k—~5.6kAutomated safety check: PassMIT

Similar skills

  • Okx Sentiment Tracker

    dex-original/okx-agent-trade-kit

    A skill your agent uses when the user asks about: 'any crypto news', 'latest news', 'market update', 'daily briefing', 'BTC news', 'ETH news', 'news on SOL', 'search SEC ETF', 'regulation news'…

    110 GitHub starsUsed in 1 repo~3.8k tokens
    Business, Finance & HRAuto-check passed
  • Portfolio Manager

    tradermonty/claude-trading-skills

    Comprehensive portfolio analysis using Alpaca MCP Server integration to fetch holdings and positions, then analyze asset allocation, risk metrics, individual stock positions, diversification, and…

    3k GitHub starsUsed in 5 repos~6.5k tokens
    Agent WorkflowsAuto-check passed
  • Polymarket Tennis

    livetennisapi/livetennisapi-mcp

    Build observe-only Polymarket and Kalshi tennis market tooling on the polymarket-tennis Python package (MIT) plus the Live Tennis API free tier.

    152 GitHub stars~3k tokensUpdated 4 days ago
    Business, Finance & HRAuto-check passed
  • Openbb Data Fetcher

    monarchjuno/vibe-investing

    Fetch financial, market, economic, fundamental, news, options, crypto, ETF, index, and macro data through the OpenBB Python interface instead of the OpenBB MCP server.

    299 GitHub stars~2.9k tokensUpdated 5 mo ago
    Data & AnalyticsAuto-check: notes
  • Gate Exchange Crossex

    LeoYeAI/openclaw-master-skills

    A skill your agent uses for Gate CrossEx cross-exchange operations: order placement, transfer, convert, and order/position/history queries across Gate, Binance, OKX and Bybit.

    2.2k GitHub stars~5.6k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Code Review

    imbenrabi/Financial-Modeling-Prep-MCP-Server

    Review a PR or working diff against this repo's intent layer (the AGENTS.md hierarchy), toolception pitfalls, and core invariants.

    150 GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed

More from holon-run/uxc

All 62 skills in this repo
  • Context7 MCP Skill

    holon-run/uxc

    Query up-to-date library documentation and code examples using Context7 MCP.

    116 GitHub stars~564 tokensUpdated 26 days ago
    Auto-check passed
  • Deepwiki MCP Skill

    holon-run/uxc

    Ask questions and read documentation about any GitHub repository using DeepWiki MCP.

    116 GitHub stars~700 tokensUpdated 26 days ago
    Auto-check passed
  • Operate Linear workspace issues, projects, and teams through Linear GraphQL API using UXC.

    116 GitHub stars~1.8k tokensUpdated 26 days ago
    Auto-check passed
  • Operate Notion Public API through UXC with a curated OpenAPI schema for search, block traversal, page reads, content writes, and data source/database inspection.

    116 GitHub stars~2.3k tokensUpdated 26 days ago
    Auto-check passed
  • Operate Alchemy Prices API reads through UXC with a curated OpenAPI schema, path-templated API-key auth, and read-first guardrails.

    116 GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed
  • Uxc

    holon-run/uxc

    Discover and call remote schema-exposed interfaces with UXC.

    116 GitHub stars~1.8k tokensUpdated 26 days ago
    Auto-check passed

Questions about Okx MCP Skill

What does Okx MCP Skill do?

Use OKX OnchainOS MCP through UXC for token discovery, market data, wallet balance, and swap execution planning. Okx MCP Skill is an agent skill from holon-run/uxc. Use OKX OnchainOS MCP through UXC for token discovery, market data, wallet balance, and swap execution planning.

When should I use Okx MCP Skill?

Okx MCP Skill fits situations like: tasks need OKX MCP tools such as token search/ranking/holder; price/trades/candlesticks/index; balance queries; DEX quote/swap flows with help-first schema inspection and safe auth handling.

How do I install Okx MCP Skill in Claude Code?

Run `npx skills add holon-run/uxc --skill okx-mcp-skill -a claude-code`. Or copy the skill folder (skills/okx-mcp-skill in holon-run/uxc) into .claude/skills/okx-mcp-skill in your project. Claude Code loads it when a task matches its description.

How do I install Okx MCP Skill in Codex?

Run `npx skills add holon-run/uxc --skill okx-mcp-skill -a codex`. Or copy the skill folder (skills/okx-mcp-skill in holon-run/uxc) into .agents/skills/okx-mcp-skill in your project. Codex loads it when a task matches its description.

Can I use Okx MCP Skill in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add holon-run/uxc --skill okx-mcp-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/okx-mcp-skill, .gemini/skills/okx-mcp-skill, .github/skills/okx-mcp-skill and .opencode/skills/okx-mcp-skill in your project.

What does Okx MCP Skill need to run?

Going by SKILL.md and its folder, Okx MCP Skill needs a shell for the scripts in its folder and credentials named OKX_ACCESS_KEY. Our summary lists: A Bash shell; A credential in OKX_ACCESS_KEY.

Does Okx MCP Skill access the network?

SKILL.md names 1 domain. In commands or code: web3.okx.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Okx MCP Skill safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Okx MCP Skill use?

Okx MCP Skill is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Okx MCP Skill use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 813 tokens, read only when the agent opens those files.

What are the alternatives to Okx MCP Skill?

Skills that share tags, products or a category with Okx MCP Skill: Okx Sentiment Tracker (dex-original/okx-agent-trade-kit, 110 stars), Portfolio Manager (tradermonty/claude-trading-skills, 3k stars), Polymarket Tennis (livetennisapi/livetennisapi-mcp, 152 stars) and Openbb Data Fetcher (monarchjuno/vibe-investing, 299 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Okx MCP Skill?

holon-run (a GitHub organization) maintains it in holon-run/uxc, which has 116 GitHub stars. The repository holds 62 skills in this directory. The repository was last updated on September 15, 2026.

Source: holon-run/uxc on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.