SSyncDev

MCP Server — MarvelNwachukwu/mcp-pear

MCP server for Pear Protocol: markets, positions, orders, portfolio, and gated trade execution.

Local serverstdio

What is the MCP Server?

MCP server for Pear Protocol: markets, positions, orders, portfolio, and gated trade execution.

The short version

Model Context Protocol (MCP) server for Pear Protocol. Gives Claude, or any MCP-compatible agent, access to markets, pair ratios, positions, orders, trade history, portfolio, and (v0.2) full trade execution on Hyperliquid.

Pear is a Hyperliquid-backed perps platform for pair markets: long one basket against another. Every pair has a live ratio that moves as the legs diverge. More at pearprotocol.io.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_healthAPI health and uptime
list_marketsbrowse pair markets with filters and pagination
get_active_marketstop gainers, losers, and highlighted pairs
get_pair_ratiocurrent ratio, 24h change, and funding for a specific pair
get_account_summaryyour account header
get_open_positionsyour open positions with PnL
get_open_ordersyour open limit, TP, and SL orders
get_twap_ordersyour active TWAP orders
get_trade_historyyour closed trades with realized PnL
get_portfoliobucketed PnL across 1d, 1w, 1m, 1y, and all-time
get_agent_walletthe agent wallet Pear uses to sign your trades
create_agent_walletcreate the agent wallet
set_risk_parametersset or update TP and SL

How to install the MCP Server

{
  "mcpServers": {
    "pear": {
      "command": "npx",
      "args": ["-y", "@marvelcodes/mcp-pear@latest"],
      "env": {
        "PEAR_API_KEY": "your-pear-api-key-here",
        "PEAR_ADDRESS": "0xYourWalletAddress"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
PEAR_API_KEYCredential the server authenticates with.Yes
PEAR_ADDRESSConfiguration value read at startup.Optional
PEAR_REFRESH_TOKENCredential the server authenticates with.Yes
PEAR_API_BASE_URLEndpoint or connection string the server talks to.Yes
PEAR_CLIENT_IDConfiguration value read at startup.Optional

Example prompts to try

  • “Use MCP to get health.”
  • “Use MCP to list markets.”
  • “Use MCP to get active markets.”

Frequently asked questions

MCP server for Pear Protocol: markets, positions, orders, portfolio, and gated trade execution. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.