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
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
justinquidlia 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ón | Añade una URL en la configuración de MCP | Ejecuta un proceso local mediante npx |
| Autenticación | Clave API opcional. Sin clave: búsqueda/puntuaciones bajo cuota anónima compartida; precio/cadenas son públicos | Clave API, pago por llamada x402, o ninguna para búsqueda/puntuaciones |
| Ventajas | Sin instalación; pruébalo sin clave; siempre en la infraestructura de Quidli | La clave privada de la wallet nunca sale de tu máquina; paga por llamada con USDC en lugar de una clave API |
| Desventajas | El tráfico anónimo comparte un límite de tasa global; sin facturación por pago por llamada | Requiere Node.js 20+; npx puede descargar el paquete en la primera ejecución |
| Limitaciones | No puede usar x402 / autenticación de wallet — no envíes una clave privada al endpoint alojado | El 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.
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
- Abre Claude → Configuración → Conectores (o Configuración → Desarrollador → Editar configuración en versiones anteriores).
- Añade un conector MCP personalizado con URL
https://mcp.connect.quid.li. Opcionalmente, establece el encabezadox-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
- Ve a grok.com/connectors y selecciona Personalizado.
- 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
- Abre Claude → Configuración → Desarrollador → Editar configuración (habilita el modo Desarrollador primero si no lo ves).
- Fusiona uno de los bloques a continuación en
mcpServersen:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- 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
| Herramienta | Qué hace |
|---|---|
connect_get_price | Lista precios de referencia (sin autenticación) |
connect_get_chains | Lista cadenas compatibles y compatibilidad de funciones (sin autenticación) |
connect_lookup | Resuelve identidades sociales a direcciones de wallet EVM y SOL |
connect_lookup_exposed | Lista plataformas que un destinatario ha expuesto en Connect |
connect_scores_batch | Puntuaciones por lotes para cuentas o nombres de usuario |
connect_scores_by_account | Puntuaciones para una cuenta vinculada |
connect_scores_by_username | Puntuaciones por nombre de usuario de Connect |
connect_me | Perfil del propietario de la clave API, puntuaciones y cuentas vinculadas — solo clave API |
connect_drop | Smart Send (lote EVM o Solana SOL/SPL); acepta trustFilter para filtrar destinatarios por grafo de confianza — solo clave API |
connect_drop_balance | Saldos de wallet de Smart Send en una cadena — solo clave API |
connect_trust_create | Crea una atestación de confianza en cadena (EAS en Base) — solo clave API |
connect_trust_check | Verifica si las identidades están en un grafo de confianza a profundidad 1 |
connect_trust_graph | Lista aristas de confianza salientes/entrantes para una identidad |
connect_trust_revoke | Revoca 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.