Tools reference

Nine tools

The same nine tools on the remote server and in npx basepad-mcp. Write tools sign from the agent wallet and are irreversible on-chain; read tools never need a key.

basepad_create_walletnew walletCreate agent wallet

Create a fresh Base wallet for this agent. Returns address, private_key and agent_key; show all three to the user once and tell them to save them. Fund the address with a little ETH on Base before launching or trading. `agent` files the wallet's launches under that agent on basepad.si (grok, muse, dots, claude, cursor or other).

agentstring: Which agent this wallet belongs to: grok, muse, dots, claude, cursor or other

basepad_walletreadWallet status

Address, ETH balance on Base and launch count of the agent wallet.

agent_keystring: The bp_... key returned by basepad_create_wallet. Optional when the connector already sends it as a Bearer token.

basepad_launch_tokenon-chain writeLaunch a token

Launch a token on Base from the agent wallet (signed and sent on-chain, irreversible). Defaults: ETH pair, $10,000 starting market cap, 1% trading fee, fees to the agent wallet, no first buy. Confirm the details with the user first.

agent_keystring: The bp_... key returned by basepad_create_wallet. Optional when the connector already sends it as a Bearer token.
name *string: Token name, up to 32 characters
symbol *string: Ticker, 1-10 letters or digits
descriptionstring: Short description shown on the token page
image_urlstring: https URL of a square logo
logo_promptstring: No image_url? Describe a logo and basepad draws one
websitestring: https URL
xstring: X handle or x.com link
pairstring: What the token trades against: ETH (default), USDC, or a Coinbase stock on Base like NVDA, TSLA, AAPL
market_cap_usdnumber: Starting market cap in USD, 1,000 to 10,000,000 (default 10,000)
market_cap_quotenumber: Starting market cap in units of the pair, for pairs without a USD price
fee_percent1 | 3: Trading fee in percent: 1 (default) or 3
fee_recipientstring: Who earns the 95% creator share: "me" (the agent wallet, default), "burn", or a 0x address
first_buy_ethnumber: Optional first buy in ETH right after launch, up to 0.1 (ETH pairs only)

basepad_buyon-chain writeBuy a token

Buy a basepad token from the agent wallet, paying in the token's pair (ETH, USDC or the stock). Capped at $1,000 per trade.

agent_keystring: The bp_... key returned by basepad_create_wallet. Optional when the connector already sends it as a Bearer token.
token *string: Token contract address on Base (0x...)
amount *string: How much of the pair to spend, e.g. "0.01" (ETH)

basepad_sellon-chain writeSell a token

Sell a basepad token from the agent wallet back into its pair. Pass percent (1-100) or amount (tokens); neither sells everything.

agent_keystring: The bp_... key returned by basepad_create_wallet. Optional when the connector already sends it as a Bearer token.
token *string: Token contract address on Base (0x...)
percentnumber
amountstring: Token amount, e.g. "1000000"

basepad_withdrawon-chain writeWithdraw ETH

Send ETH from the agent wallet to another address on Base. amount is ETH or "max".

agent_keystring: The bp_... key returned by basepad_create_wallet. Optional when the connector already sends it as a Bearer token.
to *string
amount *string: ETH amount or "max"

basepad_tokenreadToken details

Price, market cap, volume, trades, fees and links of a basepad token.

token *string: Token contract address on Base (0x...)

basepad_launchesreadBrowse launches

List basepad launches. sort: live, new, mcap, volume, gainers or holders. agent: only launches by that agent (grok, muse, dots, claude, cursor, other, or "any").

sortlive | new | mcap | volume | gainers | holders
agentstring
limitnumber

basepad_pairsreadLaunch pairs

Everything a token can be paired with on basepad: ETH, USDC and the Coinbase tokenized stocks on Base.