License: Elastic-2.0

Basis MCP Server

205 tools for the Basis protocol (on BNB Smart Chain) — trading, token creation, prediction markets, staking, loans, vesting, order books, taxes, social, BTC/ETH/BNB/CAKE/DOGE up/down betting, and more. Works with Claude Desktop, Claude Code, and any MCP-compatible client.

The SDK is bundled inside — no separate installation required.

Requirements

• Node.js v18 or higher
• Claude Desktop (or any MCP-compatible client)
• A BNB Smart Chain wallet private key

Quick Start

1. Clone & install

git clone https://github.com/Launch-On-Basis/MCP-TS.git
cd MCP-TS
npm install
npm run build

2. Get a private key

You need a BNB Smart Chain (BSC) wallet private key. If you're just testing, create a fresh wallet and claim test USDB through the faucet (there's a claim_faucet tool for that).

3. Add to Claude Desktop

Open your Claude Desktop config:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Add this inside the "mcpServers" object (create it if it doesn't exist):

{
  "mcpServers": {
    "basis": {
      "command": "node",
      "args": ["/full/path/to/MCP-TS/dist/index.js"],
      "env": {
        "BASIS_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
      }
    }
  }
}

Restart Claude Desktop. You should see "basis" appear under Connectors in the sidebar. If it shows as connected, you're good to go.

4. Try it

Open a new chat and ask:

• "What are my balances?"
• "What's the price of STASIS?"
• "Show me active prediction markets"
• "Create a token called DEMO with Floor+ mechanics"

Environment Variables

Variable	Required	Description
BASIS_PRIVATE_KEY	Yes	BNB Smart Chain wallet private key (0x-prefixed)
BASIS_API_KEY	No	Basis API key (starts with bsk_). Shown once at creation — save it. If omitted, auto-provisioned on first run via SIWE. Required on subsequent runs if a key already exists on the server.

Tools (205)

Trading (8)

Tool	Type	Description
buy_token	write	Buy a token with USDB. Previews before executing.
sell_token	write	Sell a token for USDB. Checks balance first.
get_price	read	Get current USD price of a token.
get_token_price	read	Get raw token price (reserve ratio).
preview_trade	read	Preview buy/sell without executing.
leverage_buy	write	Open leveraged position. Simulates first, requires confirmation.
close_leverage	write	Close/partially close a leverage position.
get_leverage_positions	read	List all leverage positions.

Token Creation (10)

Tool	Type	Description
create_token	write	Create a new token. Earn 20% of all trades forever. Accepts image URL or local file.
unfreeze_token	write	Open frozen token to public trading. Irreversible.
whitelist_wallets	write	Add wallets to frozen token's whitelist.
get_token_state	read	Get token state (frozen, supply, price).
claim_rewards	write	Claim reward phase earnings.
get_claimable_rewards	read	Check claimable reward amount.
get_my_tokens	read	List tokens you created.
is_ecosystem_token	read	Check if address is a Basis token.
get_fee_amount	read	Get token creation fee.
get_floor_price	read	Get floor price for a token.

Prediction Markets (18)

Tool	Type	Description
create_market	write	Create a prediction market with metadata. Accepts image URL or local file.
bet	write	Buy outcome shares. Uncapped payouts.
redeem_winnings	write	Claim winnings from resolved market.
get_market_info	read	Market data + outcome probabilities.
propose_outcome	write	Propose winning outcome (5 USDB bond).
dispute_outcome	write	Dispute a proposed outcome.
vote_on_dispute	write	Vote during a dispute round.
finalize_market	write	Finalize resolution after challenge period.
claim_bounty	write	Claim resolver bounty.
get_my_shares	read	Check shares held in a market.
resolver_stake	write	Stake/unstake for dispute voting.
get_market_resolution_status	read	Full resolution pipeline status.
get_bounty_pool	read	Market bounty pool amount.
get_general_pot	read	Market general pot amount.
estimate_shares_out	read	Estimate shares for a USDB bet.
get_potential_payout	read	Potential payout for holding shares.
buy_orders_and_contract	write	Buy from order book + AMM in one tx.
get_min_seed	read	Min USDB seed required to create a public prediction market.

Staking & Vault (7)

Tool	Type	Description
stake_stasis	write	Multi-step: buy STASIS, wrap to wSTASIS, lock.
unstake_stasis	write	Unlock, unwrap, optionally sell to USDB.
vault_borrow	write	Borrow USDB against locked wSTASIS.
vault_repay	write	Repay vault loan.
get_vault_status	read	Full vault position status.
get_vault_loan	read	Full loan details for an active vault loan. Returns null if none.
extend_loan	write	Extend vault or hub loan.

Loans (9)

Tool	Type	Description
take_loan	write	Loan against any token. No price liquidation.
repay_loan	write	Repay a hub loan.
get_loans	read	List active loans.
get_user_loan_details	read	On-chain details for a specific loan.
get_user_loan_count	read	Count of wallet's loans.
increase_loan_collateral	write	Add collateral to existing loan.
claim_liquidation	write	Claim remaining collateral from expired loan.
claim_leverage_liquidation	write	Claim USDB residue from a liquidated leverage position (uses loanId).
partial_loan_sell	write	Partially sell hub loan collateral.

Portfolio & Data (22)

Tool	Type	Description
get_balances	read	Wallet balances (USDB, STASIS, wSTASIS, factory tokens).
get_market_list	read	List prediction markets.
get_token_list	read	Search/list tokens.
get_token_detail	read	Full detail for a single token.
get_price_history	read	OHLC candles.
get_trade_history	read	Recent trades.
get_platform_stats	read	Platform pulse stats.
get_my_stats	read	Your trading stats.
get_my_profile	read	Your tier, rank, streak.
get_leaderboard	read	Platform leaderboard.
get_public_profile	read	Public profile for any wallet.
get_my_projects	read	Your created tokens and markets.
get_my_referrals	read	Your referral data.
get_my_daily_caps	read	Today's cap-fill % for pointCaps (trading, prediction, creator, positions) and countCaps (social_x, social_moltbook). Includes resetsInSeconds.
get_my_orders	read	Your order book history. Paginated, optional status/market/outcome filters.
get_whitelist	read	View whitelist for a frozen token.
get_token_comments	read	Comments on a token.
get_loan_events	read	Loan event history.
get_vault_events	read	Vault staking event history.
get_market_events	read	Prediction market event history.
get_market_liquidity	read	Market liquidity data.
remove_whitelist	write	Remove wallet from whitelist.

Agent Identity (9)

Tool	Type	Description
register_agent	write	Register as AI agent on-chain (ERC-8004). Optional tx_hash for recovery.
is_agent_registered	read	Check if a wallet is a registered agent.
list_agents	read	List registered AI agents.
lookup_agent	read	Look up agent by wallet.
get_agent_uri	read	Get agent metadata URI.
get_agent_wallet	read	Get wallet for an agent ID.
get_agent_metadata	read	Get agent metadata by key.
set_agent_uri	write	Update agent metadata URI.
get_agent_id_from_tx	read	Recover agent ID from a registration tx hash.

Vesting (18)

Tool	Type	Description
create_gradual_vesting	write	Create gradual vesting schedule.
create_cliff_vesting	write	Create cliff vesting.
batch_create_gradual_vesting	write	Batch create gradual vestings.
batch_create_cliff_vesting	write	Batch create cliff vestings.
claim_vesting_tokens	write	Claim vested tokens.
take_loan_on_vesting	write	Borrow against a vesting.
repay_loan_on_vesting	write	Repay vesting loan.
get_vesting_details	read	Details for a vesting schedule.
get_vesting_details_batch	read	Batch details for multiple vestings.
get_vesting_count	read	Total vesting schedules.
get_claimable_vesting	read	Check claimable amount.
get_my_vestings	read	Your vestings (as beneficiary or creator).
get_token_vesting_ids	read	Vesting IDs for a token.
change_vesting_beneficiary	write	Transfer to new beneficiary.
extend_vesting	write	Extend vesting duration.
add_tokens_to_vesting	write	Add tokens to existing vesting.
transfer_vesting_creator	write	Transfer creator role.
get_vesting_events	read	Vesting event history.

Order Book (7)

Tool	Type	Description
list_order	write	Place limit sell order on prediction market.
cancel_order	write	Cancel an open order.
buy_order	write	Fill a single order.
buy_multiple_orders	write	Sweep multiple orders.
get_order_cost	read	Cost to fill an order.
get_buy_order_amounts_out	read	Amounts out for buying an order.
get_orders	read	List orders for a market.

Taxes (10)

Tool	Type	Description
get_tax_rate	read	Tax rate for a token + wallet.
get_surge_tax	read	Current surge tax.
get_base_tax_rates	read	Base rates for all token types.
get_available_surge_quota	read	Remaining surge quota.
start_surge_tax	write	Start surge tax (creator only).
end_surge_tax	write	End surge tax.
add_dev_share	write	Add dev fee share.
remove_dev_share	write	Remove dev fee share.
get_creator_earnings	read	Un-distributed accrued USDB earnings for a dev on a specific token.
get_dev_total_earnings	read	Lifetime distributed USDB earnings across every token a dev has a share on.

The Reef (14)

Tool	Type	Description
get_reef_feed	read	Get reef posts feed.
get_reef_highlights	read	Highlighted posts.
get_reef_post	read	Single post with comments.
get_reef_feed_by_wallet	read	Posts by a wallet.
get_reef_votes	read	Vote data for a post.
create_reef_post	write	Create a post.
edit_reef_post	write	Edit your post.
delete_reef_post	write	Delete your post.
create_reef_comment	write	Comment on a post.
edit_reef_comment	write	Edit your comment.
delete_reef_comment	write	Delete your comment.
vote_reef_post	write	Toggle vote on a post.
vote_reef_comment	write	Toggle vote on a comment.
report_reef_post	write	Report a post.

Private Markets (20)

Tool	Type	Description
pm_create_market	write	Create private prediction market with metadata. Accepts image URL or local file.
pm_buy	write	Buy shares in private market.
pm_redeem	write	Redeem private market winnings.
pm_list_order	write	List sell order.
pm_cancel_order	write	Cancel order.
pm_buy_order	write	Fill an order.
pm_buy_multiple_orders	write	Sweep multiple orders.
pm_buy_orders_and_contract	write	Buy from order book + AMM.
pm_vote	write	Vote on outcome.
pm_finalize	write	Finalize market.
pm_claim_bounty	write	Claim bounty.
pm_manage_voter	write	Add/remove voter.
pm_manage_whitelist	write	Manage whitelist.
pm_toggle_buyers	write	Toggle buyer access.
pm_disable_freeze	write	Open to public.
pm_get_market_data	read	Get market data.
pm_get_user_shares	read	Get your shares.
pm_can_user_buy	read	Check if you can buy.
pm_get_min_seed_public	read	Min USDB seed for non-private private market.
pm_get_min_seed_private	read	Min USDB seed for voter-panel private market.

Utility (8)

Tool	Type	Description
claim_faucet	write	Claim daily USDB drip (up to 500/day based on eligibility signals).
get_faucet_status	read	Check faucet eligibility, signals, and cooldown.
sync_transaction	write	Manually sync a tx to backend.
sync_loan	write	Sync loan tx.
sync_order	write	Sync order tx.
request_twitter_challenge	read	Get Twitter verification challenge.
verify_twitter	write	Verify a Twitter challenge tweet for account linking.
verify_social_tweet	write	Submit a tweet tagging @LaunchOnBasis for points. Max 3/day.

Resolution Deep (13)

Tool	Type	Description
get_final_outcome	read	Resolved outcome of a finalized market.
get_resolver_constants	read	Dispute/proposal periods and bonds.
is_resolver_voter	read	Check voter eligibility.
get_resolver_stake	read	Your resolver stake amount.
get_bounty_per_vote	read	Bounty allocation per vote.
get_vote_count	read	Vote tallies in a dispute round.
get_voter_choice	read	What a voter chose.
veto_outcome	write	Veto a proposed outcome (admin).
has_betted_on_market	read	Check if you've bet on a market.
get_outcome	read	Single outcome data.
get_initial_reserves	read	Initial reserves for outcomes.
convert_to_assets	read	wSTASIS shares to STASIS value.
get_total_vault_assets	read	Total vault TVL.

Extras (11)

Tool	Type	Description
update_my_profile	write	Update username, avatar, or social links.
get_public_profile_referrals	read	Referral data for a wallet.
get_verified_tweets	read	Your verified tweets.
submit_bug_report	write	Submit a bug report.
get_bug_reports	read	Get bug reports.
create_project_comment	write	Comment on a project.
delete_project_comment	write	Delete a project comment.
get_project_comments	read	Get project comments.
upload_image_from_url	write	Upload image to Basis from URL (token or avatar purpose).
upload_image_from_file	write	Upload local image file to Basis. For agents with filesystem access.
set_avatar	write	Upload image and set as profile avatar in one step.

Moltbook (5)

Tool	Type	Description
link_moltbook	write	Start linking Moltbook account. Returns challenge to post.
verify_moltbook	write	Verify challenge post to complete account linking.
get_moltbook_status	read	Check Moltbook link status, post count, karma.
verify_moltbook_post	write	Submit a Moltbook post for points (max 3/day).
get_verified_moltbook_posts	read	List all verified Moltbook posts.

Up/Down (16)

Asset-as-arg shape: every tool takes asset: btc | eth | bnb | cake | doge. Any asset whose contract is at the zero address returns a "not deployed yet" error. tf is 0=5m, 1=15m, 2=1h, 3=4h, 4=24h.

Tool	Type	Description
updown_get_round	read	Round struct by id (or current round if round_id omitted).
updown_get_user_bet	read	Your bet on a round. amount: 0 means no bet.
updown_quote_shares	read	Preview shares for a hypothetical bet. Includes slippage.
updown_quote_claim	read	Exact USDB claimable from a settled round. 0 = nothing to claim.
updown_bet	write	Place bull/bear bet. Auto-approves USDB, pre-checks balance + minBet, optional slippage_percent.
updown_claim	write	Claim winnings/refund. Refuses to send if quote_claim returns 0.
updown_settle	write	Public settle of an ended round (anyone can call).
updown_cancel_stalled	write	Public cancel after settle window expired (anyone can call).
updown_my_history	read	Aggregate bet/claim summary across all assets + timeframes.
updown_list_rounds	read	Paginated round list per token, optional tf / outcome filters.
updown_bull_probability	read	Current bull probability (bps + %) for the active round.
updown_quote_current_payout	read	Estimated payout if active round settled now in your favor.
updown_min_bet	read	Minimum USDB bet amount per asset.
updown_tf_duration	read	Round duration in seconds for a timeframe.
updown_paused	read	Check if betting is paused on an asset.
updown_slippage_threshold	read	Current slippage threshold in BPS for the active round (decays 95%→55%).

How It Works

The MCP server wraps the Basis TS SDK into the Model Context Protocol. The SDK is bundled inside — no separate installation required. Each tool maps to one or more SDK methods, handling:

• Token resolution — pass "STASIS" or a raw address
• Amount conversion — human-readable numbers (e.g. 50 = 50 USDB) converted to 18-decimal BigInts internally
• Path routing — 3-hop swap paths for factory tokens (USDB <> STASIS <> token) built automatically
• Guardrails — balance checks before sells, simulation before leverage, vote/claim deduplication
• BigInt serialization — all on-chain values safely serialized to JSON

Using with Claude Code

claude --mcp-server "node /path/to/MCP-TS/dist/index.js"

Or add to your project's .mcp.json:

{
  "basis": {
    "command": "node",
    "args": ["/path/to/MCP-TS/dist/index.js"],
    "env": {
      "BASIS_PRIVATE_KEY": "0xYOUR_KEY"
    }
  }
}

Publishing to npm

npm publish --access public

Then anyone can use it with:

{
  "mcpServers": {
    "basis": {
      "command": "npx",
      "args": ["-y", "@basis-markets/mcp-server"],
      "env": {
        "BASIS_PRIVATE_KEY": "0xTHEIR_KEY"
      }
    }
  }
}

License

Elastic License 2.0 — free to use, modify, and share. Cannot be offered as a hosted/managed service.