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.

Documentação

Quidli Connect MCP

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

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

Experimente com um único 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) — executa 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 completos de configuração.

Depois pergunte ao seu agente:

Resolva o identificador Farcaster ahn.eth para uma carteira.

{
  "status": "completed",
  "results": [
    {
      "type": "farcaster",
      "value": "ahn.eth",
      "ethWalletAddress": "0x07De92Ce6474D718c80e696516bf0bE53290fF5E",
      "solWalletAddress": "9DD2CqPKZJoo7ZRgCXxJNMjhzfgVihSKtkZpn8qnEWK9"
    }
  ]
}

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

Consulta, pontuações, agente 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çãoAdicione uma URL nas configurações do MCPExecute um processo local via npx
AutenticaçãoChave de API opcional. Sem chave: consulta/pontuações/agente/preço sob uma cota anônima compartilhadaChave de API, pagamento por chamada x402 ou nenhuma para consulta/pontuações/agente
VantagensSem instalação; experimente sem chave; sempre na infraestrutura QuidliA chave privada da carteira nunca sai da sua máquina; pague por chamada com USDC em vez de uma chave de API
DesvantagensTráfego anônimo compartilha um limite global de taxa; sem cobrança por chamadaRequer Node.js 20+; npx pode baixar o pacote na primeira execução
LimitaçõesNão pode usar autenticação x402 / carteira — não envie uma chave privada para o endpoint hospedadoO 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.liAtivar 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

  1. Abra Claude → Configurações → Conectores (ou Configurações → Desenvolvedor → Editar Config em versões mais antigas).
  2. 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 suportar conectores remotos url, 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.


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 globais do MCP.

Opção A — Chave de API

Mesmo modelo de cobrança do hospedado; as 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. A chave privada da sua 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 / agente)

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

connect_me, connect_drop e connect_drop_balance ainda exigem 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

  1. Abra Claude → Configurações → Desenvolvedor → Editar Config (ative o modo Desenvolvedor primeiro se não o vir).
  2. Mescle um dos blocos abaixo em mcpServers em:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  1. 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.

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


Ferramentas

FerramentaO que faz
connect_get_priceLista preços de referência (sem autenticação)
connect_lookupResolve identidades sociais para endereços de carteira EVM e SOL
connect_lookup_exposedLista plataformas que um destinatário expôs no Connect
connect_scores_batchPontuações em lote para contas ou nomes de usuário
connect_scores_by_accountPontuações para uma conta vinculada
connect_scores_by_usernamePontuações por nome de usuário Connect
connect_mePerfil do proprietário da chave de API, pontuações e contas vinculadas — somente chave de API
connect_dropSmart Send (transferência de tokens em lote) — somente chave de API
connect_drop_balanceSaldos da carteira Smart Send em uma rede — somente chave de API
connect_agent_promptAgente em linguagem natural para descoberta de destinatários

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