qlows MCP - Tender Search & RFP Response

Encontre licitações públicas em 35 países (Zona WTO-GPA) e fundamente sua IA ao responder a RFPs.

Documentação

Conector qlows MCP

Traga seus negócios RFP/licitação ao vivo do qlows — e o corpus público de licitações em 35 países do Acordo de Compras Governamentais da OMC — para o Claude, Cursor, Windsurf, Cline, Zed ou qualquer cliente Model Context Protocol.

qlows-mcp é um pequeno conector local. Ele roda na sua máquina como um servidor MCP stdio e faz proxy seguro das chamadas de ferramentas para a API do qlows (https://app.qlows.com). Ele não armazena nada além do seu token, não contém lógica de backend e é somente leitura — sua IA pode obter contexto de negócios, nunca escrever de volta.

Cotações. Fluxos. Fechamento. O qlows prepara a proposta; sua IA rascunha a partir de contexto real e fundamentado. Saiba mais em https://qlows.com.

Instalação

Instalação com um clique para os clientes comuns (ou copie o trecho JSON abaixo):

Início rápido (≈ 1 minuto)

# 1. Connect your account (opens the browser, you paste a token back)
npx @qlows/mcp login

# 2. Verify it works
npx @qlows/mcp test          # → prints the available tools

# 3. Print the snippet for your AI client
npx @qlows/mcp config

Depois adicione o qlows ao seu cliente (exemplo: Claude Desktop, ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "qlows": {
      "command": "npx",
      "args": ["-y", "@qlows/mcp"]
    }
  }
}

Reinicie o cliente. Se você não executou login, passe o token:

{
  "mcpServers": {
    "qlows": {
      "command": "npx",
      "args": ["-y", "@qlows/mcp"],
      "env": { "QLOWS_TOKEN": "qlw_live_…" }
    }
  }
}

Você precisará de uma conta qlows para gerar um token pessoal (o plano gratuito funciona para busca de licitações). Cadastre-se e gere o token em https://app.qlows.com/mcp.

Experimente estes prompts

Após conectar, pergunte à sua IA:

"Use o qlows MCP para listar meus negócios abertos e resuma os 3 principais riscos no mais urgente."
"Busque licitações públicas de redes Zero-Trust na UE com encerramento nos próximos 30 dias e me dê o link do qlows para cada uma."
"Leia o negócio <deal-id> do qlows e rascunhe a seção de Abordagem Técnica, fundamentando cada afirmação nos itens de conformidade e nas nossas respostas aprovadas."

O que você obtém

Todas as ferramentas são somente leitura. Ferramentas de dados pessoais precisam de um token pessoal; as ferramentas de licitações também funcionam em uma conta gratuita.

Ferramenta	O que faz
`list_deals`	Seus negócios RFP/licitação (metadados leves)
`get_deal_snapshot`	Visão completa do negócio — resumo do RFP + conformidade + roteamento de Q + inteligência
`search_compliance_items`	Busca por palavras-chave nos itens de conformidade
`get_q_routing_state`	Seções + perguntas + respostas + estado de atribuição
`get_intelligence_summary`	Resumo de IA + detecção de personalização
`list_questions`	Lista plana de perguntas
`list_competitors`	Análise de concorrentes por negócio
`search_tenders`	Busca no corpus público de licitações (FTS + filtros)
`search_tenders_for_my_company`	Busca semântica personalizada de licitações
`get_tender_detail`	Registro completo enriquecido para uma licitação

Além de três prompts (comandos de barra) — find_matching_tenders, draft_rfp_section, weekly_pipeline_review — veja Skills abaixo.

O conector descobre ferramentas e prompts ao vivo do servidor, então novas capacidades do qlows aparecem sem atualizar este pacote.

Skills

Três coisas que o qlows foi feito para fazer dentro da sua IA. Cada uma mapeia para um prompt (um comando de barra que seu cliente expõe) além das ferramentas somente leitura que ele aciona — tudo fundamentado em dados reais do qlows, nunca inventado.

🔎 Encontre licitações correspondentes

Prompt: find_matching_tenders (args: industry, opcional country, opcional deadline_within_days). Aciona search_tenders e retorna cada aviso ativo com seu qlows_url canônico. Contexto completo: https://qlows.com/platform/qlows-mcp.

"Encontre licitações abertas de redes zero-trust na Alemanha com encerramento nos próximos 30 dias, com o link do qlows para cada uma."

✍️ Rascunhe uma seção de RFP, fundamentada

Prompt: draft_rfp_section (args: deal_id, section). Puxa a grade de conformidade do negócio e as respostas aprovadas via get_deal_snapshot + search_compliance_items, depois rascunha a seção com cada afirmação rastreada até a fonte — sem capacidades, datas ou desempenho passado fabricados.

"Rascunhe a Abordagem Técnica para o negócio <id>, fundamentada nos itens de conformidade e nas nossas respostas aprovadas."

🗂️ Revise seu pipeline

Prompt: weekly_pipeline_review (sem args). Usa list_deals + get_q_routing_state para produzir uma lista de tarefas priorizada: o que vence, o que está bloqueado e a próxima ação por negócio.

"Revise meu pipeline do qlows e me diga quais propostas precisam de atenção primeiro."

As skills de licitações públicas funcionam em uma conta gratuita; as skills de negócios precisam de um token pessoal. Veja a visão geral completa da plataforma.

Comandos

Comando	Descrição
`qlows-mcp`	Executa o servidor MCP via stdio (como os clientes o iniciam)
`qlows-mcp login`	Entra via navegador e armazena um token em `~/.qlows/config.json` (0600)
`qlows-mcp test`	Lista as ferramentas disponíveis para verificar seu token
`qlows-mcp config`	Mostra o caminho da configuração + um trecho de configuração do cliente
`qlows-mcp help`	Uso

Variáveis de ambiente

QLOWS_TOKEN — token da API (substitui o armazenado).
QLOWS_BASE_URL — padrão é https://app.qlows.com; aponte para http://localhost:3000 para testes locais.

Como funciona

MCP client (Claude/Cursor)  ⇄  qlows-mcp (stdio, local)  ⇄  https://app.qlows.com/api/mcp/<token>/rpc

O conector é um proxy JSON-RPC transparente. Ele não implementa ferramentas — ele encaminha initialize, tools/list, tools/call, prompts/* e resources/* para o servidor qlows e retransmite as respostas. O token viaja na requisição para o qlows via HTTPS; trate-o como uma senha.

Solução de problemas

No qlows token found — execute qlows-mcp login, ou defina QLOWS_TOKEN.
Token missing, invalid, or expired — o token foi revogado ou expirou; gere um novo em https://app.qlows.com/mcp e execute novamente login.
Rate limit exceeded — 60 requisições/min por token; aguarde e tente novamente.
O cliente não vê qlows — reinicie o cliente após editar a configuração; valide o JSON (uma vírgula solta quebra silenciosamente); verifique os logs de MCP do cliente.

Verifique de ponta a ponta com o MCP Inspector:

npx @modelcontextprotocol/inspector npx @qlows/mcp

Privacidade e segurança

Somente leitura: nenhuma ferramenta escreve de volta na sua conta qlows.
O conector armazena apenas seu token, localmente, em ~/.qlows/config.json (permissões 0600). Ele não coleta telemetria.
Tokens são hash SHA-256 em repouso no servidor qlows e podem ser revogados instantaneamente em https://app.qlows.com/mcp.
Política de privacidade: https://qlows.com/privacy

Roadmap

Captura automática no navegador com um clique para login (callback de loopback).
Extensão de Desktop (.mcpb) para uma instalação verdadeira de um clique no Claude Desktop (o selo acima aponta para a documentação de configuração por enquanto).
Listagem no Diretório de Conectores da Anthropic — o endpoint OAuth 2.1 + PKCE está ativo no servidor qlows; o envio para o diretório é acompanhado como follow-up.

Desenvolvimento

npm install
npm run build
QLOWS_TOKEN=… QLOWS_BASE_URL=http://localhost:3000 node dist/index.js test

A publicação é automatizada em tags v* (veja .github/workflows/release.yml): npm publish → publicação no Registro MCP via GitHub OIDC.

##Selos

Licença

MIT