Construa um agente de trading DeFi com o Pear Protocol e MCP

Se você quer um agente de IA que possa realmente negociar, e não apenas conversar sobre gráficos, o Model Context Protocol (MCP) é a maneira mais limpa de conectar um modelo a uma troca real. Este post constrói um agente de negociação DeFi do Pear Protocol: um que pode navegar pelos mercados de pares, ler suas posições e portfólio, e (quando você ativá-lo) abrir e fechar negociações de pares alavancadas no Hyperliquid.

Usaremos mcp-pear, um servidor MCP de código aberto que envolve a API do Pear Protocol.

O que é o Pear Protocol?

Pear Protocol é uma plataforma apoiada pelo Hyperliquid para negociação de pares. Você vai longo em uma cesta e curto em outra em uma única posição, e lucra com a relação entre elas se movendo a seu favor, independentemente da direção geral do mercado. Exemplo clássico: longo em ETH, curto em BTC se você acha que o ETH terá um desempenho melhor, sem apostar no cripto como um todo.

Pear liquida no Hyperliquid, então cada posição de par é realmente um par de pernas perpétuas executadas na cadeia.

O que é MCP e por que usá-lo aqui?

O Model Context Protocol é um padrão aberto que permite que um LLM chame ferramentas externas através de uma interface uniforme. Em vez de conectar a API REST do Pear ao seu modelo manualmente, você executa um servidor MCP que descreve suas ferramentas para o modelo, e qualquer cliente MCP (Claude Desktop, Cursor, Cline, ou seu próprio agente) pode usá-las.

mcp-pear expõe o Pear como um conjunto de ferramentas MCP:

• Público (sem autenticação): list_markets, get_active_markets, get_pair_ratio, get_health
• Leitura autenticada: get_open_positions, get_open_orders, get_portfolio, get_trade_history, get_account_summary
• Escrita (opt-in): open_position, close_position, adjust_position, adjust_leverage, set_risk_parameters, cancel_order

Passo 1: execute o servidor

Nenhuma instalação necessária. npx busca isso:

npx -y @marvelcodes/mcp-pear@latest

As ferramentas públicas funcionam com zero configuração, então seu agente pode navegar pelos mercados e razões de pares imediatamente.

Passo 2: conecte-o ao Claude Desktop

Adicione isso à sua configuração MCP do Claude Desktop:

{
  "mcpServers": {
    "pear": {
      "command": "npx",
      "args": ["-y", "@marvelcodes/mcp-pear@latest"]
    }
  }
}

Reinicie o Claude e pergunte: "Quais são os principais mercados de pares em alta no Pear agora?" Ele chama get_active_markets e responde com dados ao vivo.

Passo 3: adicione sua conta (ferramentas de leitura)

Para ler suas posições e portfólio, crie uma chave de API do Pear:

npx -y @marvelcodes/mcp-pear@latest setup

Isso abre um navegador, pede que você assine uma vez com sua carteira, e escreve PEAR_API_KEY + PEAR_ADDRESS. Adicione-os à configuração:

{
  "mcpServers": {
    "pear": {
      "command": "npx",
      "args": ["-y", "@marvelcodes/mcp-pear@latest"],
      "env": {
        "PEAR_API_KEY": "sua_chave",
        "PEAR_ADDRESS": "0xsua_endereco"
      }
    }
  }
}

Agora "Como está meu portfólio esta semana?" funciona. Ele chama get_portfolio com seu PnL real.

Passo 4: deixe o agente negociar (com cuidado)

A execução de negociações está desativada por padrão. Você opta por ativá-la intencionalmente:

"env": {
  "PEAR_API_KEY": "sua_chave",
  "PEAR_ADDRESS": "0xsua_endereco",
  "PEAR_TRADE_ENABLED": "true"
}

Com essa flag ativada, o agente pode chamar open_position. Uma negociação de pares se parece com isso: longo em ETH, curto em BTC, 3x, $100 de valor nocional.

{
  "executionType": "MARKET",
  "leverage": 3,
  "usdValue": 100,
  "slippage": 0.01,
  "longAssets":  [{