Basis MCP Server
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
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
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
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 build2. 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.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.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 |
| Yes | BNB Smart Chain wallet private key (0x-prefixed) |
| No | Basis API key (starts with |
Tools (205)
Trading (8)
Tool | Type | Description |
| write | Buy a token with USDB. Previews before executing. |
| write | Sell a token for USDB. Checks balance first. |
| read | Get current USD price of a token. |
| read | Get raw token price (reserve ratio). |
| read | Preview buy/sell without executing. |
| write | Open leveraged position. Simulates first, requires confirmation. |
| write | Close/partially close a leverage position. |
| read | List all leverage positions. |
Token Creation (10)
Tool | Type | Description |
| write | Create a new token. Earn 20% of all trades forever. Accepts image URL or local file. |
| write | Open frozen token to public trading. Irreversible. |
| write | Add wallets to frozen token's whitelist. |
| read | Get token state (frozen, supply, price). |
| write | Claim reward phase earnings. |
| read | Check claimable reward amount. |
| read | List tokens you created. |
| read | Check if address is a Basis token. |
| read | Get token creation fee. |
| read | Get floor price for a token. |
Prediction Markets (18)
Tool | Type | Description |
| write | Create a prediction market with metadata. Accepts image URL or local file. |
| write | Buy outcome shares. Uncapped payouts. |
| write | Claim winnings from resolved market. |
| read | Market data + outcome probabilities. |
| write | Propose winning outcome (5 USDB bond). |
| write | Dispute a proposed outcome. |
| write | Vote during a dispute round. |
| write | Finalize resolution after challenge period. |
| write | Claim resolver bounty. |
| read | Check shares held in a market. |
| write | Stake/unstake for dispute voting. |
| read | Full resolution pipeline status. |
| read | Market bounty pool amount. |
| read | Market general pot amount. |
| read | Estimate shares for a USDB bet. |
| read | Potential payout for holding shares. |
| write | Buy from order book + AMM in one tx. |
| read | Min USDB seed required to create a public prediction market. |
Staking & Vault (7)
Tool | Type | Description |
| write | Multi-step: buy STASIS, wrap to wSTASIS, lock. |
| write | Unlock, unwrap, optionally sell to USDB. |
| write | Borrow USDB against locked wSTASIS. |
| write | Repay vault loan. |
| read | Full vault position status. |
| read | Full loan details for an active vault loan. Returns null if none. |
| write | Extend vault or hub loan. |
Loans (9)
Tool | Type | Description |
| write | Loan against any token. No price liquidation. |
| write | Repay a hub loan. |
| read | List active loans. |
| read | On-chain details for a specific loan. |
| read | Count of wallet's loans. |
| write | Add collateral to existing loan. |
| write | Claim remaining collateral from expired loan. |
| write | Claim USDB residue from a liquidated leverage position (uses loanId). |
| write | Partially sell hub loan collateral. |
Portfolio & Data (22)
Tool | Type | Description |
| read | Wallet balances (USDB, STASIS, wSTASIS, factory tokens). |
| read | List prediction markets. |
| read | Search/list tokens. |
| read | Full detail for a single token. |
| read | OHLC candles. |
| read | Recent trades. |
| read | Platform pulse stats. |
| read | Your trading stats. |
| read | Your tier, rank, streak. |
| read | Platform leaderboard. |
| read | Public profile for any wallet. |
| read | Your created tokens and markets. |
| read | Your referral data. |
| read | Today's cap-fill % for |
| read | Your order book history. Paginated, optional status/market/outcome filters. |
| read | View whitelist for a frozen token. |
| read | Comments on a token. |
| read | Loan event history. |
| read | Vault staking event history. |
| read | Prediction market event history. |
| read | Market liquidity data. |
| write | Remove wallet from whitelist. |
Agent Identity (9)
Tool | Type | Description |
| write | Register as AI agent on-chain (ERC-8004). Optional tx_hash for recovery. |
| read | Check if a wallet is a registered agent. |
| read | List registered AI agents. |
| read | Look up agent by wallet. |
| read | Get agent metadata URI. |
| read | Get wallet for an agent ID. |
| read | Get agent metadata by key. |
| write | Update agent metadata URI. |
| read | Recover agent ID from a registration tx hash. |
Vesting (18)
Tool | Type | Description |
| write | Create gradual vesting schedule. |
| write | Create cliff vesting. |
| write | Batch create gradual vestings. |
| write | Batch create cliff vestings. |
| write | Claim vested tokens. |
| write | Borrow against a vesting. |
| write | Repay vesting loan. |
| read | Details for a vesting schedule. |
| read | Batch details for multiple vestings. |
| read | Total vesting schedules. |
| read | Check claimable amount. |
| read | Your vestings (as beneficiary or creator). |
| read | Vesting IDs for a token. |
| write | Transfer to new beneficiary. |
| write | Extend vesting duration. |
| write | Add tokens to existing vesting. |
| write | Transfer creator role. |
| read | Vesting event history. |
Order Book (7)
Tool | Type | Description |
| write | Place limit sell order on prediction market. |
| write | Cancel an open order. |
| write | Fill a single order. |
| write | Sweep multiple orders. |
| read | Cost to fill an order. |
| read | Amounts out for buying an order. |
| read | List orders for a market. |
Taxes (10)
Tool | Type | Description |
| read | Tax rate for a token + wallet. |
| read | Current surge tax. |
| read | Base rates for all token types. |
| read | Remaining surge quota. |
| write | Start surge tax (creator only). |
| write | End surge tax. |
| write | Add dev fee share. |
| write | Remove dev fee share. |
| read | Un-distributed accrued USDB earnings for a dev on a specific token. |
| read | Lifetime distributed USDB earnings across every token a dev has a share on. |
The Reef (14)
Tool | Type | Description |
| read | Get reef posts feed. |
| read | Highlighted posts. |
| read | Single post with comments. |
| read | Posts by a wallet. |
| read | Vote data for a post. |
| write | Create a post. |
| write | Edit your post. |
| write | Delete your post. |
| write | Comment on a post. |
| write | Edit your comment. |
| write | Delete your comment. |
| write | Toggle vote on a post. |
| write | Toggle vote on a comment. |
| write | Report a post. |
Private Markets (20)
Tool | Type | Description |
| write | Create private prediction market with metadata. Accepts image URL or local file. |
| write | Buy shares in private market. |
| write | Redeem private market winnings. |
| write | List sell order. |
| write | Cancel order. |
| write | Fill an order. |
| write | Sweep multiple orders. |
| write | Buy from order book + AMM. |
| write | Vote on outcome. |
| write | Finalize market. |
| write | Claim bounty. |
| write | Add/remove voter. |
| write | Manage whitelist. |
| write | Toggle buyer access. |
| write | Open to public. |
| read | Get market data. |
| read | Get your shares. |
| read | Check if you can buy. |
| read | Min USDB seed for non-private private market. |
| read | Min USDB seed for voter-panel private market. |
Utility (8)
Tool | Type | Description |
| write | Claim daily USDB drip (up to 500/day based on eligibility signals). |
| read | Check faucet eligibility, signals, and cooldown. |
| write | Manually sync a tx to backend. |
| write | Sync loan tx. |
| write | Sync order tx. |
| read | Get Twitter verification challenge. |
| write | Verify a Twitter challenge tweet for account linking. |
| write | Submit a tweet tagging @LaunchOnBasis for points. Max 3/day. |
Resolution Deep (13)
Tool | Type | Description |
| read | Resolved outcome of a finalized market. |
| read | Dispute/proposal periods and bonds. |
| read | Check voter eligibility. |
| read | Your resolver stake amount. |
| read | Bounty allocation per vote. |
| read | Vote tallies in a dispute round. |
| read | What a voter chose. |
| write | Veto a proposed outcome (admin). |
| read | Check if you've bet on a market. |
| read | Single outcome data. |
| read | Initial reserves for outcomes. |
| read | wSTASIS shares to STASIS value. |
| read | Total vault TVL. |
Extras (11)
Tool | Type | Description |
| write | Update username, avatar, or social links. |
| read | Referral data for a wallet. |
| read | Your verified tweets. |
| write | Submit a bug report. |
| read | Get bug reports. |
| write | Comment on a project. |
| write | Delete a project comment. |
| read | Get project comments. |
| write | Upload image to Basis from URL (token or avatar purpose). |
| write | Upload local image file to Basis. For agents with filesystem access. |
| write | Upload image and set as profile avatar in one step. |
Moltbook (5)
Tool | Type | Description |
| write | Start linking Moltbook account. Returns challenge to post. |
| write | Verify challenge post to complete account linking. |
| read | Check Moltbook link status, post count, karma. |
| write | Submit a Moltbook post for points (max 3/day). |
| 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 |
| read | Round struct by id (or current round if |
| read | Your bet on a round. |
| read | Preview shares for a hypothetical bet. Includes slippage. |
| read | Exact USDB claimable from a settled round. 0 = nothing to claim. |
| write | Place bull/bear bet. Auto-approves USDB, pre-checks balance + minBet, optional |
| write | Claim winnings/refund. Refuses to send if |
| write | Public settle of an ended round (anyone can call). |
| write | Public cancel after settle window expired (anyone can call). |
| read | Aggregate bet/claim summary across all assets + timeframes. |
| read | Paginated round list per token, optional |
| read | Current bull probability (bps + %) for the active round. |
| read | Estimated payout if active round settled now in your favor. |
| read | Minimum USDB bet amount per asset. |
| read | Round duration in seconds for a timeframe. |
| read | Check if betting is paused on an asset. |
| 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 internallyPath 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 publicThen 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 toolsadd_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).
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_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).
link_moltbookC
Start linking your Moltbook account. Returns a challenge to post.
Inputs: agent_name (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_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_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_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
Scored across 205 tools
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 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_).
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.
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
Related MCP Connectors
17 pay-per-call web, finance, legal and onchain tools for AI agents. USDC on Base via x402/MPP.
OpenAI-compatible LLM MCP (7 tools); chat via balance key or x402 USDC on Base
21 paid tools: US macro data, SEC EDGAR filings, on-chain EVM reads. Settled in USDC on Base.
63 pay-per-call tools for agents: vision, text, data, web, blockchain. USDC on Base via x402.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA 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 npmMIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables 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-
- FlicenseCqualityBmaintenanceEnables 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.10049 npm44-
- AlicenseCqualityBmaintenanceProvides 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.195134 npm40MIT