@quidli/connect-mcp 0.5.8 → 0.5.9

package/README.md

@@ -153,6 +153,17 @@ Without a key, `initialize` / `tools/list` always succeed. Anonymous `tools/call
 
 ---
 
+### Grok
+
+1. Go to [grok.com/connectors](https://grok.com/connectors) and select **Custom**.
+2. Enter the server URL: `https://mcp.connect.quid.li`
+
+This gives Grok access to the anonymous-tier tools -- lookup, scores, agent, and price -- under the shared quota.
+
+**Current limitation:** Grok's custom connector UI does not currently support attaching an API key or custom header. That means `connect_me`, `connect_drop`, and `connect_drop_balance` (all **API key only**) are not usable through Grok yet -- calls to them will return an unauthorized error. This isn't a `connect-mcp` limitation; it's Grok's custom-connector setup not exposing an auth field at this time.
+
+---
+
 ## Smithery
 
 If you already use [Smithery](https://smithery.ai/servers/quidli/connect), it will handle auth and sessions for you. Requires a Smithery account.
@@ -286,6 +297,67 @@ Credentials are optional in local mode. Without either variable, lookup/scores s
 
 ---
 
+## Troubleshooting
+
+### `npx` hangs with no output when run from a background service
+
+If you're launching `@quidli/connect-mcp` via `npx` from inside a background
+process manager -- a macOS `launchd` agent, a systemd unit, a supervisor, or
+any client config running without a normal interactive shell -- it can hang
+**indefinitely with zero output and no error**. This isn't a crash; `npx` is
+stuck resolving `PATH` in an environment that doesn't provide the same shell
+initialization an interactive terminal gets.
+
+**Workaround:** if you have [Bun](https://bun.sh) installed, use `bunx`
+instead of `npx`. It performs the same job -- running the package without a
+local install -- but doesn't hit this hang in restricted-`PATH` environments.
+
+```json
+{
+  "mcpServers": {
+    "quidli-connect": {
+      "command": "bunx",
+      "args": ["-y", "@quidli/connect-mcp"],
+      "env": {
+        "CONNECT_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+If you're spawning the process yourself (rather than through a client's MCP
+config) and want to be resilient to `bunx` not being on `PATH` either,
+resolve it by absolute path first:
+
+```ts
+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"],
+});
+```
+
+This isn't a general claim that Bun is better than npm -- it's a targeted fix
+for one specific, reproducible failure mode when `npx` is spawned outside an
+interactive shell.
+
+### Wrong environment variable name for the API key
+
+Double-check you're setting `CONNECT_API_KEY`, not `API_KEY` -- the server
+only reads `CONNECT_API_KEY`, and a mismatch here fails silently: your calls
+will run in anonymous/unauthenticated mode instead of erroring, which can
+look like a working-but-oddly-limited connection rather than a config
+mistake.
+
 ## Tools
 
 

package/package.json

@@ -1,28 +1,30 @@
 {
   "name": "@quidli/connect-mcp",
-  "version": "0.5.8",
-  "description": "Identity and reputation for multiplayer agents: resolve social handles to wallet addresses, check reputation from public history, and send tokens from any MCP client.",
+  "version": "0.5.9",
+  "description": "MCP server for agent identity and reputation: resolve social handles to wallet addresses, score onchain reputation, and send USDC from any MCP client.",
   "keywords": [
     "mcp",
     "mcp-server",
     "model-context-protocol",
-    "ai",
-    "agent",
-    "web3-agent",
-    "agent-payments",
-    "multiplayer-agents",
+    "reputation",
+    "onchain-reputation",
     "identity",
     "identity-resolution",
-    "reputation",
-    "payments",
     "wallet",
+    "wallet-lookup",
+    "agent",
+    "ai",
+    "agent-payments",
+    "payments",
     "usdc",
-    "farcaster",
+    "crypto",
+    "web3-agent",
+    "multiplayer-agents",
     "x402",
     "ethereum",
     "solana",
     "base",
-    "crypto",
+    "farcaster",
     "claude",
     "cursor",
     "claude-desktop"
@@ -53,8 +55,8 @@
     "./http": "./dist/http.js"
   },
   "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "npm run build && chmod +x dist/index.js dist/index-http.js",
+    "build": "tsc && chmod +x dist/index.js dist/index-http.js",
+    "prepublishOnly": "npm run build",
     "start": "node dist/index.js",
     "start:http": "node dist/index-http.js",
     "test": "vitest run",