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

npm version npm downloads license

Pagos abiertos para agentes multijugador, impulsados por reputación en cadena. Resuelve un identificador social a una wallet, verifica su reputación en cadena y envía tokens — desde Cursor, Claude Desktop, Claude Code, o cualquier cliente compatible con MCP.

Multijugador significa partes que no se conocen entre sí — un agente pagando a una persona, u otro agente, sin relación previa y sin cuenta de respaldo. Connect es cómo verifica con quién está tratando antes de enviar cualquier cosa.

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 a continuación para claves API, pago por llamada con wallet x402, y fragmentos de configuración completos.

Luego pregunta a tu agente:

Resuelve el identificador de GitHub justinquidli a una wallet.

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

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

Luego puntúa lo que encuentres: connect_scores_batch devuelve reputación en cadena para un lote de identidades.

La búsqueda, las puntuaciones y el precio se ejecutan 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úsqueda/puntuaciones bajo cuota anónima compartida; precio/cadenas son públicosClave API, pago por llamada x402, o ninguna para búsqueda/puntuaciones
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 x402 / autenticación de 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.li → Habilitar acceso API para límites más altos, connect_me y Smart Send.


Alojado (recomendado)

Configuración local cero. La búsqueda, las puntuaciones, el agente y el precio 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 anteriores).
  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 (aún 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. Los tools/call anónimos 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.


Grok

  1. Ve a grok.com/connectors y selecciona Personalizado.
  2. Ingresa la URL del servidor: https://mcp.connect.quid.li

Esto le da a Grok acceso a las herramientas del nivel anónimo — búsqueda, puntuaciones, agente y precio — bajo la cuota compartida.

Limitación actual: la interfaz de conector personalizado de Grok actualmente no admite adjuntar una clave API o un encabezado personalizado. Eso significa que connect_me, connect_drop y connect_drop_balance (todas solo clave API) no se pueden usar a través de Grok todavía — las llamadas a ellas devolverán un error de no autorizado. Esto no es una limitación de connect-mcp; es la configuración del conector personalizado de Grok que no expone un campo de autenticación en este momento.


Smithery

Si ya usas Smithery, manejará 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 uno de los siguientes 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 al apuntar a una API de staging.

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

El proceso MCP se inicia sin CONNECT_API_KEY o EVM_PRIVATE_KEY. connect_lookup, connect_scores_*, connect_get_price y connect_get_chains llaman a la API sin autenticación. Eso tiene éxito 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 a continuación 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, la búsqueda/puntuaciones aún funcionan cuando la API no cobra x402. connect_me y las herramientas de Smart Send requieren CONNECT_API_KEY.


Solución de problemas

npx se cuelga sin salida cuando se ejecuta desde un servicio en segundo plano

Si estás lanzando @quidli/connect-mcp mediante npx desde un administrador de procesos en segundo plano — un agente de macOS launchd, una unidad systemd, un supervisor, o cualquier configuración de cliente que se ejecute sin un shell interactivo normal — puede colgarse indefinidamente con cero salida y sin error. Esto no es un bloqueo; npx está atascado resolviendo PATH en un entorno que no proporciona la misma inicialización de shell que obtiene una terminal interactiva.

Solución alternativa: si tienes Bun instalado, usa bunx en lugar de npx. Realiza el mismo trabajo — ejecutar el paquete sin instalación local — pero no sufre este cuelgue en entornos restringidos de PATH.

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

Si estás generando el proceso tú mismo (en lugar de a través de la configuración MCP de un cliente) y quieres ser resistente a que bunx no esté en PATH tampoco, resuélvelo por ruta absoluta primero:

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"],
});

Esto no es una afirmación general de que Bun sea mejor que npm — es una corrección específica para un modo de fallo concreto y reproducible cuando npx se genera fuera de un shell interactivo.

Nombre de variable de entorno incorrecto para la clave API

Verifica dos veces que estás estableciendo CONNECT_API_KEY, no API_KEY — el servidor solo lee CONNECT_API_KEY, y un desajuste aquí falla silenciosamente: tus llamadas se ejecutarán en modo anónimo/no autenticado en lugar de dar error, lo que puede parecer una conexión que funciona pero está extrañamente limitada en lugar de un error de configuración.

Herramientas

HerramientaQué hace
connect_get_priceLista precios de referencia (sin autenticación)
connect_get_chainsLista cadenas compatibles y compatibilidad de funciones (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 (lote EVM o Solana SOL/SPL); acepta trustFilter para filtrar destinatarios por grafo de confianza — solo clave API
connect_drop_balanceSaldos de wallet de Smart Send en una cadena — solo clave API
connect_trust_createCrea una atestación de confianza en cadena (EAS en Base) — solo clave API
connect_trust_checkVerifica si las identidades están en un grafo de confianza a profundidad 1
connect_trust_graphLista aristas de confianza salientes/entrantes para una identidad
connect_trust_revokeRevoca atestaciones de confianza activas por objetivo — solo clave API

Pide a tu cliente que use estas herramientas cuando necesites datos o acciones de Connect.

Contribuciones

Este repositorio es un espejo de solo lectura, regenerado en cada versión — los cambios confirmados aquí se sobrescriben. Abre un issue en lugar de un pull request. Consulta CONTRIBUTING.md.