Quidli Connect

Resolva qualquer identificador social para uma carteira, verifique a reputação a partir do histórico público e envie tokens — de qualquer cliente MCP.

GitHub

Documentação

Quidli Connect MCP

Pagamentos abertos para agentes multiplayer, alimentados por reputação onchain. Resolva um identificador social para uma carteira, verifique sua reputação onchain e envie tokens — a partir do Cursor, Claude Desktop, Claude Code ou qualquer cliente compatível com MCP.

Multiplayer significa partes que ainda não se conhecem — um agente pagando uma pessoa, ou outro agente, sem relacionamento prévio e sem conta para recorrer. Connect é como ele verifica com quem está lidando antes de enviar qualquer coisa.

Repositório público: github.com/Quidli/connect-mcp

Experimente em um comando

Nenhuma chave de API necessária.

Claude Code:

claude mcp add --transport http quidli https://mcp.connect.quid.li/

Cursor: Adicionar ao Cursor (ou cole esse link em Configurações → MCP → Adicionar novo servidor MCP)

Claude Desktop: Configurações → Conectores → Adicionar conector personalizado, URL https://mcp.connect.quid.li

Local (qualquer cliente) — roda na sua máquina em vez do endpoint hospedado:

npx -y @quidli/connect-mcp

Veja Escolha como conectar abaixo para chaves de API, pagamento por chamada com carteira x402 e trechos de configuração completos.

Depois pergunte ao seu agente:

Resolva o identificador do GitHub justinquidli para uma carteira.

{
  "status": "completed",
  "results": [
    {
      "type": "github",
      "value": "justinquidli",
      "ethWalletAddress": "0x6a48ADE3bE3F9f0b8B4c9af61Bb654A219311699",
      "solWalletAddress": "9DD2CqPKZJoo7ZRgCXxJNMjhzfgVihSKtkZpn8qnEWK9"
    }
  ]
}

Resolve em GitHub, X, Telegram, Discord, LinkedIn, Farcaster, e-mail e telefone — e gera uma carteira para pessoas que nunca usaram Quidli.

Depois avalie o que encontrar: connect_scores_batch retorna reputação onchain para um lote de identidades.

Consulta, pontuações e preço funcionam sem chave sob uma cota anônima compartilhada. Adicione uma chave de API Connect para limites maiores, seu próprio perfil (connect_me) e Smart Send.

Escolha como conectar

	Hospedado (`mcp.connect.quid.li`)	Local (`npx @quidli/connect-mcp`)
Configuração	Adicione uma URL nas configurações do MCP	Execute um processo local via `npx`
Autenticação	Chave de API opcional. Sem chave: consulta/pontuações sob cota anônima compartilhada; preço/cadeias são públicos	Chave de API, pagamento por chamada x402, ou nenhuma para consulta/pontuações
Prós	Sem instalação; experimente sem chave; sempre na infraestrutura Quidli	A chave privada da carteira nunca sai da sua máquina; pague por chamada com USDC em vez de chave de API
Contras	Tráfego anônimo compartilha um limite global de taxa; sem cobrança por chamada	Requer Node.js 20+; `npx` pode baixar o pacote na primeira execução
Limitações	Não pode usar x402 / autenticação por carteira — não envie uma chave privada para o endpoint hospedado	O modo x402 precisa de USDC na Base (mainnet `8453`); `connect_drop` requer uma chave de API

Obtenha uma chave de API Connect em connect.quid.li → Ativar acesso à API para limites maiores, connect_me e Smart Send.

Hospedado (recomendado)

Zero configuração local. Consulta, pontuações, agente e preço funcionam sem chave de API (cota anônima compartilhada). Adicione uma chave para limites maiores, seu perfil (connect_me) e Smart Send.

Cursor

Se você já tem outros servidores MCP: pule o deeplink e adicione manualmente — a instalação com um clique pode sobrescrever todo o seu mcp.json em algumas versões do Cursor.

Adicionar ao Cursor

Ou cole em Configurações do Cursor → MCP → Adicionar novo servidor MCP:

cursor://anysphere.cursor-deeplink/mcp/install?name=quidli-connect&config=eyJ1cmwiOiJodHRwczovL21jcC5jb25uZWN0LnF1aWQubGkifQ==

Adicionar manualmente {#cursor-manual}

Mescle isso em ~/.cursor/mcp.json (global) ou .cursor/mcp.json (projeto) sob mcpServers — não substitua suas entradas existentes:

"quidli-connect": {
  "url": "https://mcp.connect.quid.li"
}

Opcional — limites maiores e Smart Send:

"quidli-connect": {
  "url": "https://mcp.connect.quid.li",
  "headers": {
    "x-api-key": "<your-connect-api-key>"
  }
}

Claude Desktop

Abra Claude → Configurações → Conectores (ou Configurações → Desenvolvedor → Editar Configuração em versões mais antigas).
Adicione um conector MCP personalizado com URL https://mcp.connect.quid.li. Opcionalmente, defina o cabeçalho x-api-key: <your-connect-api-key>.

Ou mescle isso no seu arquivo de configuração e reinicie o Claude:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "quidli-connect": {
      "url": "https://mcp.connect.quid.li"
    }
  }
}

Se a sua versão do Claude não suporta conectores url remotos, use a ponte local (ainda API hospedada, executa um pequeno auxiliar local):

{
  "mcpServers": {
    "quidli-connect": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "--http",
        "https://mcp.connect.quid.li"
      ]
    }
  }
}

Requer Node.js 20+ para a ponte. Reinicie o Claude Desktop após salvar. Você deve ver um ícone de martelo na entrada de chat quando as ferramentas estiverem disponíveis.

Sem chave, initialize / tools/list sempre funcionam. tools/call anônimos compartilham uma cota global (HTTP 429 quando excedida — obtenha uma chave para limites maiores). Chaves de espaço reservado ainda retornam 401.

Grok

Vá para grok.com/connectors e selecione Personalizado.
Insira a URL do servidor: https://mcp.connect.quid.li

Isso dá ao Grok acesso às ferramentas do nível anônimo — consulta, pontuações, agente e preço — sob a cota compartilhada.

Limitação atual: a interface de conector personalizado do Grok não suporta atualmente anexar uma chave de API ou cabeçalho personalizado. Isso significa que connect_me, connect_drop e connect_drop_balance (todos somente chave de API) não são utilizáveis através do Grok ainda — chamadas para eles retornarão um erro de não autorizado. Isso não é uma limitação do connect-mcp; é a configuração do conector personalizado do Grok que não expõe um campo de autenticação neste momento.

Smithery

Se você já usa Smithery, ele cuidará da autenticação e das sessões para você. Requer uma conta Smithery.

npx smithery login
npx smithery mcp add quidli/connect

Local (stdio)

Melhor se você quiser pagamento por chamada com uma carteira, ou preferir credenciais em um arquivo de ambiente local.

Requer Node.js 20+.

Cursor

Adicione um dos seguintes a .cursor/mcp.json (projeto) ou às suas configurações MCP globais.

Opção A — Chave de API

Mesmo modelo de cobrança que o hospedado; credenciais permanecem na sua máquina.

{
  "mcpServers": {
    "quidli-connect": {
      "command": "npx",
      "args": ["-y", "@quidli/connect-mcp"],
      "env": {
        "CONNECT_API_KEY": "<your-connect-api-key>",
        "CONNECT_API_BASE_URL": "https://api.connect.quid.li"
      }
    }
  }
}

Opção B — Pagamento por chamada x402 (carteira)

Sem chave de API. Chamadas autenticadas pagam automaticamente quando a API retorna HTTP 402. Sua chave privada da carteira é lida apenas pelo processo local.

{
  "mcpServers": {
    "quidli-connect": {
      "command": "npx",
      "args": ["-y", "@quidli/connect-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x<wallet-with-usdc-on-base>",
        "CONNECT_API_BASE_URL": "https://api.connect.quid.li",
        "CONNECT_X402_EVM_NETWORK": "8453"
      }
    }
  }
}

Use 84532 para Base Sepolia ao apontar para uma API de staging.

Opção C — Sem credenciais (consulta / pontuações)

O processo MCP inicia sem CONNECT_API_KEY ou EVM_PRIVATE_KEY. connect_lookup, connect_scores_*, connect_get_price e connect_get_chains chamam a API sem autenticação. Isso funciona quando x402 está desabilitado (preço 0, típico para local). Em produção com x402 habilitado, essas ferramentas retornam HTTP 402 até você definir uma chave ou carteira.

connect_me, connect_drop e connect_drop_balance ainda requerem CONNECT_API_KEY.

{
  "mcpServers": {
    "quidli-connect": {
      "command": "npx",
      "args": ["-y", "@quidli/connect-mcp"],
      "env": {
        "CONNECT_API_BASE_URL": "http://127.0.0.1:3011"
      }
    }
  }
}

Claude Desktop

Abra Claude → Configurações → Desenvolvedor → Editar Configuração (ative o modo Desenvolvedor primeiro se não o vir).
Mescle um dos blocos abaixo em mcpServers em:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Reinicie o Claude Desktop.

Opção A — Chave de API

{
  "mcpServers": {
    "quidli-connect": {
      "command": "npx",
      "args": ["-y", "@quidli/connect-mcp"],
      "env": {
        "CONNECT_API_KEY": "<your-connect-api-key>",
        "CONNECT_API_BASE_URL": "https://api.connect.quid.li"
      }
    }
  }
}

Opção B — Pagamento por chamada x402 (carteira)

{
  "mcpServers": {
    "quidli-connect": {
      "command": "npx",
      "args": ["-y", "@quidli/connect-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x<wallet-with-usdc-on-base>",
        "CONNECT_API_BASE_URL": "https://api.connect.quid.li",
        "CONNECT_X402_EVM_NETWORK": "8453"
      }
    }
  }
}

Se ambos CONNECT_API_KEY e EVM_PRIVATE_KEY estiverem definidos, a chave de API é usada.

Credenciais são opcionais no modo local. Sem nenhuma das variáveis, consulta/pontuações ainda funcionam quando a API não cobra x402. connect_me e as ferramentas Smart Send requerem CONNECT_API_KEY.

Solução de problemas

`npx` trava sem saída quando executado a partir de um serviço em segundo plano

Se você está iniciando @quidli/connect-mcp via npx de dentro de um gerenciador de processos em segundo plano — um agente launchd do macOS, uma unidade systemd, um supervisor, ou qualquer configuração de cliente executando sem um shell interativo normal — pode travar indefinidamente com zero saída e sem erro. Isso não é uma falha; npx está preso resolvendo PATH em um ambiente que não fornece a mesma inicialização de shell que um terminal interativo obtém.

Solução alternativa: se você tem Bun instalado, use bunx em vez de npx. Ele executa o mesmo trabalho — rodar o pacote sem uma instalação local — mas não encontra essa trava em ambientes com PATH restrito.

{
  "mcpServers": {
    "quidli-connect": {
      "command": "bunx",
      "args": ["-y", "@quidli/connect-mcp"],
      "env": {
        "CONNECT_API_KEY": "your-api-key"
      }
    }
  }
}

Se você está iniciando o processo você mesmo (em vez de através da configuração MCP de um cliente) e quer ser resiliente a bunx não estar em PATH também, resolva-o por caminho absoluto primeiro:

import { spawn } from "node:child_process";
import { existsSync } from "node:fs";
import { homedir } from "node:os";
import { join } from "node:path";

const BUNX_PATH = (() => {
  const candidate = join(homedir(), ".bun", "bin", "bunx");
  return existsSync(candidate) ? candidate : "bunx";
})();

const proc = spawn(BUNX_PATH, ["-y", "@quidli/connect-mcp"], {
  stdio: ["pipe", "pipe", "pipe"],
});

Isso não é uma afirmação geral de que Bun é melhor que npm — é uma correção direcionada para um modo de falha específico e reproduzível quando npx é iniciado fora de um shell interativo.

Nome de variável de ambiente errado para a chave de API

Verifique novamente se você está definindo CONNECT_API_KEY, não API_KEY — o servidor só lê CONNECT_API_KEY, e uma incompatibilidade aqui falha silenciosamente: suas chamadas serão executadas em modo anônimo/não autenticado em vez de gerar erro, o que pode parecer uma conexão funcional mas estranhamente limitada em vez de um erro de configuração.

Ferramentas

Ferramenta	O que faz
`connect_get_price`	Lista preços de referência (sem autenticação)
`connect_get_chains`	Lista cadeias suportadas e compatibilidade de recursos (sem autenticação)
`connect_lookup`	Resolve identidades sociais para endereços de carteira EVM e SOL
`connect_lookup_exposed`	Lista plataformas que um destinatário expôs no Connect
`connect_scores_batch`	Pontuações em lote para contas ou nomes de usuário
`connect_scores_by_account`	Pontuações para uma conta vinculada
`connect_scores_by_username`	Pontuações por nome de usuário Connect
`connect_me`	Perfil do proprietário da chave de API, pontuações e contas vinculadas — somente chave de API
`connect_drop`	Smart Send (lote EVM ou Solana SOL/SPL); aceita `trustFilter` para filtrar destinatários pelo grafo de confiança — somente chave de API
`connect_drop_balance`	Saldos da carteira Smart Send em uma cadeia — somente chave de API
`connect_trust_create`	Cria uma atestação de confiança onchain (EAS na Base) — somente chave de API
`connect_trust_check`	Verifica se identidades estão em um grafo de confiança na profundidade 1
`connect_trust_graph`	Lista arestas de confiança de saída/entrada para uma identidade
`connect_trust_revoke`	Revoga atestações de confiança ativas por alvo — somente chave de API

Peça ao seu cliente para usar essas ferramentas quando você precisar de dados ou ações do Connect.

Contribuindo

Este repositório é um espelho somente leitura, regenerado a cada lançamento — alterações confirmadas aqui são sobrescritas. Por favor, abra uma issue em vez de um pull request. Veja CONTRIBUTING.md.

Quidli Connect

Documentação

Quidli Connect MCP

Experimente em um comando

Escolha como conectar

Hospedado (recomendado)

Cursor

Adicionar manualmente {#cursor-manual}

Claude Desktop

Grok

Smithery

Local (stdio)

Cursor

Opção A — Chave de API

Opção B — Pagamento por chamada x402 (carteira)

Opção C — Sem credenciais (consulta / pontuações)

Claude Desktop

Opção A — Chave de API

Opção B — Pagamento por chamada x402 (carteira)

Solução de problemas

npx trava sem saída quando executado a partir de um serviço em segundo plano

Nome de variável de ambiente errado para a chave de API

Ferramentas

Contribuindo

`npx` trava sem saída quando executado a partir de um serviço em segundo plano