kukapay/okx-announcements-mcp

OKX Announcements MCP

An MCP server that streams the latest OKX exchange announcements directly to AI agents.

Features

• 5 dedicated tools with clear, structured output
• Built-in prompt /okx_announcements for natural interaction
• Works with any MCP client that supports stdio transport

Installation

Prerequisites:

• Node.js ≥ 18
• Internet access

1. Clone the Repository:

   git clone https://github.com/kukapay/okx-announcements-mcp.git
   cd okx-announcements-mcp
   

2. Install Dependencies:

   npm install
   

3. Configure MCP Client: To use this server with an MCP client like Claude Desktop, add the following to your config file (or equivalent):

   {
     "mcpServers": {
       "OKX Announcements": {
         "command": "node",
         "args": ["/path/to/okx-announcements-mcp/index.js"]
       }
     }
   }   
   

   Replace /path/to/okx-announcements-mcp with your actual installation path.

Tools & Prompts

1. get_latest – All recent announcements (mixed)

Example Prompt:

“What are the latest announcements from OKX?”

Output (text + structured):

Latest 10 OKX announcements:

• [2025-12-05] OKX to list Virtuals Protocol (VIRTUAL) for spot trading
  https://www.okx.com/help/okx-to-list-virtuals-protocol-virtual-for-spot-trading
• [2025-12-04] Completion of X Layer Mainnet Upgrade
  https://www.okx.com/help/completion-of-x-layer-mainnet-upgrade
• [2025-12-04] New On-chain Earn: Stake ETH and earn 8% APY
  https://www.okx.com/help/new-on-chain-earn-eth-8-apy
...

2. get_new_listings – New token & contract listings

Example Prompt:

“Any new coins listed on OKX this week?”

Output:

Found 8 recent new listing announcement(s).

• VIRTUAL (Virtuals Protocol) – Spot trading starts Dec 6, 2025
• BTC & ETH perpetual contracts margin tier update
• New listing: Tensor (TNSR) – Trading begins Dec 4, 2025
...

3. get_delistings – Tokens being removed or suspended

Example Prompt:

“Is OKX delisting anything soon?”

Output:

Found 3 recent delisting/suspension announcement(s).

• Delisting of XYZ, ABC, and DEF tokens – Effective Dec 15, 2025
• Trading suspension for 5 low-volume trading pairs
• Risk warning: Project failed to meet listing requirements

4. get_earn – Staking, savings, and Earn promotions

Example Prompt:

“What are the current high-yield Earn offers on OKX?”

Output:

Found 12 recent Earn/Staking announcement(s).

• New On-chain Earn: Stake SOL and earn up to 12% APY (limited slots)
• Simple Earn Flexible: USDT now offering 5% APY
• Double Yield Event: Stake BTC & ETH together for bonus rewards

5. get_jumpstart – Token sales & launchpad events

Example Prompt:

“When is the next OKX Jumpstart?”

Output:

Found 2 recent Jumpstart announcement(s).

• Jumpstart: BitTensor (TAO) – Staking OKB to participate starts Dec 8
• Upcoming Jumpstart mining project announcement coming soon

Bonus: Built-in Prompt

In clients that support prompts (Cursor, Claude Desktop, etc.), just type:

/okx_announcements category:listings count:10

→ Instantly gets the 10 latest new listings with full titles and links.

License

MIT License. See the file for details.