Genesis Arbitrage

Genesis Arbitrage · · 3 min de leitura

MCP (Model Context Protocol)

MCP (Model Context Protocol) é um protocolo aberto pelo qual aplicações de IA se conectam a dados e ferramentas externos: arquivos, bancos de dados, APIs. A Anthropic o abriu em código aberto em novembro de 2024 e, em dezembro de 2025, o doou à Agentic AI Foundation, um fundo dirigido dentro da Linux Foundation.

Como o MCP funciona

A aplicação de IA, chamada de host, cria um cliente MCP para cada servidor ao qual se conecta. Um servidor MCP é um programa que expõe tools (funções que o modelo pode chamar), resources (dados para o contexto) e prompts (modelos de prompt). As mensagens usam JSON-RPC 2.0, e o transporte é stdio para um servidor local ou Streamable HTTP para um remoto (documentação do MCP).

O cliente lista as tools com uma requisição tools/list e chama uma com tools/call, passando o nome e os argumentos. Cada tool tem um name, uma description e um inputSchema, o JSON Schema dos seus argumentos.

MCP sobre uma REST API

Um servidor MCP de dados de mercado costuma ser uma camada fina sobre uma REST API: uma tool, uma requisição HTTP. A chave de API fica no ambiente do servidor e viaja só no cabeçalho da requisição (autenticação); o modelo vê apenas a descrição da tool e a resposta.

A Genesis API não tem servidor MCP oficial. O wrapper você escreve; aqui está um mínimo com o SDK oficial de Python (o pacote mcp, versão 2.0 ou superior, mais requests):

import os

import requests
from mcp.server import MCPServer

API = "https://api.genesisarbitrage.com/v1"
mcp = MCPServer("genesis-funding")


@mcp.tool()
def funding_rates(coin: str) -> str:
    """Taxas de funding de uma moeda nas exchanges (Genesis API).

    Args:
        coin: ticker da moeda, por exemplo BTC
    """
    r = requests.get(
        f"{API}/funding/rates",
        headers={"X-API-Key": os.environ["GENESIS_API_KEY"]},
        params={"coin": coin.upper()},
        timeout=10,
    )
    return r.text  # JSON: data e meta, ou error com um código


if __name__ == "__main__":
    mcp.run(transport="stdio")

Um assistente compatível com MCP inicia esse arquivo como servidor local (o comando de inicialização vai nas configurações dele) e ganha uma tool funding_rates: as taxas de funding de uma moeda nas exchanges, vindas de /funding/rates.

Veja também: function calling, OpenAPI, chave de API, dados de mercado cripto para agentes de IA, Genesis API para agentes de IA.

Perguntas e respostas

Qual a diferença entre MCP e function calling?

Function calling é um recurso da API de um modelo: a aplicação envia as descrições das tools junto com a requisição e executa as chamadas por conta própria. MCP é um protocolo entre a aplicação e um servidor de tools, então um mesmo servidor funciona com qualquer cliente compatível com MCP. Dentro da aplicação, as tools dos servidores MCP continuam chegando ao modelo por function calling.