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.ethpara 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çã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/agente/preço sob uma cota anônima compartilhada | Chave de API, pagamento por chamada x402 ou nenhuma para consulta/pontuações/agente |
| Vantagens | 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 uma chave de API |
| Desvantagens | 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 autenticação x402 / 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.
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 Config em versões mais antigas).
- Adicione um conector MCP personalizado com URL
https://mcp.connect.quid.li. Opcionalmente, defina o cabeçalhox-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
- Abra Claude → Configurações → Desenvolvedor → Editar Config (ative o modo Desenvolvedor primeiro se não o vir).
- Mescle um dos blocos abaixo em
mcpServersem:
- 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.
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
| Ferramenta | O que faz |
|---|---|
connect_get_price | Lista preços de referência (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 (transferência de tokens em lote) — somente chave de API |
connect_drop_balance | Saldos da carteira Smart Send em uma rede — somente chave de API |
connect_agent_prompt | Agente 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.