What Do They Know?

whatdotheyknow-mcp

Um servidor Model Context Protocol para pesquisa de Liberdade de Informação no Reino Unido. Conecta assistentes de IA ao WhatDoTheyKnow — a maior plataforma de pedidos FOI do Reino Unido — para buscar pedidos, ler respostas, consultar autoridades públicas e redigir novos pedidos.

Ferramentas

Ferramenta	Descrição
search_request_events	Busca de texto completo de pedidos e respostas FOI via feed Atom do WhatDoTheyKnow. Suporta expressões estruturadas (status:successful, body:"Liverpool City Council").
search_authorities	Busca autoridades públicas do Reino Unido por nome. Retorna slug para uso com outras ferramentas.
get_request_feed_items	Busca a linha do tempo de eventos (enviado, resposta, esclarecimento) de um pedido FOI específico.
get_request_detail	Busca o JSON completo do pedido público, incluindo status, autoridade, solicitante, eventos de correspondência e metadados de anexos quando expostos.
get_user_requests	Lista os pedidos visíveis de um usuário com título, slug, status, autoridade, datas e trechos.
get_user_feed_items	Busca o feed Atom de atividade de um usuário como entradas estruturadas com texto de conteúdo legível.
get_authority_detail	Busca o JSON completo da autoridade pública, incluindo campos de contato/perfil e estatísticas de pedidos.
build_request_url	Constrói uma URL de pedido WhatDoTheyKnow pré-preenchida para uma determinada autoridade e tópico.
create_request_record	Cria um pedido via API de escrita (requer WDTK_API_KEY).
update_request_state	Atualiza o estado avaliado pelo usuário de um pedido (requer WDTK_API_KEY).

Recursos

Modelo de URI	Retorna
wdtk://authorities/{authority_slug}	JSON de perfil da autoridade
wdtk://requests/{request_slug}	JSON de detalhes do pedido FOI
wdtk://users/{user_slug}	JSON de perfil do usuário
wdtk://requests/{request_slug}/feed	Feed Atom de eventos do pedido
wdtk://users/{user_slug}/feed	Feed Atom de atividade do usuário
wdtk://authorities/all.csv	CSV completo de todas as autoridades públicas do Reino Unido

Prompts

Prompt	Descrição
draft_foi_request	Redigir um pedido FOI específico e restrito para uma determinada autoridade e tópico.

Conectar

Hospedado (sem instalação)

{
  "mcpServers": {
    "whatdotheyknow": {
      "type": "http",
      "url": "https://whatdotheyknow-mcp.fly.dev/mcp"
    }
  }
}

Local (uvx)

{
  "mcpServers": {
    "whatdotheyknow": {
      "type": "stdio",
      "command": "uvx",
      "args": ["whatdotheyknow-mcp"]
    }
  }
}

Variáveis de ambiente

Variável	Obrigatória	Descrição
WDTK_API_KEY	Opcional	Habilita as ferramentas de escrita create_request_record e update_request_state

API upstream e licença

Fonte	API	Licença	Autenticação
WhatDoTheyKnow	www.whatdotheyknow.com	OGL v3	Nenhuma (leitura) / chave de API (escrita)

Os dados são obtidos diretamente da API pública do WhatDoTheyKnow. A plataforma é operada pela mySociety.