Bloxwap MCP server
Bloxwap runs a Model Context Protocol server at https://bloxwap.app/mcp over Streamable HTTP. Eight public tools need no authentication. Account reads require a verified Privy session and an address controlled by that Privy user; arbitrary API keys do not authenticate.
Public tools (8)
search_docs(query, limit?, section?)
Search Bloxwap documentation and guides, with ranked excerpts and canonical URLs for citations.
get_doc(path)
Fetch the full markdown of one page by site path, e.g. /docs/fees.
quote_fees
Calculate round-trip fees. Supply address for address-based Genesis verification; without an address, genesis: true is only an unverified hypothetical.
list_markets
List available markets.
get_market_prices
Get current market prices.
get_candles
Get candlestick data.
get_trend_signals
Get trend signals.
get_swing_signals
Get swing signals.
Authenticated reads (3)
Send Authorization: Bearer <verified Privy session token> and request an address controlled by that Privy user. API keys and apiKey tool arguments do not authenticate. Privy tokens expire.
get_account_summary(address)
Get account balances and summary data.
get_positions(address)
Get positions, including funding since open; positive funding was received and negative funding was paid.
get_orders(address)
Get open orders only, not order history.
Write schemas (5)
market_long, market_short, set_stop_loss, close_position, adjust_leverage
These schemas require a verified Privy session and _writeEnabled: true, but trade execution is currently unavailable. They do not place, modify or close trades.
Non-custodial safety
Bloxwap is non-custodial: positions are signed by the user’s own embedded wallet and settle on-chain on Hyperliquid. Never put a wallet private key, seed phrase or mnemonic into an MCP config, header or tool argument. To trade, use the Bloxwap app; for direct programmatic trading, talk to Hyperliquid.
Connecting
Any MCP client that speaks Streamable HTTP works. Public tools need no auth block:
{
"mcpServers": {
"bloxwap": {
"type": "http",
"url": "https://bloxwap.app/mcp"
}
}
}Account reads additionally need the Privy authorization header described above. The MCP server is stateless and issues no MCP session id. It speaks protocol versions 2025-06-18, 2025-03-26 and 2024-11-05, and negotiates down to whichever the client asks for.
More
Developer overview — the public REST API.
/openapi.json — the same data as typed HTTP operations.
/llms.txt — the whole documentation corpus in one fetch, if you would rather not call a tool.