Skip to main content
O Model Context Protocol é o padrão que permite a assistentes de IA consultarem sistemas externos. A Nomos opera um servidor MCP hospedado que expõe as mesmas buscas da API como ferramentas que o assistente chama sozinho. Na prática: em vez de escrever código para consultar a API, você pergunta em linguagem natural e o assistente monta a busca, executa e cita os resultados.

​
Ferramentas disponíveis

São 10 ferramentas de busca, somente leitura. Todas são marcadas com readOnlyHint, então a maioria dos clientes consegue aprová-las automaticamente, sem confirmação a cada chamada. Todas aceitam os mesmos parâmetros base descritos em Conceitos de busca — keywords_or, keywords_and, keywords_not, q, modes, page, limit, sort — além dos filtros de cada domínio. Cada resultado traz link_to_nomos_api, também exposto como ResourceLink, e as respostas declaram outputSchema, então o cliente recebe saída estruturada e validada em vez de texto solto.

​
Conectar

O servidor hospedado autentica por X-API-Key — a mesma chave da API REST. Clientes criam e gerenciam chaves em nomos.pro/organization/developers; veja Autenticação.

​
Exemplos de prompt

Depois de conectado, o assistente escolhe a ferramenta sozinho:
  • “Quais proposições sobre reforma tributária estão em tramitação na Câmara?”
  • “Últimas resoluções do Banco Central sobre PIX”
  • “O que a CVM publicou sobre fundos de investimento nos últimos 30 dias?”
  • “Algum diário oficial estadual mencionou licitação de saneamento esta semana?”

​
Execução local

Também é possível rodar o servidor localmente, via transporte stdio, para desenvolvimento ou self-host. Nesse modo a chave vem da variável de ambiente NOMOS_API_KEY:
No transporte HTTP multi-tenant, cada requisição precisa enviar a própria chave no header X-API-Key. O servidor a encaminha isoladamente por requisição, sem vazamento entre chamadas concorrentes; requisições sem o header são recusadas. Há um endpoint de liveness em GET /health.
O código do servidor é aberto: github.com/Nomos-Tech/nomos-mcp.

​
MCP ou API?

Os dois falam com a mesma base. Nada impede usar os dois.