Skip to main content
Glama
Basis MCP Server

Basis MCP Server

Official

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

Related MCP server: Base MCP Server

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.

Available Tools

205 tools
add_dev_shareC

Add dev fee share to a wallet for your token.

Inputs: token (required), wallet (required), basis_points (required).

add_tokens_to_vestingC

Add more tokens to existing vesting.

Inputs: vesting_id (required), amount (required).

batch_create_cliff_vestingB

Batch create cliff vestings. All share the same token, unlock_time, ecosystem.

Inputs: beneficiaries (required), token (required), amounts (required), unlock_time (required), +2 more.

batch_create_gradual_vestingB

Batch create gradual vesting schedules. All share the same token, start_time, duration, time_unit, ecosystem.

Inputs: beneficiaries (required), token (required), amounts (required), start_time (required), +4 more.

betA

Buy shares in a prediction market outcome. UNCAPPED payouts — winners split entire losing pool + general pot, NOT $1/share. Before betting: 1) get_my_shares for existing position 2) estimate_shares_out for new shares 3) get_potential_payout(TOTAL shares = existing + new, usdb=bet_amount) → payout_if_win is your TOTAL payout. Profit = payout_if_win - total_invested.

Inputs: market (required), outcome (required), amount_usdb (required).

buy_multiple_ordersC

Sweep multiple orders at once.

Inputs: market (required), outcome (required), order_ids (required), total_usdb (required), +1 more.

buy_orderC

Fill a single order on the order book.

Inputs: market (required), order_id (required), amount_usdb (required).

buy_orders_and_contractC

Buy from order book + AMM in one transaction.

Inputs: market (required), outcome (required), order_ids (required), amount_usdb (required), +1 more.

buy_tokenA

Buy a token using USDB. Elastic supply — buying increases price. Previews before executing. NOTE: Floor+ tokens (multiplier 1-99) and prediction market tokens have 1.5% tax, other tokens have 0.5% — account for this in slippage.

Inputs: token (required), amount_usdb (required), slippage_percent, wrap.

cancel_orderC

Cancel an open order.

Inputs: market (required), order_id (required).

change_vesting_beneficiaryC

Transfer vesting to new beneficiary.

Inputs: vesting_id (required), new_beneficiary (required).

claim_bountyC

Claim resolution bounty.

Inputs: market (required), round.

claim_faucetA

Claim daily USDB from faucet (up to 500 USDB/day based on eligibility signals). Requires SIWE session. Check get_faucet_status first.

Inputs: referrer.

claim_leverage_liquidationA

Claim USDB residue from a liquidated leverage position. Position must be inactive (already liquidated) and have a non-zero claim. Uses loanId (leverage position id), NOT hubId.

Inputs: loan_id (required).

claim_liquidationC

Claim remaining collateral from expired loan.

Inputs: loan_type (required), hub_id.

claim_rewardsC

Claim accumulated rewards from reward phase.

Inputs: token (required).

claim_vesting_tokensB

Claim vested tokens from a vesting schedule.

Inputs: vesting_id (required).

close_leverageB

Close (or partially close) a leverage position. 10% increments.

Inputs: position_id (required), percentage.

convert_to_assetsC

Convert wSTASIS shares to STASIS value.

Inputs: shares (required).

create_cliff_vestingC

Create cliff vesting — all tokens unlock at once.

Inputs: beneficiary (required), token (required), amount (required), unlock_time (required), +2 more.

create_gradual_vestingC

Create gradual vesting schedule.

Inputs: beneficiary (required), token (required), amount (required), start_time (required), +4 more.

create_marketB

Create prediction market. Earn 20% of net trading fees forever. Provide image_url OR image_file_path.

Inputs: question (required), symbol (required), outcomes (required), end_time (required), +4 more.

create_project_commentC

Comment on a token project.

Inputs: project_id (required), content (required).

create_reef_commentC

Comment on a reef post.

Inputs: post_id (required), body (required).

create_reef_postC

Create a new reef post.

Inputs: section (required), title (required), body (required).

create_tokenA

Create a new token. You earn 20% of every trade forever. Stable+ = price only up, Floor+ = real movement with protection. Provide image_url OR image_file_path (at least one required).

Inputs: name (required), symbol (required), type (required), stability, +11 more.

delete_project_commentC

Delete a project comment.

Inputs: comment_id (required).

delete_reef_commentC

Delete your reef comment.

Inputs: comment_id (required).

delete_reef_postC

Delete your reef post.

Inputs: post_id (required).

dispute_outcomeB

Dispute proposed outcome (5 USDB bond).

Inputs: market (required), outcome (required).

edit_reef_commentC

Edit your reef comment.

Inputs: comment_id (required), body (required).

edit_reef_postC

Edit your reef post.

Inputs: post_id (required), title, body.

end_surge_taxC

End surge tax on your token.

Inputs: token (required).

estimate_shares_outB

Estimate shares you'd receive for a USDB bet. Add result to existing shares (from get_my_shares) to get total, then pass total to get_potential_payout with estimated_usdb_to_pool=bet_amount.

Inputs: market (required), outcome (required), amount_usdb (required).

extend_loanC

Extend vault or hub loan. ~400x cheaper than new loan.

Inputs: loan_type (required), days (required), hub_id, pay_in_stable, +1 more.

extend_vestingC

Extend vesting duration.

Inputs: vesting_id (required), days (required).

finalize_marketC

Finalize market resolution after challenge period.

Inputs: market (required).

get_agent_id_from_txA

Get agent ID from a registration transaction hash (recovery tool).

Inputs: tx_hash (required).

get_agent_metadataC

Get metadata key for an agent.

Inputs: agent_id (required), key (required).

get_agent_uriC

Get the metadata URI for an agent.

Inputs: agent_id (required).

get_agent_walletC

Get wallet address for an agent ID.

Inputs: agent_id (required).

get_available_surge_quotaC

Get remaining surge tax quota for a token.

Inputs: token (required).

get_balancesB

Wallet balances — USDB, STASIS, wSTASIS, factory tokens.

Inputs: no named parameters.

get_base_tax_ratesB

Get base tax rates for all token types.

Inputs: no named parameters.

get_bounty_per_voteC

Get bounty allocation per vote for a market.

Inputs: market (required).

get_bounty_poolC

Get bounty pool amount for a prediction market.

Inputs: market (required).

get_bug_reportsC

Get bug reports.

Inputs: status, limit.

get_buy_order_amounts_outC

Get amounts out for buying an order with USDB.

Inputs: market (required), order_id (required), amount_usdb (required).

get_claimable_rewardsA

Check claimable rewards amount before claiming.

Inputs: token (required), investor.

get_claimable_vestingB

Check claimable amount for a vesting.

Inputs: vesting_id (required).

get_creator_earningsA

Get un-distributed accrued USDB earnings for a dev on a specific token. Reads the pending balance before next distribution.

Inputs: token (required), dev.

get_dev_total_earningsB

Get a dev's lifetime distributed USDB earnings across every token they have a share on.

Inputs: dev.

get_faucet_statusA

Check faucet eligibility — signals, claimable amount, cooldown timer. Must be authenticated.

Inputs: no named parameters.

get_fee_amountA

Get the factory token creation fee.

Inputs: no named parameters.

get_final_outcomeC

Get the resolved outcome of a finalized market.

Inputs: market (required).

get_floor_priceA

Get the USDB floor price for a factory token. Does NOT work on STASIS — only factory-created tokens.

Inputs: token (required).

get_general_potC

Get general pot amount for a prediction market.

Inputs: market (required).

get_initial_reservesC

Get initial reserves for a number of outcomes.

Inputs: num_outcomes (required).

get_leaderboardC

Get platform leaderboard.

Inputs: page, limit.

get_leverage_positionsA

List all leverage positions for the wallet.

Inputs: no named parameters.

get_loan_eventsC

Get loan event history.

Inputs: source, action, limit.

get_loansC

List loans. Monitor expiry — silent auto-liquidation.

Inputs: active_only.

get_market_eventsC

Get prediction market event history.

Inputs: action, market_token, limit.

get_market_infoC

Get market data + outcome probabilities.

Inputs: market (required).

get_market_liquidityC

Get liquidity data for a prediction market.

Inputs: market (required), outcome_id, limit.

get_market_listC

List prediction markets.

Inputs: status, limit.

get_market_resolution_statusC

Full resolution pipeline status.

Inputs: market (required).

get_min_seedA

Get minimum seed amount (USDB) required to create a public prediction market. createMarket reverts below this.

Inputs: no named parameters.

get_moltbook_statusA

Check Moltbook link status — linked, verified, post count, karma.

Inputs: no named parameters.

get_my_daily_capsA

Today's cap-fill percentages for the authenticated wallet. Returns { date, resetsInSeconds, pointCaps[4]: trading|prediction|creator|positions, countCaps[2]: social_x|social_moltbook }. Each percent is 0-100. Caps reset at 00:00 UTC.

Inputs: no named parameters.

get_my_ordersA

Get your order book history. Paginated with optional status/market/outcome filters.

Inputs: status, market_token, outcome_id, page, +1 more.

get_my_profileB

Your profile — tier, rank, streak.

Inputs: no named parameters.

get_my_projectsA

Get your created tokens and markets.

Inputs: no named parameters.

get_my_referralsB

Get your referral data.

Inputs: no named parameters.

get_my_sharesA

Check shares held in a prediction market. To sell shares, use list_order (order book limit sell) — there is no AMM sell for prediction shares.

Inputs: market (required), outcome.

get_my_statsA

Your trading stats — trades, tokens created, loans.

Inputs: no named parameters.

get_my_tokensA

List all tokens you created with prices and state.

Inputs: no named parameters.

get_my_vestingsA

List vestings where you are beneficiary or creator.

Inputs: role.

get_order_costC

Get cost to fill an order.

Inputs: market (required), order_id (required), fill_amount (required).

get_ordersC

List orders for a market.

Inputs: market (required), status, outcome_id, limit.

get_outcomeC

Get data for a single prediction market outcome.

Inputs: market (required), outcome (required).

get_platform_statsC

Platform pulse — phase, stats, currency.

Inputs: no named parameters.

get_potential_payoutA

Calculate prediction market resolution payout: (yourShares / winningCirculatingShares) × totalPool. Two modes: (1) CURRENT: pass existing shares, usdb=0. (2) BET PREVIEW: pass total shares (existing+new), new_shares_from_bet = new shares from estimate_shares_out, usdb = bet amount.

Inputs: market (required), outcome (required), shares (required), new_shares_from_bet, +1 more.

get_priceB

Get current USD price of a token.

Inputs: token (required).

get_price_historyC

OHLC candles for a token.

Inputs: token (required), interval, limit.

get_project_commentsB

Get comments on a project.

Inputs: project_id (required), limit.

get_public_profileC

Get public profile for a wallet.

Inputs: wallet (required).

get_public_profile_referralsC

Get referral data for a wallet.

Inputs: wallet (required).

get_reef_feedC

Get reef posts feed.

Inputs: section, limit.

get_reef_feed_by_walletC

Get reef posts by a specific wallet.

Inputs: wallet (required), limit.

get_reef_highlightsB

Get highlighted reef posts.

Inputs: no named parameters.

get_reef_postC

Get a single reef post with comments.

Inputs: post_id (required).

get_reef_votesC

Get vote data for reef content.

Inputs: post_id (required).

get_resolver_constantsA

Get dispute period, proposal period, bond amounts.

Inputs: no named parameters.

get_resolver_stakeC

Get your resolver stake amount.

Inputs: wallet.

get_surge_taxC

Get current surge tax for a token.

Inputs: token (required).

get_tax_rateC

Get current tax rate for a token+wallet.

Inputs: token (required), wallet.

get_token_commentsC

Get comments on a token.

Inputs: token (required), limit.

get_token_detailC

Get full detail for a single token.

Inputs: token (required).

get_token_listC

List/search tokens. Filter by creator with dev param.

Inputs: search, dev, limit.

get_token_priceA

Get raw token price (reserve ratio). Different from get_price (USD).

Inputs: token (required).

get_token_stateB

Get token state — frozen, bonded, supply, price.

Inputs: token (required).

get_token_vesting_idsC

Get vesting schedule IDs for a token.

Inputs: token (required).

get_total_vault_assetsB

Get total assets in the staking vault.

Inputs: no named parameters.

get_trade_historyC

Recent trades for a token.

Inputs: token (required), type, limit.

get_user_loan_countB

Count of loans for the wallet.

Inputs: no named parameters.

get_user_loan_detailsC

Get on-chain details for a specific loan.

Inputs: hub_id (required).

get_vault_eventsC

Get vault staking event history.

Inputs: action, limit.

get_vault_loanA

Get full loan details for an active vault loan. Handles the vault-as-borrower indirection automatically. Returns null if no active vault loan.

Inputs: wallet.

get_vault_statusC

Complete vault position status.

Inputs: no named parameters.

get_verified_moltbook_postsA

List all your verified Moltbook posts.

Inputs: no named parameters.

get_verified_tweetsB

Get your verified tweets.

Inputs: no named parameters.

get_vesting_countA

Total vesting schedules created.

Inputs: no named parameters.

get_vesting_detailsC

Get details for a vesting schedule.

Inputs: vesting_id (required).

get_vesting_details_batchC

Get details for multiple vestings at once.

Inputs: vesting_ids (required).

get_vesting_eventsC

List vesting events from API.

Inputs: action, vesting_id, limit.

get_vote_countC

Get vote count for an outcome in a dispute round.

Inputs: market (required), round (required), outcome (required).

get_voter_choiceC

Get what a voter chose in a dispute round.

Inputs: market (required), round (required), voter.

get_whitelistC

View whitelist for a frozen token.

Inputs: token (required), wallet, limit.

has_betted_on_marketC

Check if you have bet on a prediction market.

Inputs: market (required).

increase_loan_collateralC

Add collateral without new origination fee.

Inputs: loan_type (required), amount (required), hub_id.

is_agent_registeredB

Check if a wallet is registered as an agent.

Inputs: wallet.

is_ecosystem_tokenA

Check if a token address is a valid Basis ecosystem token.

Inputs: token (required).

is_resolver_voterA

Check if a wallet is an eligible resolver voter.

Inputs: wallet.

leverage_buyA

Open leveraged position. NO price liquidation — time-based only. Simulates first, requires confirm=true.

Inputs: token (required), amount_usdb (required), days (required), confirm (required).

list_agentsC

List registered AI agents.

Inputs: page, limit.

list_orderA

Place limit sell order on prediction market outcome. This is the ONLY way to sell prediction market shares — there is no AMM sell, only order book.

Inputs: market (required), outcome (required), amount (required), price_per_share (required).

lookup_agentB

Lookup an agent by wallet address.

Inputs: wallet (required).

partial_loan_sellB

Partially sell hub loan collateral. 10% increments.

Inputs: hub_id (required), percentage (required).

pm_buyC

Buy shares in a private market outcome.

Inputs: market (required), outcome (required), amount_usdb (required).

pm_buy_multiple_ordersC

Sweep multiple private market orders.

Inputs: market (required), order_ids (required), amount_usdb (required).

pm_buy_orderC

Fill a private market order.

Inputs: market (required), order_id (required), amount_usdb (required).

pm_buy_orders_and_contractC

Buy from private market order book + AMM in one transaction.

Inputs: market (required), outcome (required), order_ids (required), amount_usdb (required), +1 more.

pm_cancel_orderC

Cancel private market order.

Inputs: market (required), order_id (required).

pm_can_user_buyC

Check if you can buy on private market.

Inputs: market (required).

pm_claim_bountyC

Claim private market bounty.

Inputs: market (required).

pm_create_marketB

Create a private prediction market with metadata. Provide image_url OR image_file_path.

Inputs: name (required), symbol (required), outcomes (required), end_time (required), +9 more.

pm_disable_freezeC

Open private market to public.

Inputs: market (required).

pm_finalizeC

Finalize a private market.

Inputs: market (required).

pm_get_market_dataD

Get private market data.

Inputs: market (required).

pm_get_min_seed_privateB

Get min seed amount (USDB) for a voter-panel private market. Often 0.

Inputs: no named parameters.

pm_get_min_seed_publicA

Get min seed amount (USDB) for a non-private private market. Higher than private-only.

Inputs: no named parameters.

pm_get_user_sharesD

Get shares in private market.

Inputs: market (required), outcome (required).

pm_list_orderC

List sell order on private market.

Inputs: market (required), outcome (required), amount (required), price_per_share (required).

pm_manage_voterC

Add/remove voter for private market.

Inputs: market (required), voter (required), status (required).

pm_manage_whitelistC

Manage private market whitelist.

Inputs: market (required), wallets (required), max_usdb (required), status (required), +1 more.

pm_redeemC

Redeem winnings from a private market.

Inputs: market (required).

pm_toggle_buyersC

Toggle private event buyer access.

Inputs: market (required), buyers (required), status (required).

pm_voteC

Vote on private market outcome.

Inputs: market (required), outcome (required).

preview_tradeB

Preview a buy or sell without executing.

Inputs: token (required), direction (required), amount_usdb, amount_token.

propose_outcomeB

Propose winning outcome (5 USDB bond).

Inputs: market (required), outcome (required).

redeem_winningsB

Claim winnings from resolved market.

Inputs: market (required).

register_agentB

Register as AI agent on-chain (ERC-8004).

Inputs: name (required), description, capabilities, tx_hash.

remove_dev_shareC

Remove dev fee share from a wallet.

Inputs: token (required), wallet (required).

remove_whitelistC

Remove wallet from frozen token whitelist.

Inputs: token (required), wallet (required).

repay_loanC

Repay a hub loan.

Inputs: hub_id (required).

repay_loan_on_vestingC

Repay a loan taken against a vesting.

Inputs: vesting_id (required).

report_reef_postC

Report a reef post.

Inputs: post_id (required), reason.

request_twitter_challengeB

Get a Twitter verification challenge code.

Inputs: no named parameters.

resolver_stakeC

Stake/unstake for dispute voting eligibility.

Inputs: action (required).

sell_tokenA

Sell a token for USDB. Checks balance first. Use percentage to scale out. NOTE: Floor+ tokens (multiplier 1-99) and prediction market tokens have 1.5% tax, other tokens have 0.5% — account for this in slippage.

Inputs: token (required), amount, percentage, slippage_percent, +1 more.

set_agent_uriC

Update your agent's metadata URI.

Inputs: agent_id (required), uri (required).

set_avatarB

Upload image and set as profile avatar in one step.

Inputs: image_url (required).

stake_stasisB

Buy STASIS and/or wrap→wSTASIS→lock. Multi-step.

Inputs: amount_usdb, amount_stasis, lock, lock_existing_wstasis.

start_surge_taxA

Start surge tax on your token (creator only).

Inputs: token (required), start_rate (required), end_rate (required), duration (required).

submit_bug_reportC

Submit a bug report.

Inputs: title (required), description (required), severity (required), category (required), +1 more.

sync_loanC

Sync a loan transaction.

Inputs: tx_hash (required).

sync_orderC

Sync an order book transaction.

Inputs: tx_hash (required).

sync_transactionC

Manually sync a transaction to the backend.

Inputs: tx_hash (required).

take_loanB

Loan against any token. No price liquidation. For STASIS prefer vault_borrow.

Inputs: collateral_token (required), amount (required), days (required).

take_loan_on_vestingC

Take a loan against a vesting schedule.

Inputs: vesting_id (required).

transfer_vesting_creatorC

Transfer vesting creator role.

Inputs: vesting_id (required), new_creator (required).

unfreeze_tokenB

Open frozen token to public trading. Irreversible.

Inputs: token (required).

unstake_stasisB

Unwrap/sell staked STASIS.

Inputs: unlock, sell_to_usdb, shares.

update_my_profileC

Update your profile. One action per call.

Inputs: username, avatar, social, remove_social, +1 more.

updown_betB

Place a bullish or bearish bet on the current UPDOWN round. Auto-approves USDB and pre-checks balance + minBet client-side. Use slippage_percent for an optional minShares guard.

Inputs: asset (required), tf (required), side (required), amount (required), +1 more.

updown_bull_probabilityB

Current bull probability for the active UPDOWN round (basis points 0-10000, also returned as percentage).

Inputs: asset (required), tf (required).

updown_cancel_stalledA

Public cancel of a stalled UPDOWN round (settle window expired). Anyone can call after endTime + FINALIZE_WINDOW.

Inputs: asset (required), tf (required).

updown_claimA

Claim winnings or refund from a settled UPDOWN round. Pre-checks via quoteClaimPayout — refuses to send if 0.

Inputs: asset (required), tf (required), round_id (required).

updown_get_roundA

Get a specific UPDOWN round by id — or omit round_id to get the current round. Returns the full Round struct (startPrice/endPrice in 8-dec, pools/shares/seedBonus in 18-dec USDB, outcome enum 0=Pending,1=BullWins,2=BearWins,3=Canceled). Returns null if no rounds opened yet.

Inputs: asset (required), tf (required), round_id.

updown_get_user_betB

Get your bet on a specific UPDOWN round. amount=0 means no bet placed.

Inputs: asset (required), tf (required), round_id (required).

updown_list_roundsA

Paginated UPDOWN round list for a token, newest-first. Optional tf and outcome filters.

Inputs: asset (required), tf, outcome, cursor, +1 more.

updown_min_betC

Minimum bet amount in USDB for an UPDOWN asset.

Inputs: asset (required).

updown_my_historyA

Aggregate UPDOWN bet/claim summary for your wallet across every asset (BTC/ETH/BNB/CAKE/DOGE) and all timeframes — totals, win/loss tallies, and embedded activeBets[] / claimableBets[] arrays.

Inputs: no named parameters.

updown_pausedA

Check if an UPDOWN asset is paused (writes will revert if true).

Inputs: asset (required).

updown_quote_claimA

Exact USDB you can claim from a settled round. 0 means nothing to claim (lost / already claimed / pending / no bet).

Inputs: asset (required), tf (required), round_id (required).

updown_quote_current_payoutB

Estimate your payout if the active UPDOWN round settled now in your favor. Returns 0 if no bet placed.

Inputs: asset (required), tf (required).

updown_quote_sharesB

Preview shares minted by a hypothetical bet on the current round. Includes slippage. Returns 0 if no active round.

Inputs: asset (required), tf (required), side (required), amount (required).

updown_settleA

Public settle of an UPDOWN round once it has ended and a valid Chainlink price is available. Anyone can call.

Inputs: asset (required), tf (required).

updown_slippage_thresholdC

Current slippage threshold in BPS for the active round. Decays from 9500 (95%) at start to 5500 (55%) at end.

Inputs: asset (required), tf (required).

updown_tf_durationD

Round duration in seconds for a timeframe.

Inputs: asset (required), tf (required).

upload_image_from_fileA

Upload a local image file to Basis (Pinata/IPFS). For agents/Claude Code with local file access.

Inputs: file_path (required), purpose, contract_address.

upload_image_from_urlA

Upload an image from URL to Basis (Pinata/IPFS). Use purpose='avatar' for profile pics, 'token' for token/market images (requires contract_address).

Inputs: image_url (required), contract_address, purpose.

vault_borrowB

Borrow USDB against locked wSTASIS. 2% + 0.005%/day.

Inputs: amount_stasis (required), days (required).

vault_repayC

Repay vault loan.

Inputs: no named parameters.

verify_moltbookC

Verify the Moltbook challenge post to complete account linking.

Inputs: agent_name (required), post_id (required).

verify_moltbook_postA

Submit a Moltbook post for verification (earns points, max 3/day, 7-day lock-in).

Inputs: post_id (required).

verify_social_tweetC

Submit a tweet tagging @LaunchOnBasis for points. Max 3/day.

Inputs: tweet_url (required).

verify_twitterC

Verify a Twitter challenge tweet for account linking.

Inputs: tweet_url (required).

veto_outcomeC

Veto a proposed market outcome (admin).

Inputs: market (required), outcome (required).

vote_on_disputeA

Vote during dispute. Requires resolver_stake first. 24h lock.

Inputs: market (required), outcome (required).

vote_reef_commentC

Upvote/downvote a reef comment.

Inputs: comment_id (required), vote (required).

vote_reef_postC

Upvote/downvote a reef post.

Inputs: post_id (required), vote (required).

whitelist_walletsC

Add wallets to frozen token's whitelist.

Inputs: token (required), wallets (required), max_buy_usdb (required), tag.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.2/5.0

    Scored across 205 tools

    Disambiguation2/5

    With 205 tools, there is significant overlap and many similar-sounding tools (e.g., buy_order, buy_multiple_orders, buy_orders_and_contract, pm_buy_order). Descriptions help somewhat but the sheer number makes disambiguation difficult for an agent.

    Naming Consistency2/5

    Naming conventions are inconsistent: mixed use of underscores (e.g., add_dev_share) and camelCase (e.g., pm_can_user_buy), irregular prefixes like 'pm_' for private market tools but not always, and varied verb patterns (get_ vs list_).

    Tool Count1/5

    205 tools is excessively high for an MCP server. While the server covers many domains, many tools are overly granular (e.g., 20+ updown_* tools). This vast surface is hard to navigate and likely beyond practical utility.

    Completeness3/5

    The tool set covers a broad range of functionality (tokens, markets, loans, vesting, social features, agents). However, there are some gaps like no delete for tokens or markets, and some lifecycle steps missing (e.g., no update for markets). Overall moderately complete.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A powerful toolkit that enables seamless interaction with EVM-compatible networks through natural language processing and AI assistance, allowing users to manage wallets, launch tokens, and interact with blockchain networks.
      17 npm
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables AI applications to interact with the Base blockchain network, allowing wallet management, smart contract deployment, token transfers, NFT operations, DeFi interactions with Morpho vaults, and onramping funds via Coinbase.
      26 npm
      -
    • F
      license
      C
      quality
      B
      maintenance
      Enables AI agents to interact with any EVM-compatible blockchain through natural language, supporting token swaps, cross-chain bridges, staking, lending, governance, gas optimization, and portfolio tracking across networks like Ethereum, BSC, Polygon, Arbitrum, and more.
      100
      49 npm
      44
      -
    • A
      license
      C
      quality
      B
      maintenance
      Provides over 156 tools to interact with the Binance.com global exchange API for spot trading, wallet management, and staking operations. It enables users to execute orders, retrieve market data, and manage crypto assets through natural language interfaces like Claude and ChatGPT.
      195
      134 npm
      40
      MIT