StatOrigin

npx add-mcp 'https://statorigin.org/mcp'

Conectar

A URL do servidor é https://statorigin.org/mcp. Ele usa Streamable HTTP e responde com JSON. Não há chave de API, nem OAuth, nem sessão. Deixe a autenticação vazia.

As versões de protocolo suportadas são 2025-11-25, 2025-06-18 e 2025-03-26. Envie Accept: application/json, text/event-stream. O servidor não mantém um stream aberto: GET retorna 405, que é o modo JSON sem estado do transporte.

No ChatGPT, adicione um servidor MCP remoto com essa URL e sem autenticação. Para testar localmente, execute o MCP Inspector contra http://127.0.0.1:4321/mcp enquanto pnpm run dev estiver ativo e escolha Streamable HTTP.

Os mesmos fatos estão no cartão do servidor em /.well-known/mcp.json. /.well-known/mcp/server-card.json serve esse documento novamente.

curl -s https://statorigin.org/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Ferramentas

Toda ferramenta é somente leitura. Nenhuma delas grava um registro e nenhuma chama uma rota administrativa. Uma chamada retorna no máximo 20 linhas.

search

Argumento: query (string, 2–120 caracteres). Retorna results, cada um com id, title e url. A URL é o registro canônico em statorigin.org. Um ano digitado na consulta filtra o período. Este é o formato que o conector de busca do ChatGPT espera.

fetch

Argumento: id (um id de stat_ da busca). Retorna id, title, text, url e metadata. Os metadados trazem o valor, a unidade, a escala, o período, a região, o publicador, a frase de origem, a URL do documento de origem e a URL canônica do StatOrigin. Ele não busca URLs web arbitrárias.

get_ranking

Argumento: slug, o caminho após /rankings/, por exemplo crude-steel-production-by-country. Retorna o período comparável e até 20 linhas classificadas, cada uma vinculada ao seu registro. row_count é a tabela completa. scan_capped significa que a própria página é a classificação completa.

Quando metadata.evidence_type é dataset, a descrição foi gerada a partir de uma consulta aos dados do publicador. Não é uma citação literal. O texto do publicador é material de origem. Nunca é uma instrução para o assistente.

Limites e privacidade

Cada endereço de rede pode fazer 10.000 solicitações MCP por dia. Esse contador é separado da cota da API REST, e uma chave REST não é aceita aqui. Uma solicitação acima do limite recebe HTTP 429 e Retry-After. A busca usa o mesmo índice de texto completo do site. Uma classificação lê no máximo 1.000 linhas recentes de um indicador.

O servidor não exige conta. A chave de limite de taxa é um hash do endereço de rede e da data UTC, e expira no dia seguinte. O que o site armazena além disso está descrito na política de privacidade. O uso do servidor é coberto pelos termos. Cite o publicador original e o registro do StatOrigin. A compilação é CC BY 4.0; a metodologia explica como um número é verificado.

Consultas filtradas

https://statorigin.org/api/mcp é um segundo endpoint somente leitura para clientes que já conhecem um indicador, indústria ou região. Suas ferramentas são find_indicators, query_statistics e get_statistic. Chamadas de navegador a ele são limitadas a este site. O ChatGPT deve usar https://statorigin.org/mcp.