MCP Paradex Server

Instructions

Get the current best available prices for immediate execution decisions.

Use this tool when you need to:
- Make quick trading decisions without full orderbook depth
- Calculate current spread costs before placing orders
- Monitor real-time price changes efficiently
- Get a snapshot of current market conditions
- Determine fair mid-price for calculations

The BBO provides the most essential price information with minimal data,
perfect for quick decisions or when full orderbook depth isn't needed.

Example use cases:
- Calculating current trading spreads before placing orders
- Monitoring real-time price movements efficiently
- Determining execution prices for immediate market orders
- Calculating mid-price for order placement strategies
- Setting appropriate limit order prices to improve fill chances

Implementation Reference

• src/mcp_paradex/tools/market.py:480-518 (handler)

  Handler function for paradex_bbo tool. Fetches BBO data from Paradex client, validates with BBO model, and formats response with schema.

  @server.tool(name="paradex_bbo")
  async def get_bbo(
      market_id: Annotated[str, Field(description="Market symbol to get BBO for.")],
      ctx: Context = None,
  ) -> dict:
      """
      Get the current best available prices for immediate execution decisions.
  
      Use this tool when you need to:
      - Make quick trading decisions without full orderbook depth
      - Calculate current spread costs before placing orders
      - Monitor real-time price changes efficiently
      - Get a snapshot of current market conditions
      - Determine fair mid-price for calculations
  
      The BBO provides the most essential price information with minimal data,
      perfect for quick decisions or when full orderbook depth isn't needed.
  
      Example use cases:
      - Calculating current trading spreads before placing orders
      - Monitoring real-time price movements efficiently
      - Determining execution prices for immediate market orders
      - Calculating mid-price for order placement strategies
      - Setting appropriate limit order prices to improve fill chances
      """
      try:
          # Get BBO from Paradex
          client = await get_paradex_client()
          response = client.fetch_bbo(market_id)
          bbo = BBO(**response)
          results = {
              "description": BBO.__doc__.strip() if BBO.__doc__ else None,
              "fields": BBO.model_json_schema(),
              "results": bbo,
          }
          return results
      except Exception as e:
          await ctx.error(f"Error fetching BBO for {market_id}: {e!s}")
          raise e

• src/mcp_paradex/models.py:23-35 (schema)

  Pydantic model defining the input/output schema for BBO data used by the paradex_bbo tool.

  class BBO(BaseModel):
      """Best Bid and Offer model for a market."""
  
      market: Annotated[str, Field(description="Symbol of the market")]
      seq_no: Annotated[int, Field(description="Sequence number of the orderbook")]
      ask: Annotated[float, Field(description="Best ask price")]
      ask_size: Annotated[float, Field(description="Best ask size")]
      bid: Annotated[float, Field(description="Best bid price")]
      bid_size: Annotated[float, Field(description="Best bid size")]
      last_updated_at: Annotated[
          int, Field(description="Last update to the orderbook in milliseconds")
      ]

• src/mcp_paradex/tools/market.py:480-480 (registration)

  Registration of the paradex_bbo tool using the @server.tool decorator.

  @server.tool(name="paradex_bbo")