@quidli/connect-mcp 0.5.5 → 0.5.7

package/README.md

@@ -1,6 +1,12 @@
 # Quidli Connect MCP
 
-Identity and reputation for agents. Resolve a social handle to a wallet, check reputation, and send tokens — from Cursor, Claude Desktop, Claude Code, or any MCP-compatible client.
+[![npm version](https://img.shields.io/npm/v/@quidli/connect-mcp.svg)](https://www.npmjs.com/package/@quidli/connect-mcp)
+[![npm downloads](https://img.shields.io/npm/dw/@quidli/connect-mcp.svg)](https://www.npmjs.com/package/@quidli/connect-mcp)
+[![license](https://img.shields.io/npm/l/@quidli/connect-mcp.svg)](./LICENSE)
+
+Open payments for multiplayer agents, powered by social reputation. Resolve a social handle to a wallet, check reputation, and send tokens — from Cursor, Claude Desktop, Claude Code, or any MCP-compatible client.
+
+Multiplayer means parties who don't already know each other — an agent paying a person, or another agent, with no prior relationship and no account to fall back on. Connect is how it verifies who it's dealing with before sending anything.
 
 Public repository: [github.com/Quidli/connect-mcp](https://github.com/Quidli/connect-mcp)
 
@@ -46,7 +52,7 @@ Then ask your agent:
 
 Resolves across Telegram, Discord, Farcaster, X, GitHub, LinkedIn, email and phone — and generates a wallet for people who have never used Quidli.
 
-Lookup, scores, agent and price run without a key under a shared anonymous quota. Add a [Connect API key](https://connect.quid.li) for higher limits, your own profile (`connect_me`), and Smart Send.
+Lookup, scores, and price run without a key under a shared anonymous quota. Add a [Connect API key](https://connect.quid.li) for higher limits, your own profile (`connect_me`), and Smart Send.
 
 ---
 
@@ -56,7 +62,7 @@ Lookup, scores, agent and price run without a key under a shared anonymous quota
 |                 | **Hosted** (`mcp.connect.quid.li`)                                                   | **Local** (`npx @quidli/connect-mcp`)                                                      |
 | --------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
 | **Setup**       | Add a URL in MCP settings                                                            | Run a local process via `npx`                                                              |
-| **Auth**        | Optional API key. Without a key: lookup/scores/agent/price under a shared anonymous quota | API key, x402 pay-per-call, or none for lookup/scores/agent                                |
+| **Auth**        | Optional API key. Without a key: lookup/scores under a shared anonymous quota; price/chains are public | API key, x402 pay-per-call, or none for lookup/scores                                |
 | **Pros**        | No install; try without a key; always on Quidli infrastructure                       | Wallet private key never leaves your machine; pay per call with USDC instead of an API key |
 | **Cons**        | Anonymous traffic shares a global rate limit; no pay-per-call billing                | Requires Node.js 20+; `npx` may download the package on first run                          |
 | **Limitations** | Cannot use x402 / wallet auth — do **not** send a private key to the hosted endpoint | x402 mode needs USDC on Base (mainnet `8453`); `connect_drop` requires an API key          |
@@ -209,9 +215,9 @@ No API key. Authenticated calls pay automatically when the API returns HTTP 402.
 
 Use `84532` for Base Sepolia when pointing at a staging API.
 
-#### Option C — no credentials (lookup / scores / agent)
+#### Option C — no credentials (lookup / scores)
 
-The MCP process starts without `CONNECT_API_KEY` or `EVM_PRIVATE_KEY`. `connect_lookup`, `connect_scores_*`, `connect_agent_prompt`, and `connect_get_price` call the API without auth. That succeeds when x402 is disabled (price `0`, typical for local). On production with x402 enabled, those tools return HTTP 402 until you set a key or wallet.
+The MCP process starts without `CONNECT_API_KEY` or `EVM_PRIVATE_KEY`. `connect_lookup`, `connect_scores_*`, `connect_get_price`, and `connect_get_chains` call the API without auth. That succeeds when x402 is disabled (price `0`, typical for local). On production with x402 enabled, those tools return HTTP 402 until you set a key or wallet.
 
 `connect_me`, `connect_drop`, and `connect_drop_balance` still require `CONNECT_API_KEY`.
 
@@ -276,7 +282,7 @@ The MCP process starts without `CONNECT_API_KEY` or `EVM_PRIVATE_KEY`. `connect_
 
 If both `CONNECT_API_KEY` and `EVM_PRIVATE_KEY` are set, the API key is used.
 
-Credentials are optional in local mode. Without either variable, lookup/scores/agent still work when the API does not charge x402. `connect_me` and Smart Send tools require `CONNECT_API_KEY`.
+Credentials are optional in local mode. Without either variable, lookup/scores still work when the API does not charge x402. `connect_me` and Smart Send tools require `CONNECT_API_KEY`.
 
 ---
 
@@ -286,6 +292,7 @@ Credentials are optional in local mode. Without either variable, lookup/scores/a
 | Tool                         | What it does                                              |
 | ---------------------------- | --------------------------------------------------------- |
 | `connect_get_price`          | List reference prices (no auth)                           |
+| `connect_get_chains`         | List supported chains and feature compatibility (no auth) |
 | `connect_lookup`             | Resolve social identities to EVM and SOL wallet addresses |
 | `connect_lookup_exposed`     | List platforms a recipient has exposed on Connect         |
 | `connect_scores_batch`       | Batch scores for accounts or usernames                    |
@@ -294,7 +301,6 @@ Credentials are optional in local mode. Without either variable, lookup/scores/a
 | `connect_me`                 | API key owner profile, scores, and linked accounts — **API key only** |
 | `connect_drop`               | Smart Send (batch token transfer) — **API key only**      |
 | `connect_drop_balance`       | Smart Send wallet balances on a chain — **API key only**  |
-| `connect_agent_prompt`       | Natural-language agent for recipients discovery           |
 
 
 Ask your client to use these tools when you need Connect data or actions.

package/dist/anonymous-quota.js

@@ -1,5 +1,5 @@
 import { getJsonRpcMethod, getJsonRpcToolName } from './jsonrpc.js';
-export const ANON_QUOTA_EXEMPT_TOOLS = new Set(['connect_get_price']);
+export const ANON_QUOTA_EXEMPT_TOOLS = new Set(['connect_get_price', 'connect_get_chains']);
 export const ANON_AGENT_TOOL = 'connect_agent_prompt';
 const GLOBAL_QUOTA_MESSAGE = 'Anonymous MCP quota exceeded. Get a Connect API key at https://connect.quid.li (Enable API access) for higher limits.';
 const AGENT_QUOTA_MESSAGE = 'Anonymous MCP agent quota exceeded. Get a Connect API key at https://connect.quid.li (Enable API access) for higher limits.';

package/dist/config.d.ts

@@ -15,7 +15,7 @@ export interface HttpServerConfig {
 export declare function loadHttpServerConfig(env?: NodeJS.ProcessEnv): HttpServerConfig;
 /**
  * Stdio MCP: credentials are optional.
- * Lookup/scores/agent work without auth when the API allows it (x402 price 0)
+ * Lookup/scores work without auth when the API allows it (x402 price 0)
  * or with CONNECT_API_KEY / EVM_PRIVATE_KEY. /account/me and /drop require an API key.
  */
 export declare function loadConfig(env?: NodeJS.ProcessEnv): ConnectClientConfig;

package/dist/config.js

@@ -25,7 +25,7 @@ export function loadHttpServerConfig(env = process.env) {
 }
 /**
  * Stdio MCP: credentials are optional.
- * Lookup/scores/agent work without auth when the API allows it (x402 price 0)
+ * Lookup/scores work without auth when the API allows it (x402 price 0)
  * or with CONNECT_API_KEY / EVM_PRIVATE_KEY. /account/me and /drop require an API key.
  */
 export function loadConfig(env = process.env) {

package/dist/schemas.d.ts

@@ -15,15 +15,15 @@ export declare const linkedAccountSchema: z.ZodObject<{
 }, z.ZodTypeAny, "passthrough">>;
 export declare const lookupInputSchema: {
     recipients: z.ZodArray<z.ZodObject<{
-        type: z.ZodEnum<["email", "phone", "telegram", "discord", "farcaster", "twitter", "github", "linkedin", "slack", "wallet", "username"]>;
+        type: z.ZodEnum<["email", "phone", "telegram", "discord", "farcaster", "twitter", "github", "linkedin", "slack"]>;
         id: z.ZodOptional<z.ZodString>;
         username: z.ZodOptional<z.ZodString>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        type: z.ZodEnum<["email", "phone", "telegram", "discord", "farcaster", "twitter", "github", "linkedin", "slack", "wallet", "username"]>;
+        type: z.ZodEnum<["email", "phone", "telegram", "discord", "farcaster", "twitter", "github", "linkedin", "slack"]>;
         id: z.ZodOptional<z.ZodString>;
         username: z.ZodOptional<z.ZodString>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        type: z.ZodEnum<["email", "phone", "telegram", "discord", "farcaster", "twitter", "github", "linkedin", "slack", "wallet", "username"]>;
+        type: z.ZodEnum<["email", "phone", "telegram", "discord", "farcaster", "twitter", "github", "linkedin", "slack"]>;
         id: z.ZodOptional<z.ZodString>;
         username: z.ZodOptional<z.ZodString>;
     }, z.ZodTypeAny, "passthrough">>, "many">;
@@ -98,7 +98,3 @@ export declare const dropInputSchema: {
     amountInWeiPerRecipient: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     ignoreFailedRecipients: z.ZodOptional<z.ZodBoolean>;
 };
-export declare const agentPromptInputSchema: {
-    prompt: z.ZodString;
-    sessionId: z.ZodOptional<z.ZodString>;
-};

package/dist/schemas.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-const recipientTypeSchema = z.enum([
+const lookupSocialTypeSchema = z.enum([
     'email',
     'phone',
     'telegram',
@@ -9,9 +9,13 @@ const recipientTypeSchema = z.enum([
     'github',
     'linkedin',
     'slack',
+]);
+const recipientTypeSchema = z.enum([
+    ...lookupSocialTypeSchema.options,
     'wallet',
     'username',
 ]);
+const exposureRecipientTypeSchema = recipientTypeSchema;
 /** Unified recipient — API validates fully; MCP forwards JSON. */
 export const linkedAccountSchema = z
     .object({
@@ -20,14 +24,28 @@ export const linkedAccountSchema = z
     username: z.string().optional(),
 })
     .passthrough();
+const lookupRecipientSchema = z
+    .object({
+    type: lookupSocialTypeSchema,
+    id: z.string().optional(),
+    username: z.string().optional(),
+})
+    .passthrough();
+const exposureRecipientSchema = z
+    .object({
+    type: exposureRecipientTypeSchema,
+    id: z.string().optional(),
+    username: z.string().optional(),
+})
+    .passthrough();
 export const lookupInputSchema = {
     recipients: z
-        .array(linkedAccountSchema)
+        .array(lookupRecipientSchema)
         .min(1)
         .describe('Recipients to resolve to EVM/Solana wallets'),
 };
 export const lookupExposedInputSchema = {
-    recipient: linkedAccountSchema.describe('Recipient whose exposed linked accounts and Connect profile should be listed'),
+    recipient: exposureRecipientSchema.describe('Social identity, exposed wallet (EVM/Solana/smart wallet), or Connect username whose exposed linked accounts and Connect profile should be listed'),
 };
 export const scoresBatchInputSchema = {
     users: z.array(linkedAccountSchema).min(1).describe('Users to fetch scores for'),
@@ -69,13 +87,23 @@ export const dropBalanceInputSchema = {
 };
 export const dropInputSchema = {
     idempotencyKey: z.string().uuid(),
-    chainId: z.number().int(),
-    tokenContract: z.string().nullable().optional(),
-    recipients: z.array(linkedAccountSchema).min(1),
-    amountInWeiPerRecipient: z.string().optional().nullable(),
-    ignoreFailedRecipients: z.boolean().optional(),
-};
-export const agentPromptInputSchema = {
-    prompt: z.string().min(1).max(4000),
-    sessionId: z.string().uuid().optional(),
+    chainId: z.number().int().describe('EVM chain ID (Smart Send supported chains only)'),
+    tokenContract: z
+        .string()
+        .nullable()
+        .optional()
+        .describe('ERC-20 contract address. Omit or null for the chain native token (ETH, POL, AVAX). Do not use the zero address.'),
+    recipients: z
+        .array(linkedAccountSchema)
+        .min(1)
+        .describe('Wallet or social recipients (all wallet or all social, no mix). Optional amountInWei per recipient uses the same smallest-unit rules as amountInWeiPerRecipient.'),
+    amountInWeiPerRecipient: z
+        .string()
+        .optional()
+        .nullable()
+        .describe('Uniform amount in smallest units (wei). Native ETH uses 18 decimals; ERC-20 uses token decimals from connect_drop_balance (USDC usually 6). Omit when setting amountInWei on each recipient.'),
+    ignoreFailedRecipients: z
+        .boolean()
+        .optional()
+        .describe('When true, send to recipients that resolved successfully and skip failed lookups.'),
 };

package/dist/tools/register.d.ts

@@ -1,4 +1,4 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { ConnectClient } from '../client.js';
-export declare const CONNECT_MCP_TOOL_NAMES: readonly ["connect_get_price", "connect_lookup", "connect_lookup_exposed", "connect_scores_batch", "connect_scores_by_account", "connect_scores_by_username", "connect_me", "connect_drop", "connect_drop_balance", "connect_agent_prompt"];
+export declare const CONNECT_MCP_TOOL_NAMES: readonly ["connect_get_price", "connect_get_chains", "connect_lookup", "connect_lookup_exposed", "connect_scores_batch", "connect_scores_by_account", "connect_scores_by_username", "connect_me", "connect_drop", "connect_drop_balance"];
 export declare function registerTools(server: McpServer, client: ConnectClient): void;

package/dist/tools/register.js

@@ -1,7 +1,7 @@
-import { agentPromptInputSchema, dropBalanceInputSchema, dropInputSchema, lookupExposedInputSchema, lookupInputSchema, scoresBatchInputSchema, scoresByAccountInputSchema, scoresByUsernameInputSchema, } from '../schemas.js';
-const AGENT_TIMEOUT_MS = 65_000;
+import { dropBalanceInputSchema, dropInputSchema, lookupExposedInputSchema, lookupInputSchema, scoresBatchInputSchema, scoresByAccountInputSchema, scoresByUsernameInputSchema, } from '../schemas.js';
 export const CONNECT_MCP_TOOL_NAMES = [
     'connect_get_price',
+    'connect_get_chains',
     'connect_lookup',
     'connect_lookup_exposed',
     'connect_scores_batch',
@@ -10,16 +10,16 @@ export const CONNECT_MCP_TOOL_NAMES = [
     'connect_me',
     'connect_drop',
     'connect_drop_balance',
-    'connect_agent_prompt',
 ];
 export function registerTools(server, client) {
-    server.tool('connect_get_price', 'Get public x402 list prices for lookup, scores, and agent (reference only; live paywall amounts are in 402 responses).', {}, async () => client.request({ method: 'GET', path: '/price', authenticated: false }));
+    server.tool('connect_get_price', 'Get public x402 list prices for lookup and scores (reference only; live paywall amounts are in 402 responses).', {}, async () => client.request({ method: 'GET', path: '/price', authenticated: false }));
+    server.tool('connect_get_chains', 'List product chains with per-feature compatibility. lookup is true for EVM catalog chains and Solana; drop is true only for Smart Send EVM chains (use those chainIds for connect_drop / connect_drop_balance).', {}, async () => client.request({ method: 'GET', path: '/chains', authenticated: false }));
     server.tool('connect_lookup', 'Resolve social identities to EVM and Solana wallet addresses. If status is processing, retry the same payload.', lookupInputSchema, async ({ recipients }) => client.request({
         method: 'POST',
         path: '/lookup',
         body: { recipients },
     }));
-    server.tool('connect_lookup_exposed', 'List platforms a recipient has exposed on Connect, with enriched profile, scores, and wallet addresses. May require x402 payment when the profile owner charges for lookups.', lookupExposedInputSchema, async ({ recipient }) => client.request({
+    server.tool('connect_lookup_exposed', 'List platforms a recipient has exposed on Connect, with enriched profile, scores, and wallet addresses. Recipient may be a social account, an exposed wallet (EVM/Solana/smart wallet), or a Connect username. May require x402 payment when the profile owner charges for lookups.', lookupExposedInputSchema, async ({ recipient }) => client.request({
         method: 'POST',
         path: '/lookup/exposed',
         body: { recipient },
@@ -41,7 +41,7 @@ export function registerTools(server, client) {
         method: 'GET',
         path: '/account/me',
     }));
-    server.tool('connect_drop', 'Execute a Smart Send (batch token transfer). Returns 201 when submitted or 202 when recipients still processing — retry with same idempotencyKey.', dropInputSchema, async ({ ignoreFailedRecipients, ...body }) => client.request({
+    server.tool('connect_drop', 'Execute a Smart Send (batch native or ERC-20 transfer). Omit tokenContract or set it to null for the chain native token (ETH on 1/8453/10/42161/480, POL on 137, AVAX on 43114); pass the ERC-20 contract address otherwise — do not use the zero address. Amounts are smallest-unit integer strings; use connect_drop_balance decimals (native ETH = 18, USDC usually 6). Returns 201 when submitted or 202 when recipients still processing — retry with the same idempotencyKey.', dropInputSchema, async ({ ignoreFailedRecipients, ...body }) => client.request({
         method: 'POST',
         path: '/drop',
         body,
@@ -56,13 +56,4 @@ export function registerTools(server, client) {
         requireApiKey: true,
         query: { chainId: String(chainId) },
     }));
-    server.tool('connect_agent_prompt', 'Natural-language agent turn for Farcaster/Lens cohort discovery. Blocking up to 60s. Omit sessionId to start; include to continue. Do not send requester.', agentPromptInputSchema, async ({ prompt, sessionId }) => client.request({
-        method: 'POST',
-        path: '/agent',
-        body: {
-            prompt,
-            ...(sessionId ? { sessionId } : {}),
-        },
-        timeoutMs: AGENT_TIMEOUT_MS,
-    }));
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@quidli/connect-mcp",
-  "version": "0.5.5",
-  "description": "Identity and reputation for AI agents: resolve social handles to wallet addresses, check reputation scores, and send tokens from any MCP client.",
+  "version": "0.5.7",
+  "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.",
   "keywords": [
     "mcp",
     "mcp-server",
@@ -10,6 +10,7 @@
     "agent",
     "web3-agent",
     "agent-payments",
+    "multiplayer-agents",
     "identity",
     "identity-resolution",
     "reputation",
@@ -17,9 +18,16 @@
     "wallet",
     "usdc",
     "farcaster",
-    "x402"
+    "x402",
+    "ethereum",
+    "solana",
+    "base",
+    "crypto",
+    "claude",
+    "cursor",
+    "claude-desktop"
   ],
-  "homepage": "https://quidli.xyz",
+  "homepage": "https://connect.quid.li",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Quidli/connect-mcp.git"