How do I use Basis MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Basis MCP Server What are my balances?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Basis MCP Server

Official

by Launch-On-Basis

Overview Schema Related Servers Score Discussions

JavaScript

Remote

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.

Install Server

license - not found

quality

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Launch-On-Basis/MCP-TS'

If you have feedback or need assistance with the MCP directory API, please join our Discord server