Quidli Connect

Resuelve cualquier identificador social a una wallet, verifica la reputación a partir del historial público y envía tokens — desde cualquier cliente MCP.

Documentación

Quidli Connect MCP

Identidad y reputación para agentes. Resuelve un identificador social a una wallet, consulta reputación y envía tokens — desde Cursor, Claude Desktop, Claude Code, o cualquier cliente compatible con MCP.

Repositorio público: github.com/Quidli/connect-mcp

Pruébalo con un solo comando

No se requiere clave API.

Claude Code:

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

Cursor: Añadir a Cursor (o pega ese enlace en Configuración → MCP → Añadir nuevo servidor MCP)

Claude Desktop: Configuración → Conectores → Añadir conector personalizado, URL https://mcp.connect.quid.li

Local (cualquier cliente) — se ejecuta en tu máquina en lugar del endpoint alojado:

npx -y @quidli/connect-mcp

Consulta Elige cómo conectarte más abajo para claves API, pago por llamada con wallet x402, y fragmentos de configuración completos.

Luego pregúntale a tu agente:

Resuelve el identificador de Farcaster ahn.eth a una wallet.

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

Resuelve en Telegram, Discord, Farcaster, X, GitHub, LinkedIn, correo electrónico y teléfono — y genera una wallet para personas que nunca han usado Quidli.

Las búsquedas, puntuaciones, agente y precios funcionan sin clave bajo una cuota anónima compartida. Añade una clave API de Connect para límites más altos, tu propio perfil (connect_me) y Smart Send.


Elige cómo conectarte

Alojado (mcp.connect.quid.li)Local (npx @quidli/connect-mcp)
ConfiguraciónAñade una URL en la configuración de MCPEjecuta un proceso local mediante npx
AutenticaciónClave API opcional. Sin clave: búsquedas/puntuaciones/agente/precios bajo una cuota anónima compartidaClave API, pago por llamada x402, o ninguna para búsquedas/puntuaciones/agente
VentajasSin instalación; pruébalo sin clave; siempre en la infraestructura de QuidliLa clave privada de la wallet nunca sale de tu máquina; paga por llamada con USDC en lugar de una clave API
DesventajasEl tráfico anónimo comparte un límite de tasa global; sin facturación por pago por llamadaRequiere Node.js 20+; npx puede descargar el paquete en la primera ejecución
LimitacionesNo puede usar autenticación x402 / wallet — no envíes una clave privada al endpoint alojadoEl modo x402 necesita USDC en Base (mainnet 8453); connect_drop requiere una clave API

Obtén una clave API de Connect en connect.quid.liHabilitar acceso API para límites más altos, connect_me y Smart Send.


Alojado (recomendado)

Configuración local cero. Las búsquedas, puntuaciones, agente y precios funcionan sin clave API (cuota anónima compartida). Añade una clave para límites más altos, tu perfil (connect_me) y Smart Send.

Cursor

Si ya tienes otros servidores MCP: omite el enlace directo y añádelo manualmente — la instalación con un clic puede sobrescribir todo tu mcp.json en algunas versiones de Cursor.

Añadir a Cursor

O pega en Configuración de Cursor → MCP → Añadir nuevo servidor MCP:

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

Añadir manualmente {#cursor-manual}

Fusiona esto en ~/.cursor/mcp.json (global) o .cursor/mcp.json (proyecto) bajo mcpServers — no reemplaces tus entradas existentes:

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

Opcional — límites más altos y Smart Send:

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

Claude Desktop

  1. Abre Claude → Configuración → Conectores (o Configuración → Desarrollador → Editar configuración en versiones antiguas).
  2. Añade un conector MCP personalizado con URL https://mcp.connect.quid.li. Opcionalmente, establece el encabezado x-api-key: <your-connect-api-key>.

O fusiona esto en tu archivo de configuración y reinicia 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"
    }
  }
}

Si tu versión de Claude no admite conectores remotos url, usa el puente local en su lugar (sigue siendo API alojada, ejecuta un pequeño asistente local):

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

Requiere Node.js 20+ para el puente. Reinicia Claude Desktop después de guardar. Deberías ver un ícono de martillo en la entrada de chat cuando las herramientas estén disponibles.

Sin clave, initialize / tools/list siempre tienen éxito. Las tools/call anónimas comparten una cuota global (HTTP 429 cuando se excede — obtén una clave para límites más altos). Las claves de marcador de posición aún devuelven 401.


Smithery

Si ya usas Smithery, se encargará de la autenticación y las sesiones por ti. Requiere una cuenta de Smithery.

npx smithery login
npx smithery mcp add quidli/connect

Local (stdio)

Ideal si quieres pago por llamada con una wallet, o prefieres credenciales en un archivo de entorno local.

Requiere Node.js 20+.

Cursor

Añade una de las siguientes opciones a .cursor/mcp.json (proyecto) o a tu configuración global de MCP.

Opción A — Clave API

Mismo modelo de facturación que el alojado; las credenciales permanecen en tu 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"
      }
    }
  }
}

Opción B — Pago por llamada x402 (wallet)

Sin clave API. Las llamadas autenticadas pagan automáticamente cuando la API devuelve HTTP 402. Tu clave privada de wallet solo la lee el proceso 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"
      }
    }
  }
}

Usa 84532 para Base Sepolia cuando apuntes a una API de staging.

Opción C — Sin credenciales (búsquedas / puntuaciones / agente)

El proceso MCP se inicia sin CONNECT_API_KEY o EVM_PRIVATE_KEY. connect_lookup, connect_scores_*, connect_agent_prompt y connect_get_price llaman a la API sin autenticación. Eso funciona cuando x402 está deshabilitado (precio 0, típico para local). En producción con x402 habilitado, esas herramientas devuelven HTTP 402 hasta que establezcas una clave o wallet.

connect_me, connect_drop y connect_drop_balance aún requieren 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. Abre Claude → Configuración → Desarrollador → Editar configuración (habilita el modo Desarrollador primero si no lo ves).
  2. Fusiona uno de los bloques siguientes en mcpServers en:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  1. Reinicia Claude Desktop.

Opción A — Clave 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"
      }
    }
  }
}

Opción B — Pago por llamada x402 (wallet)

{
  "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"
      }
    }
  }
}

Si tanto CONNECT_API_KEY como EVM_PRIVATE_KEY están establecidos, se usa la clave API.

Las credenciales son opcionales en modo local. Sin ninguna de las dos variables, las búsquedas/puntuaciones/agente aún funcionan cuando la API no cobra x402. connect_me y las herramientas de Smart Send requieren CONNECT_API_KEY.


Herramientas

HerramientaQué hace
connect_get_priceLista precios de referencia (sin autenticación)
connect_lookupResuelve identidades sociales a direcciones de wallet EVM y SOL
connect_lookup_exposedLista plataformas que un destinatario ha expuesto en Connect
connect_scores_batchPuntuaciones por lotes para cuentas o nombres de usuario
connect_scores_by_accountPuntuaciones para una cuenta vinculada
connect_scores_by_usernamePuntuaciones por nombre de usuario de Connect
connect_mePerfil del propietario de la clave API, puntuaciones y cuentas vinculadas — solo clave API
connect_dropSmart Send (transferencia de tokens por lotes) — solo clave API
connect_drop_balanceSaldos de wallet de Smart Send en una cadena — solo clave API
connect_agent_promptAgente de lenguaje natural para descubrimiento de destinatarios

Pídele a tu cliente que use estas herramientas cuando necesites datos o acciones de Connect.