XGR.Network MCP

XGR.Network MCP é um conector para a XGRChain e o mecanismo de processos on-chain XDaLa, permitindo que agentes de IA acessem dados da cadeia, inspecionem atividades de processos e preparem ações seguras de fluxo de trabalho para assinatura de carteira controlada pelo usuário.

GitHubExperimente este MCPPatrocinado

Documentação

XGR MCP Gateway

XGR MCP Gateway fornece acesso nativo por IA à pilha XGR.Network por meio do Model Context Protocol. Ele conecta agentes compatíveis com MCP, como Claude, ChatGPT, assistentes de IDE e hosts personalizados, ao XGRChain, sessões XDaLa, dados do Explorer, padrões XRC e preparação de ações on-chain revisadas pelo proprietário.

O gateway é projetado para criação de fluxos de trabalho assistidos por agentes: os agentes podem inspecionar evidências de cadeia ao vivo, raciocinar sobre o estado do processo XDaLa, redigir artefatos XRC e preparar transferências (handoffs) que o usuário revisa e assina localmente.

O gateway nunca solicita, recebe, armazena ou controla chaves privadas de usuários ou terceiros e não pode assinar em nome dos usuários. As intenções de escrita do usuário são preparadas como transferências e assinadas localmente. Um serviço opcional de gás inicial pode usar uma chave de financiamento dedicada controlada pelo servidor exclusivamente para enviar concessões fixas de gás XGR da carteira do serviço.

Endpoints MCP públicos

Mainnet:

https://mcp.xgr.network/mcp

Testnet:

https://mcp.testnet.xgr.network/mcp

Use a mainnet para inspecionar atividades reais do XGRChain e XDaLa. Use a testnet para redigir, validar e experimentar com segurança fluxos de trabalho orientados por agentes antes do uso em produção.

Configuração do cliente MCP

{
  "mcpServers": {
    "xgr-mainnet": {
      "type": "streamable-http",
      "url": "https://mcp.xgr.network/mcp"
    },
    "xgr-testnet": {
      "type": "streamable-http",
      "url": "https://mcp.testnet.xgr.network/mcp"
    }
  }
}

Para clientes que ainda esperam http em vez de streamable-http, use a mesma URL de endpoint e selecione o transporte MCP HTTP/remoto oferecido pelo seu cliente.

O que os agentes podem fazer

  • Ler estado da cadeia: inspecionar status ao vivo do XGRChain, blocos, estado de contas e evidências de transações.
  • Descobrir recursos oficiais do XGR: usar get_xgr_network_info para metadados canônicos de XGR.Network, XGRChain, XDaLa, RPC, Explorer, MCP, documentação e ecossistema.
  • Inspecionar sessões XDaLa: encontrar, listar e explicar sessões, etapas de processo, cargas úteis, recibos e resultados de execução.
  • Pesquisar dados do Explorer: consultar histórico de contas, transferências de valor, histórico de blocos, estatísticas de transações e análises de sessões.
  • Trabalhar com padrões XRC: explorar regras XRC-137, orquestrações XRC-729, grafos de processo, padrões de reutilização e análises de falhas.
  • Redigir artefatos de processo: preparar artefatos e pacotes XRC-137/XRC-729 com base em esquemas e regras de validação integrados.
  • Preparar ações assinadas pelo proprietário: criar transferências de revisão e assinatura para implantações e inícios de sessão sem expor chaves privadas.
  • Solicitar gás inicial onde habilitado: financiar um endereço elegível com saldo baixo com uma concessão fixa de 1 XGR antes de implantações, inícios de sessão, chamadas de contrato ou outras ações on-chain.

Metadados oficiais da rede

get_xgr_network_info retorna metadados versionados e legíveis por máquina para XGR.Network e seu ecossistema. Os agentes devem usá-lo quando os usuários solicitarem informações oficiais do projeto, configuração de rede, endpoints RPC ou Explorer, detalhes de conexão MCP, documentação, contexto de padrões XRC ou repositórios de código-fonte.

get_chain_status permanece como a ferramenta de status JSON-RPC ao vivo e adicionalmente retorna pontos de entrada oficiais compactos para a mainnet XGRChain conectada.

Por que XGR.Network MCP

XGR.Network MCP é construído em torno de infraestrutura de processo determinística, em vez de automação genérica de chat. Ele dá aos agentes acesso estruturado à pilha XGR, mantendo a assinatura do usuário, a custódia do usuário e a aprovação final fora do gateway.

Isso o torna adequado para:

  • Design de fluxos de trabalho Web3 assistidos por IA
  • Preparação e inspeção de processos XDaLa
  • Evidências de processo orientadas à conformidade
  • Fluxos de execução e validação determinísticos
  • Automação de processos compatível com EVM
  • Interfaces de agente para dados XGRChain e padrões XRC

Documentação

A referência completa está na documentação central do XGR:

Auto-hospedagem

O gateway pode ser operado contra sua própria instância de RPC e Explorer do XGRChain. A auto-hospedagem requer uma implantação do Explorer com um espelho Postgres somente leitura para busca de transações e ferramentas de análise de sessões.

Fluxo típico de configuração:

npm install
npm run typecheck
npm run build
npm run start:http

A configuração de runtime necessária está documentada em Configuração e Instalação.

Modelo de segurança

  • O gateway nunca solicita, recebe, armazena ou controla chaves privadas de usuários ou terceiros.
  • As transações do usuário são preparadas como transferências e assinadas localmente pelo usuário ou pela configuração de custódia do usuário.
  • O serviço opcional de gás inicial é uma exceção restrita: ele assina apenas transferências de uma carteira de financiamento dedicada controlada pelo servidor e não pode assinar em nome dos usuários.
  • As concessões de gás inicial são fixadas em 1 XGR, limitadas pelo saldo do destinatário, uma concessão confirmada por endereço, limites horários e diários, e uma política de repetição limitada.
  • O estado das concessões de gás inicial é armazenado atomicamente em SQLite com estados reserved, broadcast, confirmed e failed.
  • A assinatura do usuário em produção permanece sob o controle da carteira ou configuração de custódia do usuário.

Links

Licença

Licenciado sob a Apache License 2.0.

Ferramentas de compra de XGR na mainnet

As ferramentas opcionais de compra são somente mainnet, desabilitadas por padrão e nunca registradas na testnet. Habilite-as apenas com XGR_PURCHASE_TOOLS_ENABLED=true, XGR_PURCHASE_NETWORK=mainnet, uma URL de API HTTPS válida (ou HTTP local) e um máximo igual ou inferior a 249.99 EUR.

quote_xgr_purchase é apenas planejamento opcional. create_xgr_purchase_order cria o pedido real em uma única chamada a POST /api/orders; o modal de confirmação do site não é uma fase separada da API. O backend é a autoridade para o preço final, quantidade de criptoativos, carteira de custódia, referência de pagamento e reserva. O MCP não detém chaves privadas de usuários ou terceiros e não paga; um agente de carteira externo pode executar a instrução exata de pagamento retornada.

O máximo de 249,99 EUR é uma política do MCP para pedidos autônomos. Separadamente, o backend XGR_Web exige um endereço de cobrança completo de um net_eur >= 250 recém-calculado; não é um máximo de pedido do backend. Um erro de redefinição de preço/endereço do backend é retornado sem repetir o pedido.

As ferramentas de compra distinguem pedidos fixos de XGR de pedidos conservadores com orçamento em USDC/USDT. O POST ao backend ao vivo determina o preço de mercado vinculante e o amount_crypto exato; EUR é apenas um valor de política/referência. Um pedido com orçamento cujo valor exato retornado exceda seu limite não é pago e sua reserva existente expira normalmente.

Ferramentas de gás inicial

Onde habilitado, get_xgr_starter_gas_options expõe a concessão fixa atual e a política de elegibilidade. request_xgr_starter_gas envia uma concessão fixa de 1 XGR de uma carteira de serviço dedicada para um endereço EVM elegível com saldo baixo. Os agentes devem usá-lo antes de implantações, inícios de sessão, chamadas de contrato ou outras ações on-chain quando o endereço de destino não tiver XGR nativo para gás.

O serviço não solicita prova de propriedade do endereço e não usa prova de trabalho. O abuso é limitado por uma concessão confirmada por endereço, um limite horário, um limite diário, elegibilidade por saldo do destinatário, uma carteira de serviço com saldo baixo e um número limitado de repetições após falhas de pré-transmissão.