Pear Protocol MCP server — pair-trading perps on Hyperliquid for Claude & AI agents. Markets, positions, orders, portfolio, and gated trade execution.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add pear --env PEAR_API_KEY='<PEAR_API_KEY>' --env PEAR_JWT='<PEAR_JWT>' --env PEAR_REFRESH_TOKEN='<PEAR_REFRESH_TOKEN>' -- npx -y @marvelcodes/mcp-pear~/.codex/config.toml
[mcp_servers.pear]
command = "npx"
args = ["-y", "@marvelcodes/mcp-pear"]
env = { PEAR_API_KEY = "<PEAR_API_KEY>", PEAR_JWT = "<PEAR_JWT>", PEAR_REFRESH_TOKEN = "<PEAR_REFRESH_TOKEN>" }
# codex mcp add pear --env PEAR_API_KEY='<PEAR_API_KEY>' --env PEAR_JWT='<PEAR_JWT>' --env PEAR_REFRESH_TOKEN='<PEAR_REFRESH_TOKEN>' -- npx -y @marvelcodes/mcp-pear~/.cursor/mcp.json
{
"mcpServers": {
"pear": {
"command": "npx",
"args": [
"-y",
"@marvelcodes/mcp-pear"
],
"env": {
"PEAR_API_KEY": "<PEAR_API_KEY>",
"PEAR_JWT": "<PEAR_JWT>",
"PEAR_REFRESH_TOKEN": "<PEAR_REFRESH_TOKEN>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"pear": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@marvelcodes/mcp-pear"
],
"env": {
"PEAR_API_KEY": "<PEAR_API_KEY>",
"PEAR_JWT": "<PEAR_JWT>",
"PEAR_REFRESH_TOKEN": "<PEAR_REFRESH_TOKEN>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"pear": {
"command": "npx",
"args": [
"-y",
"@marvelcodes/mcp-pear"
],
"env": {
"PEAR_API_KEY": "<PEAR_API_KEY>",
"PEAR_JWT": "<PEAR_JWT>",
"PEAR_REFRESH_TOKEN": "<PEAR_REFRESH_TOKEN>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"pear": {
"command": "npx",
"args": [
"-y",
"@marvelcodes/mcp-pear"
],
"env": {
"PEAR_API_KEY": "<PEAR_API_KEY>",
"PEAR_JWT": "<PEAR_JWT>",
"PEAR_REFRESH_TOKEN": "<PEAR_REFRESH_TOKEN>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"pear": {
"command": "npx",
"args": [
"-y",
"@marvelcodes/mcp-pear"
],
"env": {
"PEAR_API_KEY": "<PEAR_API_KEY>",
"PEAR_JWT": "<PEAR_JWT>",
"PEAR_REFRESH_TOKEN": "<PEAR_REFRESH_TOKEN>"
}
}
}
}Environment variables
PEAR_API_KEYPEAR_JWTPEAR_REFRESH_TOKEN
Replace the placeholders with your own credentials and keep them out of version control.