Servidor MCP

O NETTS publica sua documentação como um servidor MCP, para que um agente de IA possa pesquisar esses documentos e a própria especificação da API em vez de adivinhar ou receber um despejo de texto bruto de 700 KB.

https://doc.netts.io/mcp

O servidor é somente leitura. Ele não sabe nada sobre sua conta, chaves ou saldo — apenas o que está publicado neste site.

Um segundo servidor separado é uma linha direta com o NETTS para agentes de IA:

https://doc.netts.io/feedback/mcp

Não apenas sobre a documentação. Pergunte como o serviço realmente se comporta, o que um endpoint realmente retorna, como Energy, Bandwidth, delegação e staking de TRON funcionam na prática, como interagir com TRC-20 e outros contratos inteligentes. Relate erros, proponha funcionalidades, levante questões de segurança. Uma pessoa lê e escreve a resposta.

Dois servidores em vez de um, de propósito. O servidor de documentação permanece somente leitura, para que um host possa permitir que um modelo pesquise a documentação livremente; este tem efeitos colaterais — ele armazena seu texto e o exibe para pessoas — e deve solicitar confirmação ao usuário antes de ser chamado.

O que o agente recebe

Ferramenta	O que faz
search_docs	Pesquisa de texto completo nas páginas de documentação
get_doc	Markdown completo de uma página
list_docs	Índice de cada página
search_api	Pesquisa operações da API v2 do NETTS
get_endpoint	Parâmetros, esquemas, respostas e códigos de erro de uma operação
get_openapi_schema	Um esquema reutilizável da especificação

O blog é deliberadamente não indexado: são artigos para pessoas e, para um agente, eles são ruído.

Perguntando ao NETTS

Qualquer coisa que a documentação não resolva. Uma pessoa lê e escreve a resposta; nada é gerado, e nada do que você envia altera o serviço ou a documentação por si só.

Ferramenta	O que faz
ask_netts	Envia uma pergunta, relatório ou proposta para a equipe do NETTS, retorna feedback_id e access_token
get_answer	Retorna o status e, assim que escrita, a resposta

Escolha um kind para que a mensagem chegue à pessoa certa:

kind	Use para
question	Como o serviço funciona, o que um endpoint realmente retorna, Energy e Bandwidth de TRON, delegação, staking, TRC-20 e outros contratos
documentation_error	Algo em uma página está errado
missing_information	Algo importante não está documentado
suggestion	Uma ideia para melhorar o serviço ou a API
security	Uma preocupação de segurança ou uma recomendação

Como funciona:

1. Chame ask_netts com sua mensagem, uma idempotency_key aleatória e — quando a pergunta for sobre uma página ou operação específica — doc_path ou operation_id. Esses valores são validados em relação à versão publicada, portanto use os valores fornecidos pelo servidor de documentação; omita-os para perguntas gerais.
2. Você recebe de volta um feedback_id, um access_token, um tempo estimado de resposta e poll_after_seconds. Guarde o token: ele é a única chave para a resposta.
3. Volte mais tarde com get_answer. Até que uma pessoa tenha respondido, o status será new ou in_review.

Reenviar a mesma idempotency_key com o mesmo corpo retorna o mesmo registro em vez de criar um segundo, portanto uma conexão interrompida não gera custos.

Antes de chamar. O texto vai para pessoas no NETTS. Pergunte ao usuário primeiro, e nunca inclua chaves de API, segredos, dados pessoais ou de conta: não é preciso ter conta, a resposta vai para quem tiver o token de acesso e, pelo mesmo motivo, uma resposta nunca contém informações privadas ou específicas de uma conta. Para qualquer assunto vinculado a uma conta ou pedido específico, use os canais normais de suporte.

Não há webhooks: você mesmo busca a resposta. Não é preciso ter conta, e o canal tem limite de taxa. As solicitações são registradas com o endereço IP para prevenir abusos; os registros são mantidos por 90 dias.

Conectar

Cursor e VS Code — use os itens Connect to Cursor e Connect to VS Code no menu na parte superior de qualquer página da documentação. Eles instalam o servidor em um clique.

Claude Code

claude mcp add --transport http netts-docs https://doc.netts.io/mcp

Qualquer outro — o transporte é Streamable HTTP, sem autenticação. Adicione ambos os servidores: o de documentação e o de feedback, se quiser ter a capacidade de fazer perguntas.

{
  "mcpServers": {
    "netts-docs": {
      "type": "http",
      "url": "https://doc.netts.io/mcp"
    },
    "netts-docs-feedback": {
      "type": "http",
      "url": "https://doc.netts.io/feedback/mcp"
    }
  }
}

Para o Claude Code, o segundo é:

claude mcp add --transport http netts-docs-feedback https://doc.netts.io/feedback/mcp

Sem MCP

Se a sua ferramenta não suporta MCP, o mesmo conteúdo está disponível como arquivos simples:

• /llms.txt — índice estruturado da documentação
• /llms-full.txt — toda a documentação em um único arquivo
• /openapi.yaml — a especificação da API
• qualquer página com .md adicionado ao final, por exemplo /api/v2/endpoints/order1h.md