Agent Shaniu (SHANIU)

io.github.m284743Published by GitHub account m284743v1.0.0Updated Oct 24, 2026

First AI-driven community meme coin on BSC. Mint, trade and referral tools for AI agents.

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

MCP server for the SHANIU meme coin on BNB Smart Chain: read stats, prepare unsigned mint and order-book trade transactions, and handle referral bindings.

What you can do
Read token supply, claim pool remaining, claim count, live claim fee, and optionally a wallet's balance and claimed status. Prepare an unsigned claim() mint transaction; the wallet must hold a Binance Agent ID and each address can claim once. List fillable sell orders from the on-chain order book and prepare buy transactions with exact BNB cost, filling one or several orders in a single transaction. Prepare the two-step listing flow: approve the market contract, then list an amount at a price. Read referral program stats globally or per inviter, and register a referral binding.
When to use it
Use it when a user wants to acquire, trade or list SHANIU, a meme coin on BNB Smart Chain, or manage referral bindings. It only prepares unsigned transactions, so it suits workflows where the user signs and broadcasts with their own wallet.
Requirements
Remote endpoint at over streamable HTTP. The README also documents a local npm install run with Node.js over stdio, with an optional BSC_RPC environment variable for the BNB Chain RPC. Minting requires a wallet holding a Binance Agent ID; signing and broadcasting happen in the user's own wallet.
Before you install
Every prepare tool returns an unsigned transaction that the user must sign and broadcast, spending real BNB and trading tokens. Minting charges the live claim fee and pays a block-hash lottery with uncertain results. Listing and buying write on-chain state, and invite_register records a referral binding; the server's instructions ask for user consent first. Verify contract addresses and network before use.

Installation

In SourceWeft

  1. Open Agent Shaniu (SHANIU) in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.m284743%2Fshaniu/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "agent-shaniu-shaniu": {
      "type": "http",
      "url": "https://bn.shaniu.ai/mcp"
    }
  }
}

README

shaniu-mcp

MCP server for Agent Shaniu (SHANIU) — the first AI-driven community meme coin on BNB Smart Chain (chainId 56).

Tools

ToolTypeWhat it does
shaniu_statsreadSupply, pool remaining, claim count, live claim fee (BNB/USD oracle), optional wallet balance / claimed status
shaniu_prepare_claimtx-prepUnsigned claim() mint tx {to, data, valueWei}. Caller must hold a Binance Agent ID; one claim per address; block-hash lottery reward (50–150 typical, up to 21,000; last claim sweeps the pool)
shaniu_market_ordersreadFillable sell orders, cheapest first (id, maker, remaining, price)
shaniu_prepare_buytx-prepUnsigned buy / cart buyMany tx with exact BNB cost computed from on-chain prices
shaniu_prepare_listtx-prepTwo-step sell: approve + list(amount, priceWei)
shaniu_invite_statsreadReferral program stats (global or per-address)
shaniu_invite_registerwriteRegister referral intent (pre-claim) or bind by claim tx hash

prepare tools never sign anything — they return transaction intents for the user's own wallet to sign and broadcast.

Install

bash
npm installnode server.js        # stdio transport

Environment: BSC_RPC (optional, defaults to https://bsc-dataseed.bnbchain.org).

Claude Desktop / Kimi / Cursor config

json
{  "mcpServers": {    "shaniu": {      "command": "node",      "args": ["/absolute/path/to/shaniu-mcp/server.js"]    }  }}

Agent Skill (one-command install for AI agents)

Any agent runtime that supports the Skills ecosystem (Claude Code, OpenClaw, Codex, Cursor, ...) can learn SHANIU in one command:

bash
npx skills add m284743/shaniu/skill

The skill teaches the agent how to claim (mint), trade on the order book, and handle referrals via the Binance Agentic Wallet (baw) — preview first, user confirms in the Binance App, keys never leave the wallet.

Referral quick reference

  • Invite link: https://bn.shaniu.ai/?ref=<INVITER_ADDRESS>
  • Reward per invited claim: 10 / 50 / 200 / 1,000 SHANIU (90% / 8% / 1.8% / 0.2%), budget 210,000 SHANIU
  • Register before the invitee claims: shaniu_invite_register(inviter, invitee)

Community

Source: README.md at commit 5f06505

Tools

7

shaniu_stats

Live SHANIU stats: total supply, claim pool remaining, claim count, current claim fee (wei of BNB, ~0.2 USD via Chainlink oracle), whether claiming is open, and optionally a wallet's balance / claimed status.

Parametersaddress

shaniu_prepare_claim

Prepare an unsigned claim() (mint) transaction. Caller wallet must hold a Binance Agent ID (.ai); one claim per address; reward is a block-hash lottery (50-150 typical, up to 21,000; last claim sweeps the pool). Returns {to, data, valueWei} to sign with the user's wallet.

Parametersaddressrequired

shaniu_market_orders

List currently fillable sell orders on the on-chain order book, cheapest first. Each order: id, maker, remainingSHANIU, priceBNBperToken. No AMM pool exists — buying fills these orders atomically.

Parameterslimit

shaniu_prepare_buy

Prepare an unsigned buy transaction that fills one or more sell orders. Computes exact BNB cost. Single order uses the market contract; multiple orders use the cart contract (buyMany) in one tx.

Parametersfillsrequired

shaniu_prepare_list

Prepare unsigned transactions to list SHANIU for sale: (1) approve the market contract, (2) list(amount, priceWei). The tokens stay in the seller's wallet until filled — the market is authorization-based, no custody.

ParametersamountSHANIUrequiredpriceBNBperTokenrequired

shaniu_invite_stats

Referral program stats: global slots/budget usage, and (with address) one inviter's bound count, earned and pending SHANIU. Invite link format: https://bn.shaniu.ai/?ref=<address>

Parametersaddress

shaniu_invite_register

Register a referral binding. Prefer mode=intent BEFORE the invitee calls claim(); or bind after the fact with the invitee's claim tx hash. Always ask your user for consent first. Rewards (10/50/200/1000 SHANIU tiers) roll automatically and are paid in batches.

ParametersclaimTxinviteerequiredinviterrequired

Version history

1
  1. v1.0.0LatestOct 24, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts