Quidli Connect

Quidli Connect MCP

由链上声誉驱动，为多方 Agent 提供开放支付。将社交账号解析为钱包，查询其链上声誉并发送代币——可通过 Cursor、Claude Desktop、Claude Code 或任何兼容 MCP 的客户端使用。

多方场景指彼此原本并不认识的各方——Agent 向个人或另一个 Agent 付款，双方此前没有关系，也没有可依赖的账户。Connect 会在发送任何款项之前验证交易对象的身份。

公开仓库：github.com/Quidli/connect-mcp

一条命令即可试用

无需 API 密钥。

Claude Code：

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

Cursor：添加到 Cursor（或将该链接粘贴到设置 → MCP → 添加新的 MCP 服务）

**Claude Desktop：**设置 → 连接器 → 添加自定义连接器，URL 为 https://mcp.connect.quid.li

本地（任何客户端）——在你的机器上运行，而非使用托管端点：

npx -y @quidli/connect-mcp

请参阅下文的选择连接方式，了解 API 密钥、x402 钱包按次付费，以及完整配置示例。

然后向你的 Agent 提问：

将 GitHub 账号 justinquidli 解析为钱包。

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

支持通过 GitHub、X、Telegram、Discord、LinkedIn、Farcaster、电子邮件和电话号码进行解析；对于从未使用过 Quidli 的用户，还会生成钱包。

然后为查询结果评分：connect_scores_batch 可批量返回各个身份的链上声誉。

查询、评分和价格功能可在共享匿名额度内免密钥使用。添加 Connect API 密钥，即可获得更高限额、使用自己的个人资料（connect_me）和 Smart Send。

---

选择连接方式

	托管（mcp.connect.quid.li）	本地（npx @quidli/connect-mcp）
设置	在 MCP 设置中添加 URL	通过 npx 运行本地进程
身份验证	API 密钥可选。无密钥时：查询和评分使用共享匿名额度；价格和链信息为公开数据	API 密钥、x402 按次付费，或免密钥使用查询和评分
优点	无需安装；可免密钥试用；始终运行于 Quidli 基础设施	钱包私钥始终留在你的机器上；可使用 USDC 按次付费，无需 API 密钥
缺点	匿名流量共享全局速率限制；不支持按次付费	需要 Node.js 20+；首次运行时 npx 可能会下载软件包
限制	不支持 x402／钱包身份验证——切勿向托管端点发送私钥	x402 模式需要 Base 上的 USDC（主网 8453）；connect_drop 需要 API 密钥

前往 connect.quid.li 获取 Connect API 密钥 → 启用 API 访问，以获得更高限额、使用 connect_me 和 Smart Send。

---

托管（推荐）

无需本地设置。查询、评分、Agent 和价格功能均可免 API 密钥使用（共享匿名额度）。添加密钥即可获得更高限额、使用自己的个人资料（connect_me）和 Smart Send。

Cursor

**如果你已经有其他 MCP 服务：**跳过深层链接并手动添加——在某些 Cursor 版本中，一键安装可能会覆盖整个 mcp.json。

添加到 Cursor

或者粘贴到 Cursor Settings → MCP → Add new MCP server：

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

手动添加 {#cursor-manual}

将以下内容合并到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目）的 mcpServers 下——不要替换现有条目：

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

可选——更高限额和 Smart Send：

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

Claude Desktop

1. 打开 Claude → Settings → Connectors（较旧版本中为 Settings → Developer → Edit Config）。
2. 添加自定义 MCP 连接器，URL 为 https://mcp.connect.quid.li。也可以设置请求头 x-api-key: <your-connect-api-key>。

或者将以下内容合并到配置文件并重启 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"
    }
  }
}

如果你的 Claude 版本不支持远程 url 连接器，请改用本地桥接程序（仍使用托管 API，会运行一个小型本地辅助程序）：

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

桥接程序需要 Node.js 20+。保存后重启 Claude Desktop。工具可用时，你应该会在聊天输入框中看到一个锤子图标。

没有密钥时，initialize / tools/list 始终会成功。匿名 tools/call 共用全局限额（超出时返回 HTTP 429——获取密钥即可提高限额）。占位密钥仍会返回 401。

---

Grok

1. 前往 grok.com/connectors 并选择 Custom。
2. 输入服务 URL：https://mcp.connect.quid.li

这样 Grok 就能在共享限额内访问匿名层级的工具——lookup、scores、agent 和 price。

**当前限制：**Grok 的自定义连接器界面目前不支持附加 API 密钥或自定义请求头。这意味着 connect_me、connect_drop 和 connect_drop_balance（均仅限 API key）目前无法通过 Grok 使用——调用这些工具会返回未授权错误。这并非 connect-mcp 的限制，而是 Grok 的自定义连接器设置目前未提供身份验证字段。

---

Smithery

如果你已经在使用 Smithery，它会为你处理身份验证和会话。需要 Smithery 账户。

npx smithery login
npx smithery mcp add quidli/connect

---

本地（stdio）

如果你想使用钱包按次付费，或更倾向于将凭据保存在本地环境文件中，这是最佳选择。

需要 Node.js 20+。

Cursor

将以下其中一项添加到 .cursor/mcp.json（项目）或全局 MCP 设置中。

选项 A — API key

计费模式与托管方式相同；凭据保存在你的设备上。

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

选项 B — x402 按次付费（钱包）

无需 API 密钥。当 API 返回 HTTP 402 时，经过身份验证的调用会自动付款。钱包私钥仅由本地进程读取。

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

将 84532 用于 Base Sepolia，以连接暂存 API。

选项 C — 无凭据（lookup / scores）

MCP 进程启动时无需 CONNECT_API_KEY 或 EVM_PRIVATE_KEY。connect_lookup、connect_scores_*、connect_get_price 和 connect_get_chains 会在不进行身份验证的情况下调用 API。禁用 x402 时（本地环境通常价格为 0），这些调用会成功。在启用了 x402 的生产环境中，这些工具会返回 HTTP 402，除非你设置密钥或钱包。

connect_me、connect_drop 和 connect_drop_balance 仍需要 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. 打开 Claude → Settings → Developer → Edit Config（如果看不到此选项，请先启用 Developer mode）。
2. 将以下代码块中的一项合并到以下位置的 mcpServers 中：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

3. 重启 Claude Desktop。

选项 A — API key

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

选项 B — x402 按次付费（钱包）

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

如果同时设置了 CONNECT_API_KEY 和 EVM_PRIVATE_KEY，则使用 API 密钥。

本地模式下凭据为可选项。如果未设置这两个变量中的任何一个，且 API 不收取 x402 费用，查询和评分仍可正常使用。connect_me 和 Smart Send 工具需要 CONNECT_API_KEY。

---

故障排除

从后台服务运行时，npx 一直挂起且没有输出

如果你通过后台进程管理器中的 npx 启动 @quidli/connect-mcp——例如 macOS 的 launchd Agent、systemd 单元、supervisor，或任何在非普通交互式 shell 中运行的客户端配置——它可能会无限期挂起，不产生任何输出或错误。这并非崩溃；而是 npx 在解析 PATH 时卡住了，因为该环境没有提供与交互式终端相同的 shell 初始化。

**解决方法：**如果已安装 Bun，请改用 bunx，而不是 npx。它执行相同的操作——无需本地安装即可运行软件包——但在受限的 PATH 环境中不会遇到此挂起问题。

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

如果你自行启动进程（而不是通过客户端的 MCP 配置），并希望在 PATH 中也找不到 bunx 时依然可靠运行，请先通过绝对路径解析它：

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

这并非泛指 Bun 优于 npm，而是针对 npx 在交互式 shell 外启动时出现的一种特定且可复现的故障情形提供的修复方法。

API 密钥使用了错误的环境变量名称

请确认设置的是 CONNECT_API_KEY，而不是 API_KEY——服务只会读取 CONNECT_API_KEY。如果名称不匹配，不会报错，而是静默失败：调用会以匿名／未认证模式运行，而非报错，因此看起来可能像是连接正常但功能受限，而不是配置有误。

支持的链

connect_get_chains（REST：GET /chains）是权威来源，无需密钥。截至 2026-10-14，它列出了以下主网，且每条链均已启用 lookup 和 drop：

链	链 ID	原生代币
Ethereum	1	ETH
Base	8453	ETH
Polygon	137	POL
OP Mainnet	10	ETH
Arbitrum One	42161	ETH
Avalanche	43114	AVAX
World Chain	480	ETH
Monad	143	MON
Robinhood Chain	4663	ETH
Solana	1399811149	SOL

World Chain Sepolia（4801）也已列出，作为测试网。

• 社交账号可在所有链上解析：EVM 链向接收方的 ethWalletAddress 付款，Solana 则向其 solWalletAddress 付款。
• 如果省略 tokenContract，connect_drop 会发送原生代币。发送 ERC-20 或 SPL 代币时，请传入其合约地址或铸币地址。
• 余额覆盖范围因链而异。 connect_drop_balance 会在所有链上返回原生代币余额。ERC-20 余额来自各链对应的服务提供商：Monad 和 Base 使用 Moralis，Robinhood Chain 使用 Blockscout；其他链可能只返回原生代币和精选代币。余额为零的代币会被省略，可能会出现垃圾代币，服务提供商未索引的代币也可能缺失。如果你知道代币合约地址，仍可通过传入 tokenContract 来发送。

工具

工具	功能
connect_get_price	列出参考价格（无需身份验证）
connect_get_chains	列出支持的链和功能兼容性（无需身份验证）
connect_lookup	将社交身份解析为 EVM 和 SOL 钱包地址
connect_lookup_exposed	列出接收方在 Connect 上公开的平台
connect_scores_batch	批量获取账户或用户名的评分
connect_scores_by_account	获取一个已关联账户的评分
connect_scores_by_username	按 Connect 用户名获取评分
connect_me	API 密钥所有者的个人资料、评分和已关联账户 — 仅限 API 密钥
connect_drop	Smart Send（EVM 批量发送或 Solana SOL/SPL）；接受 trustFilter，根据信任图筛选接收方 — 仅限 API 密钥
connect_drop_balance	获取某条链上的 Smart Send 钱包余额 — 仅限 API 密钥。代币支持范围因链而异，参见支持的链
connect_trust_create	创建链上信任证明（Base 上的 EAS）— 仅限 API 密钥
connect_trust_check	检查身份在深度为 1 的信任图中是否存在
connect_trust_graph	列出某个身份的传出和传入信任关系
connect_trust_revoke	按目标撤销有效的信任证明 — 仅限 API 密钥

需要 Connect 数据或执行操作时，请让客户端使用这些工具。

贡献

此仓库是一个只读镜像，每次发布时都会重新生成——在此提交的更改会被覆盖。请提交 issue，而不要提交 pull request。 参见 CONTRIBUTING.md。