MCP Paradex Server

Instructions

Implementation Reference

• src/mcp_paradex/tools/vaults.py:123-148 (handler)

  The handler function decorated with @server.tool that implements the paradex_vault_balance tool. It fetches vault balance data from the Paradex API, validates it using the VaultBalance model, and returns the list of balances.
  @server.tool(name="paradex_vault_balance") async def get_vault_balance( vault_address: Annotated[ str, Field(description="The address of the vault to get balance for.") ], ) -> list[VaultBalance]: """ Get the current balance of a specific vault. Retrieves the current balance information for a specific vault, including available funds, locked funds, and total balance. This is essential for understanding the financial state of a vault before executing trades or withdrawals. """ try: client = await get_paradex_client() response = await api_call(client, "vaults/balance", params={"address": vault_address}) if "error" in response: raise Exception(response["error"]) results = response["results"] balances = vault_balance_adapter.validate_python(results) return balances except Exception as e: logger.error(f"Error fetching balance for vault {vault_address}: {e!s}") raise e
• src/mcp_paradex/models.py:265-271 (schema)

  Pydantic model defining the output schema for vault balances, used for validation in the tool handler.
  class VaultBalance(BaseModel): """Model representing the balance of a vault.""" token: Annotated[str, Field(description="Name of the token")] size: Annotated[str, Field(description="Balance amount of settlement token")] last_updated_at: Annotated[int, Field(description="Balance last updated time")]