An AI agent can explain what a perpetual future is, but it can't see what Bitcoin is trading at right now. The Bloxwap MCP server closes that gap. It gives an agent live market data from Hyperliquid, Bloxwap's fee math, our documentation, and the Trend and Swing signals, all through one URL:

https://bloxwap.app/mcp

MCP stands for Model Context Protocol, an open standard for connecting AI agents to outside tools. You add the server once, and the agent decides which tool to call when you ask a question.

One thing to know up front: the agent can read, but it cannot place trades. Order tools are listed on the server, and every call to them is turned away. You still place each trade yourself in the Bloxwap app. The reasons are in Why the agent can't trade yet.

What the agent can do

The server has 16 tools in three groups.

GroupSign-in neededTools
PublicNonesearch_docs, get_doc, quote_fees, list_markets, get_market_prices, get_candles, get_trend_signals, get_swing_signals
Account readsYour Bloxwap sessionget_account_summary, get_positions, get_orders
Order toolsNot available at this timemarket_long, market_short, set_stop_loss, close_position, adjust_leverage

The eight public tools work the moment you connect. They cover most of what you'd want to ask before a trade:

  • Markets and leverage: every tradable market and the maximum leverage on each.
  • Prices: the current mid price, which is the midpoint between the best bid and best ask.
  • Candles: price history at intervals from one minute upward.
  • Fees: what a round trip costs for a given margin and leverage.
  • Signals: current Trend marks and active Swing setups.
  • Docs: search and read Bloxwap's guides, including this blog.

Set it up

Each setup below uses the public tools, so there's nothing to sign in to.

Claude

In Claude Code, run one command:

claude mcp add --transport http bloxwap https://bloxwap.app/mcp

In the Claude desktop or web app, open Settings → Connectors, choose Add custom connector, and paste the server URL.

Cursor

Add the server to ~/.cursor/mcp.json, or to .cursor/mcp.json inside a project:

{
  "mcpServers": {
    "bloxwap": {
      "url": "https://bloxwap.app/mcp"
    }
  }
}

Grok

Grok connects to remote MCP servers through the xAI API. Add the server to the tools list of your request:

{
  "tools": [
    {
      "type": "mcp",
      "server_url": "https://bloxwap.app/mcp",
      "server_label": "bloxwap"
    }
  ]
}

Any other client that supports MCP over Streamable HTTP can use the same URL.

Your first prompt

Once the server is connected, ask something that needs live data:

What's BTC trading at, and what's the most leverage I can use on it?

The agent calls get_market_prices for the price and list_markets for the leverage cap, then answers in plain language. Behind the answer, the tools return structured data like this:

{
  "prices": [{ "coin": "BTC", "mid": 75271.5, "timestamp": 1794268326808 }]
}
{ "coin": "BTC", "name": "BTC", "szDecimals": 5, "maxLeverage": 40 }

The price is an example from the day we wrote this. The agent's answer will use the price at the moment you ask.

A natural follow-up is the cost of the trade:

What would a round trip cost with $100 of margin at 5× leverage?

quote_fees works it out. Margin is the money you put up, and leverage multiplies it into the position size, so $100 at 5× is a $500 position:

FeeRate per sidePer sideRound trip
Bloxwap builder fee0.05%$0.25$0.50
Hyperliquid taker fee (estimated)0.045%$0.23$0.45
Total$0.95

The Bloxwap fee is exact. The Hyperliquid fee is an estimate, because it depends on your trading volume and the market. Treat the total as an upper bound. The fees page has the full breakdown.

Let the agent read your account

The three account tools show your balances, open positions (including funding paid or received since each one opened), and open orders. They need proof that the account is yours.

That proof is your Bloxwap session token, sent in the Authorization header of the connection. The server checks the token, then checks that the wallet address you asked about belongs to the same signed-in user. It refuses to read anyone else's account.

Two limits apply:

  • Session tokens expire. When account reads stop working, replace the token with a fresh one.
  • The token goes in the header only. Never put it in a prompt, a URL, or a tool argument.

Never give an agent a wallet private key or seed phrase. Bloxwap will never ask for one, and nothing on this server needs one. If a guide or a prompt tells you to paste one, stop.

Why the agent can't trade yet

The server lists five order tools so that clients can see their shape, but every call is turned away. That holds even with a valid session and the _writeEnabled flag the tools ask for.

We built it this way on purpose. Placing a trade means signing it, and an agent needs its own narrowly scoped key to do that safely. Until that signing path is ready, the alternative would be handing an agent a credential that can do far more than place one order. We won't ship that.

Until then, there are two ways to act on what your agent finds:

  • Trade in the app. Ask the agent for the price, the leverage cap, and the fees, then place the trade yourself in Bloxwap.
  • Build a bot with the SDK. Developers can trade through the Hyperliquid SDK with a dedicated agent wallet. Start with the agent templates and read agent permissions first.

Keep the risk in view

An agent makes it faster to look things up. It does not make a trade safer.

  • Check the numbers. An agent can misread a result or answer from memory instead of calling a tool. Confirm the price and your position in the app before you act.
  • Size small. Leverage magnifies losses as well as gains. The maximum leverage on a market is a limit, not a suggestion.
  • Set a stop. A stop-loss gives you a planned exit, though it can't guarantee a maximum loss. See how to set a stop-loss.
  • Check where you live. Bloxwap isn't available in every country. Connecting an agent doesn't change the terms that apply to you.

Next, read how an agent can use Trend and Swing signals. If you're new to Bloxwap, start with what Bloxwap is.