arcid-mcp 0.1.0 → 0.2.0

package/README.md

@@ -17,7 +17,21 @@ Read-only. No wallet or API key needed.
 | `get_registry_stats` | Index totals |
 | `get_indexer_health` | How far the indexer is behind the chain head |
 
-## Install
+## Connect
+
+### Remote (claude.ai, ChatGPT, any URL-based client)
+
+```
+https://mcp.arcusid.com/mcp
+```
+
+Streamable HTTP, stateless, no authentication.
+
+- **claude.ai / Claude Desktop:** Settings → Connectors → Add custom connector → paste the URL.
+- **ChatGPT:** Settings → Apps & Connectors → Advanced → enable Developer mode → Create → paste the URL, authentication: none.
+- **Claude Code:** `claude mcp add --transport http arcid https://mcp.arcusid.com/mcp`
+
+### Local (stdio via npx)
 
 No install step needed; clients run it with `npx`.
 
@@ -55,8 +69,14 @@ npm run dev            # run from source (tsx)
 npm test               # vitest
 npm run test:coverage  # 80% threshold enforced
 npm run inspect        # MCP Inspector against dist/
+npm run worker:dev     # remote endpoint locally (wrangler)
+npm run worker:deploy  # typecheck, test, deploy the Worker
 ```
 
+The remote endpoint is `worker/index.ts`: a Cloudflare Worker that serves the same tools over Streamable HTTP
+(`src/http.ts`). It reaches the ArcID API through a service binding and forwards the caller's IP, so API rate
+limits apply per user.
+
 ## License
 
 MIT

package/dist/http.js

@@ -0,0 +1,49 @@
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+import { createServer } from "./server.js";
+// Remote (Streamable HTTP) transport for runtimes with web-standard Request/Response, e.g. Cloudflare Workers.
+// Stateless: every POST gets a fresh server and transport, so no session state lives between requests.
+export const MCP_PATH = "/mcp";
+export const MAX_BODY_BYTES = 64 * 1024;
+const CORS_HEADERS = {
+    "access-control-allow-origin": "*",
+    "access-control-allow-methods": "POST, OPTIONS",
+    "access-control-allow-headers": "content-type, accept, authorization, mcp-protocol-version, mcp-session-id, last-event-id",
+    "access-control-expose-headers": "mcp-session-id, mcp-protocol-version",
+    "access-control-max-age": "600",
+};
+function withCors(res) {
+    const headers = new Headers(res.headers);
+    for (const [k, v] of Object.entries(CORS_HEADERS))
+        headers.set(k, v);
+    return new Response(res.body, { status: res.status, statusText: res.statusText, headers });
+}
+function rpcError(status, message, extra = {}) {
+    const body = JSON.stringify({ jsonrpc: "2.0", error: { code: -32000, message }, id: null });
+    return withCors(new Response(body, { status, headers: { "content-type": "application/json", ...extra } }));
+}
+export async function handleMcpHttp(request, client) {
+    if (request.method === "OPTIONS")
+        return withCors(new Response(null, { status: 204 }));
+    if (request.method !== "POST") {
+        return rpcError(405, "Method not allowed. This endpoint is stateless: send JSON-RPC over POST.", { allow: "POST, OPTIONS" });
+    }
+    const server = createServer(client);
+    const transport = new WebStandardStreamableHTTPServerTransport({
+        sessionIdGenerator: undefined,
+        enableJsonResponse: true,
+        maxRequestBodySize: MAX_BODY_BYTES,
+    });
+    try {
+        await server.connect(transport);
+        return withCors(await transport.handleRequest(request));
+    }
+    catch (err) {
+        console.error("[arcid-mcp] http transport error", err);
+        return rpcError(500, "Internal error");
+    }
+    finally {
+        // Response bodies are fully materialised in JSON mode, so closing here is safe.
+        await transport.close().catch(() => { });
+        await server.close().catch(() => { });
+    }
+}

package/dist/server.js

@@ -1,7 +1,7 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { registerTools } from "./tools.js";
 export const SERVER_NAME = "arcid";
-export const SERVER_VERSION = "0.1.0";
+export const SERVER_VERSION = "0.2.0";
 export function createServer(client) {
     const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION }, {
         instructions: "ArcID indexes AI agent identities and reputation from the ERC-8004 registries on Arc. " +

package/dist/tools.js

@@ -30,7 +30,8 @@ export function registerTools(server, client) {
         inputSchema: {
             query: z.string().trim().max(120).optional().describe("Full-text search (prefix match on words)"),
             owner: z.string().regex(/^0x[0-9a-fA-F]{40}$/, "owner must be a 0x address").optional().describe("Owner wallet address"),
-            readable_only: z.boolean().optional().describe("Only agents whose profile could be parsed"),
+            readable_only: z.boolean().default(true)
+                .describe("Only agents with a readable profile (name, description). Default true; set false to include unnamed agents"),
             sort: z.enum(["newest", "score", "feedback", "settled", "relevance"]).optional()
                 .describe("Default: relevance when a query is given, otherwise newest"),
             page,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcid-mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server for ArcID: look up AI agent identity and reputation (ERC-8004) on Arc",
   "type": "module",
   "bin": {
@@ -15,11 +15,13 @@
   "scripts": {
     "dev": "tsx src/index.ts",
     "build": "tsc -p tsconfig.build.json",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsc --noEmit && tsc -p worker/tsconfig.json",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
     "inspect": "npx @modelcontextprotocol/inspector node dist/index.js",
-    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+    "prepublishOnly": "npm run typecheck && npm test && npm run build",
+    "worker:dev": "wrangler dev",
+    "worker:deploy": "npm run typecheck && npm test && wrangler deploy"
   },
   "keywords": [
     "mcp",
@@ -48,10 +50,12 @@
     "zod": "^4.6.5"
   },
   "devDependencies": {
+    "@cloudflare/workers-types": "^5.20260927.1",
     "@types/node": "^26.6.3",
     "@vitest/coverage-v8": "^5.0.2",
     "tsx": "^4.23.15",
     "typescript": "^5.9.3",
-    "vitest": "^5.0.2"
+    "vitest": "^5.0.2",
+    "wrangler": "^4.142.0"
   }
 }