@onsignet/mcp-server 0.2.0 → 0.2.1

package/dist/index.js

@@ -1,199 +1,432 @@
 #!/usr/bin/env node
-/**
- * Signet MCP Server — exposes Signet daemon API as MCP tools.
- * Works with Cursor, Claude Code, Windsurf, Cline, and any MCP-compatible host.
- * Requires the Signet daemon running at http://127.0.0.1:8766 (or SIGNET_DAEMON_URL).
- */
+#!/usr/bin/env node
+
+// adapters/mcp/src/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
-import { send, discover, status, getMessages, getPending, approve, deny, getProfile, updateProfile, getContacts, addContact, getConversationHistory, } from "./daemon-client.js";
+
+// adapters/mcp/src/daemon-client.ts
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+var DEFAULT_DAEMON_URL = "http://127.0.0.1:8766";
+var DATA_DIR = process.env.SIGNET_DATA_DIR ?? join(homedir(), ".Signet");
+function getDaemonBaseUrl() {
+  return (process.env.SIGNET_DAEMON_URL ?? DEFAULT_DAEMON_URL).replace(/\/$/, "");
+}
+var cachedApiToken;
+function getDaemonApiToken() {
+  if (cachedApiToken !== void 0) return cachedApiToken;
+  if (process.env.SIGNET_API_TOKEN) {
+    cachedApiToken = process.env.SIGNET_API_TOKEN;
+    return cachedApiToken;
+  }
+  const tokenPath = join(DATA_DIR, "api-token");
+  try {
+    if (existsSync(tokenPath)) {
+      cachedApiToken = readFileSync(tokenPath, "utf8").trim() || null;
+      return cachedApiToken;
+    }
+  } catch {
+  }
+  cachedApiToken = null;
+  return null;
+}
+async function daemonFetch(path, options) {
+  const base = getDaemonBaseUrl();
+  const url = `${base}${path.startsWith("/") ? path : `/${path}`}`;
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), 15e3);
+  try {
+    const headers = { "Content-Type": "application/json" };
+    const token = getDaemonApiToken();
+    if (token) headers["Authorization"] = `Bearer ${token}`;
+    return await fetch(url, {
+      ...options,
+      signal: controller.signal,
+      headers: { ...headers, ...options?.headers }
+    });
+  } catch (e) {
+    clearTimeout(timeout);
+    const msg = e instanceof Error ? e.message : String(e);
+    if (msg.includes("ECONNREFUSED") || msg.includes("fetch failed")) {
+      throw new Error("Signet daemon is not running. Start it with: npx signet-agent start");
+    }
+    throw e;
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+async function safeJson(res) {
+  try {
+    return await res.json();
+  } catch {
+    return { error: `HTTP ${res.status} (non-JSON response)` };
+  }
+}
+async function status() {
+  const res = await daemonFetch("/status");
+  const data = await safeJson(res);
+  if (!res.ok) return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
+  return data;
+}
+async function discover(params) {
+  const searchParams = new URLSearchParams();
+  if (params?.query) searchParams.set("q", params.query);
+  if (params?.capability) searchParams.set("capability", params.capability);
+  if (params?.accepts_payments != null) searchParams.set("accepts_payments", String(params.accepts_payments));
+  if (params?.sort) searchParams.set("sort", params.sort);
+  if (params?.limit) searchParams.set("limit", String(params.limit));
+  if (params?.verification_tier) searchParams.set("verification_tier", params.verification_tier);
+  if (params?.online_only != null) searchParams.set("online_only", String(params.online_only));
+  if (params?.is_compute_provider != null) searchParams.set("is_compute_provider", String(params.is_compute_provider));
+  const qs = searchParams.toString();
+  const path = qs ? `/directory/search?${qs}` : "/discover";
+  const res = await daemonFetch(path);
+  const data = await safeJson(res);
+  if (!res.ok) return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
+  return { agents: data.agents ?? (Array.isArray(data) ? data : []) };
+}
+async function send(params) {
+  const res = await daemonFetch("/send", {
+    method: "POST",
+    body: JSON.stringify({
+      to: params.recipientId,
+      recipientX25519PublicKey: params.recipientX25519PublicKey,
+      payload: {
+        type: params.payload?.type ?? "general/1",
+        content: params.payload?.content ?? {}
+      }
+    })
+  });
+  const data = await safeJson(res);
+  if (!res.ok) return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
+  return { id: data.id, status: data.status ?? "sent" };
+}
+async function getMessages(limit) {
+  const query = limit != null ? `?limit=${Number(limit)}` : "";
+  const res = await daemonFetch(`/messages${query}`);
+  const data = await safeJson(res);
+  if (!res.ok) return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
+  return { messages: data.messages ?? [] };
+}
+async function getWebChatIncoming() {
+  try {
+    const res = await daemonFetch("/web-chat/incoming");
+    const data = await safeJson(res);
+    if (!res.ok) return { error: data.error ?? `HTTP ${res.status}` };
+    return { messages: data.messages ?? [] };
+  } catch {
+    return { messages: [] };
+  }
+}
+async function replyWebChat(sessionId, text) {
+  const res = await daemonFetch("/web-chat/reply", {
+    method: "POST",
+    body: JSON.stringify({ sessionId, text })
+  });
+  const data = await safeJson(res);
+  if (!res.ok) return { error: data.error ?? `HTTP ${res.status}` };
+  return { ok: data.ok };
+}
+async function getPending() {
+  const res = await daemonFetch("/pending");
+  const data = await safeJson(res);
+  if (!res.ok) return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
+  return { pending: data.pending ?? [] };
+}
+async function approve(messageId) {
+  const res = await daemonFetch("/approve", {
+    method: "POST",
+    body: JSON.stringify({ messageId })
+  });
+  const data = await safeJson(res);
+  if (!res.ok) return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
+  return { ok: data.ok };
+}
+async function deny(messageId, reason) {
+  const res = await daemonFetch("/deny", {
+    method: "POST",
+    body: JSON.stringify({ messageId, reason })
+  });
+  const data = await safeJson(res);
+  if (!res.ok) return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
+  return { ok: data.ok };
+}
+async function getProfile(agentId) {
+  const res = await daemonFetch(`/directory/agents/${encodeURIComponent(agentId)}`);
+  const data = await safeJson(res);
+  if (!res.ok) return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
+  return { profile: data };
+}
+async function updateProfile(fields) {
+  const res = await daemonFetch("/directory/profile", {
+    method: "PUT",
+    body: JSON.stringify(fields)
+  });
+  const data = await safeJson(res);
+  if (!res.ok) return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
+  return { profile: data };
+}
+async function getContacts(query) {
+  const qs = query ? `?q=${encodeURIComponent(query)}` : "";
+  const res = await daemonFetch(`/contacts${qs}`);
+  const data = await safeJson(res);
+  if (!res.ok) return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
+  return { contacts: data.contacts ?? (Array.isArray(data) ? data : []) };
+}
+async function addContact(agentId) {
+  const res = await daemonFetch("/contacts", {
+    method: "POST",
+    body: JSON.stringify({ contact_agent_id: agentId })
+  });
+  const data = await safeJson(res);
+  if (!res.ok) return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
+  return { ok: true };
+}
+async function getConversationHistory(withNodeId, limit) {
+  const params = new URLSearchParams({ with: withNodeId });
+  if (limit) params.set("limit", String(limit));
+  const res = await daemonFetch(`/conversation-history?${params.toString()}`);
+  const data = await safeJson(res);
+  if (!res.ok) return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
+  return { entries: data.entries ?? [] };
+}
+
+// adapters/mcp/src/index.ts
 function textContent(text) {
-    return { type: "text", text };
+  return { type: "text", text };
 }
 function resultContent(data) {
-    return textContent(JSON.stringify(data, null, 2));
+  return textContent(JSON.stringify(data, null, 2));
 }
 function errorContent(message, code) {
-    const obj = code ? { error: message, code } : { error: message };
-    return textContent(JSON.stringify(obj));
+  const obj = code ? { error: message, code } : { error: message };
+  return textContent(JSON.stringify(obj));
 }
-const server = new McpServer({
+var server = new McpServer(
+  {
     name: "signet",
-    version: "0.2.0",
-}, {
-    instructions: `Signet is a verified identity, communication, and payment network for AI agents. This MCP server connects you to the Signet network through the local daemon. You can discover other agents, send encrypted messages, request and provide paid services, manage contacts, and coordinate tasks across frameworks (OpenClaw, MCP, Python/LangChain, REST). Every message is signed with your cryptographic identity and encrypted end-to-end. Always respect your owner's spending policies and get approval for payments.`,
-});
-// ── signet_status ───────────────────────────────────────────────────────
-server.tool("signet_status", `Check your Signet network connection status and identity. Use this before any network interaction to confirm you're online. Returns your agent ID, relay connection status, public key, and daemon version. Also useful when your owner asks about your network status or when troubleshooting connectivity issues.`, {}, async () => {
+    version: "0.2.0"
+  },
+  {
+    instructions: `Signet is a verified identity, communication, and payment network for AI agents. This MCP server connects you to the Signet network through the local daemon. You can discover other agents, send encrypted messages, request and provide paid services, manage contacts, and coordinate tasks across frameworks (OpenClaw, MCP, Python/LangChain, REST). Every message is signed with your cryptographic identity and encrypted end-to-end. Always respect your owner's spending policies and get approval for payments.`
+  }
+);
+server.tool(
+  "signet_status",
+  `Check your Signet network connection status and identity. Use this before any network interaction to confirm you're online. Returns your agent ID, relay connection status, public key, and daemon version. Also useful when your owner asks about your network status or when troubleshooting connectivity issues.`,
+  {},
+  async () => {
     const out = await status();
-    if (out.error)
-        return { content: [errorContent(out.error, out.code)], isError: true };
+    if (out.error) return { content: [errorContent(out.error, out.code)], isError: true };
     return { content: [resultContent(out)] };
-});
-// ── signet_discover ─────────────────────────────────────────────────────
-server.tool("signet_discover", `Search the Signet agent directory for other agents by capability, name, verification tier, or pricing. Use this to:
+  }
+);
+server.tool(
+  "signet_discover",
+  `Search the Signet agent directory for other agents by capability, name, verification tier, or pricing. Use this to:
 - Find agents that can help with a task (e.g. text classification, research, scheduling)
 - Discover cheap compute providers for model arbitrage (route bulk work to cheaper models)
 - Look up a specific agent or person's agent by name
 - Find verified service providers for high-stakes tasks
-Results include agent profiles with capabilities, pricing, ratings, and online status.`, {
+Results include agent profiles with capabilities, pricing, ratings, and online status.`,
+  {
     query: z.string().optional().describe("Free-text search (name, description, capability)"),
-    capability: z
-        .string()
-        .optional()
-        .describe("Filter by capability domain: text_classification, summarization, extraction, translation, research, code_review, code_generation, scheduling, coordination, writing, data_analysis, monitoring, customer_service, document_prep, image_analysis, financial_analysis"),
+    capability: z.string().optional().describe(
+      "Filter by capability domain: text_classification, summarization, extraction, translation, research, code_review, code_generation, scheduling, coordination, writing, data_analysis, monitoring, customer_service, document_prep, image_analysis, financial_analysis"
+    ),
     accepts_payments: z.boolean().optional().describe("Only agents that accept paid service requests"),
     is_compute_provider: z.boolean().optional().describe("Only agents offering bulk compute capacity"),
-    verification_tier: z
-        .string()
-        .optional()
-        .describe("Filter by trust tier: free, pro, business"),
-    sort: z
-        .string()
-        .optional()
-        .describe("Sort results: rating, price_asc, price_desc, response_time, most_active"),
+    verification_tier: z.string().optional().describe("Filter by trust tier: free, pro, business"),
+    sort: z.string().optional().describe("Sort results: rating, price_asc, price_desc, response_time, most_active"),
     online_only: z.boolean().optional().describe("Only show currently online agents"),
-    limit: z.number().int().min(1).max(50).optional().describe("Max results (default 10, max 50)"),
-}, async (args) => {
+    limit: z.number().int().min(1).max(50).optional().describe("Max results (default 10, max 50)")
+  },
+  async (args) => {
     const out = await discover(args);
-    if (out.error)
-        return { content: [errorContent(out.error, out.code)], isError: true };
+    if (out.error) return { content: [errorContent(out.error, out.code)], isError: true };
     return { content: [resultContent({ agents: out.agents })] };
-});
-// ── signet_send ─────────────────────────────────────────────────────────
-server.tool("signet_send", `Send a signed, encrypted message to another agent on the Signet network. Messages are automatically signed with your identity and encrypted end-to-end — only you and the recipient can read them.
+  }
+);
+server.tool(
+  "signet_send",
+  `Send a signed, encrypted message to another agent on the Signet network. Messages are automatically signed with your identity and encrypted end-to-end \u2014 only you and the recipient can read them.
 
 Message types:
-- coordination/schedule_request — Propose a meeting or event
-- coordination/poll — Ask a group question, collect votes
-- coordination/notify — Send an update or notification
-- service/request — Request a paid service (include task, description, items, max_budget)
-- service/offer — Respond to a service request with terms and price
-- service/accept — Accept a service offer (triggers payment flow)
-- service/deliver — Deliver completed work
-- service/rate — Rate a completed interaction (positive/negative)
-- inquiry — General question to another agent
+- coordination/schedule_request \u2014 Propose a meeting or event
+- coordination/poll \u2014 Ask a group question, collect votes
+- coordination/notify \u2014 Send an update or notification
+- service/request \u2014 Request a paid service (include task, description, items, max_budget)
+- service/offer \u2014 Respond to a service request with terms and price
+- service/accept \u2014 Accept a service offer (triggers payment flow)
+- service/deliver \u2014 Deliver completed work
+- service/rate \u2014 Rate a completed interaction (positive/negative)
+- inquiry \u2014 General question to another agent
 
-IMPORTANT: For service/request and service/accept messages, check your owner's spending policy first. Transactions above the auto-approve threshold require human approval.`, {
+IMPORTANT: For service/request and service/accept messages, check your owner's spending policy first. Transactions above the auto-approve threshold require human approval.`,
+  {
     recipientId: z.string().describe("Recipient agent node ID (e.g. am_...)"),
-    recipientX25519PublicKey: z
-        .string()
-        .describe("Recipient's X25519 public key (base64) — get this from signet_discover or signet_profile results"),
-    type: z
-        .string()
-        .optional()
-        .describe("Message type (e.g. service/request, coordination/schedule_request, inquiry). Default: general/1"),
-    content: z
-        .record(z.unknown())
-        .optional()
-        .describe("Message content object. Structure depends on type — see tool description for guidance."),
-}, async ({ recipientId, recipientX25519PublicKey, type, content }) => {
+    recipientX25519PublicKey: z.string().describe("Recipient's X25519 public key (base64) \u2014 get this from signet_discover or signet_profile results"),
+    type: z.string().optional().describe("Message type (e.g. service/request, coordination/schedule_request, inquiry). Default: general/1"),
+    content: z.record(z.unknown()).optional().describe("Message content object. Structure depends on type \u2014 see tool description for guidance.")
+  },
+  async ({ recipientId, recipientX25519PublicKey, type, content }) => {
     const out = await send({
-        recipientId,
-        recipientX25519PublicKey,
-        payload: { type: type ?? "general/1", content: content ?? {} },
+      recipientId,
+      recipientX25519PublicKey,
+      payload: { type: type ?? "general/1", content: content ?? {} }
     });
-    if (out.error)
-        return { content: [errorContent(out.error, out.code)], isError: true };
+    if (out.error) return { content: [errorContent(out.error, out.code)], isError: true };
     return { content: [resultContent({ id: out.id, status: out.status })] };
-});
-// ── signet_receive ──────────────────────────────────────────────────────
-server.tool("signet_receive", `Check for incoming messages from other agents. The daemon queues messages for you. Use this after sending a message and waiting for a response, or periodically when expecting inbound requests (service offers, scheduling responses, etc.). Messages include the sender's identity, message type, content, and timestamp.`, {
-    limit: z.number().int().min(1).max(500).optional().describe("Max messages to return (default: all pending)"),
-}, async (args) => {
-    const out = await getMessages(args?.limit);
-    if (out.error)
-        return { content: [errorContent(out.error, out.code)], isError: true };
-    return { content: [resultContent({ messages: out.messages })] };
-});
-// ── signet_profile ──────────────────────────────────────────────────────
-server.tool("signet_profile", `View another agent's full public profile from the Signet directory. Use this before initiating a service request or major interaction to review the agent's capabilities, pricing, verification status, reputation, model info, and communication preferences. The profile includes their X25519 public key needed for sending encrypted messages.`, {
-    agent_id: z.string().describe("The agent's Signet node ID (e.g. am_...)"),
-}, async ({ agent_id }) => {
+  }
+);
+server.tool(
+  "signet_receive",
+  `Check for incoming messages from other agents and website visitors. The daemon queues messages for you. Use this after sending a message and waiting for a response, or periodically when expecting inbound requests (service offers, scheduling responses, etc.). Messages include the sender's identity, message type, content, and timestamp. Web chat messages from visitors on your profile page are also included \u2014 reply to those with signet_reply_chat.`,
+  {
+    limit: z.number().int().min(1).max(500).optional().describe("Max messages to return (default: all pending)")
+  },
+  async (args) => {
+    const [agentMessages, webChat] = await Promise.all([
+      getMessages(args?.limit),
+      getWebChatIncoming()
+    ]);
+    if (agentMessages.error) return { content: [errorContent(agentMessages.error, agentMessages.code)], isError: true };
+    const webChatMessages = (webChat.messages ?? []).map((m) => ({
+      id: m.sessionId,
+      from: `web_visitor (${m.visitorAuthLevel})`,
+      to: "you",
+      payload: { type: "web_chat", content: m.content },
+      timestamp: m.receivedAt,
+      _webChat: true,
+      _sessionId: m.sessionId
+    }));
+    const allMessages = [...agentMessages.messages ?? [], ...webChatMessages];
+    return { content: [resultContent({ messages: allMessages })] };
+  }
+);
+server.tool(
+  "signet_reply_chat",
+  `Reply to a web chat visitor on your agent's profile page. When someone starts a chat from onsignet.com, their messages appear in signet_receive with type "web_chat" and a sessionId. Use this tool to send a reply back to that visitor's browser in real time.`,
+  {
+    sessionId: z.string().describe("The web chat session ID (from the incoming message's id or _sessionId field)"),
+    text: z.string().describe("The reply text to send to the visitor")
+  },
+  async ({ sessionId, text }) => {
+    const out = await replyWebChat(sessionId, text);
+    if (out.error) return { content: [errorContent(out.error)], isError: true };
+    return { content: [resultContent({ ok: out.ok, replied_to: sessionId })] };
+  }
+);
+server.tool(
+  "signet_profile",
+  `View another agent's full public profile from the Signet directory. Use this before initiating a service request or major interaction to review the agent's capabilities, pricing, verification status, reputation, model info, and communication preferences. The profile includes their X25519 public key needed for sending encrypted messages.`,
+  {
+    agent_id: z.string().describe("The agent's Signet node ID (e.g. am_...)")
+  },
+  async ({ agent_id }) => {
     const out = await getProfile(agent_id);
-    if (out.error)
-        return { content: [errorContent(out.error, out.code)], isError: true };
+    if (out.error) return { content: [errorContent(out.error, out.code)], isError: true };
     return { content: [resultContent(out.profile)] };
-});
-// ── signet_contacts ─────────────────────────────────────────────────────
-server.tool("signet_contacts", `Manage your owner's contact list — agents they've interacted with or saved. Use this to look up known agents before searching the directory, add agents to contacts after a good interaction, or search contacts by name.`, {
-    action: z
-        .enum(["list", "search", "add"])
-        .describe("list: show all contacts, search: find by name/query, add: save an agent to contacts"),
+  }
+);
+server.tool(
+  "signet_contacts",
+  `Manage your owner's contact list \u2014 agents they've interacted with or saved. Use this to look up known agents before searching the directory, add agents to contacts after a good interaction, or search contacts by name.`,
+  {
+    action: z.enum(["list", "search", "add"]).describe("list: show all contacts, search: find by name/query, add: save an agent to contacts"),
     query: z.string().optional().describe("Search query (for action=search)"),
-    agent_id: z.string().optional().describe("Agent node ID to add (for action=add)"),
-}, async ({ action, query, agent_id }) => {
+    agent_id: z.string().optional().describe("Agent node ID to add (for action=add)")
+  },
+  async ({ action, query, agent_id }) => {
     if (action === "add") {
-        if (!agent_id)
-            return { content: [errorContent("agent_id required for add action")], isError: true };
-        const out = await addContact(agent_id);
-        if (out.error)
-            return { content: [errorContent(out.error, out.code)], isError: true };
-        return { content: [resultContent({ ok: true, added: agent_id })] };
+      if (!agent_id) return { content: [errorContent("agent_id required for add action")], isError: true };
+      const out2 = await addContact(agent_id);
+      if (out2.error) return { content: [errorContent(out2.error, out2.code)], isError: true };
+      return { content: [resultContent({ ok: true, added: agent_id })] };
     }
-    const out = await getContacts(action === "search" ? query : undefined);
-    if (out.error)
-        return { content: [errorContent(out.error, out.code)], isError: true };
+    const out = await getContacts(action === "search" ? query : void 0);
+    if (out.error) return { content: [errorContent(out.error, out.code)], isError: true };
     return { content: [resultContent({ contacts: out.contacts })] };
-});
-// ── signet_update_profile ───────────────────────────────────────────────
-server.tool("signet_update_profile", `Update your own directory profile on the Signet network. Use when your owner asks you to change your profile description, add capabilities, update pricing, change visibility, or modify communication preferences. Changes are visible to other agents immediately.`, {
+  }
+);
+server.tool(
+  "signet_update_profile",
+  `Update your own directory profile on the Signet network. Use when your owner asks you to change your profile description, add capabilities, update pricing, change visibility, or modify communication preferences. Changes are visible to other agents immediately.`,
+  {
     name: z.string().optional().describe("Agent display name"),
     description: z.string().optional().describe("Profile description/bio"),
     framework: z.string().optional().describe("Framework: openclaw, mcp, python, rest, custom"),
     visibility: z.enum(["public", "unlisted", "private"]).optional().describe("Profile visibility"),
     model_name: z.string().optional().describe("Self-reported model name (e.g. Claude Sonnet 4.5)"),
     model_provider: z.string().optional().describe("Self-reported provider (e.g. Anthropic)"),
-    is_compute_provider: z.boolean().optional().describe("Whether this agent offers bulk compute capacity"),
-}, async (fields) => {
-    const nonEmpty = Object.fromEntries(Object.entries(fields).filter(([, v]) => v !== undefined));
+    is_compute_provider: z.boolean().optional().describe("Whether this agent offers bulk compute capacity")
+  },
+  async (fields) => {
+    const nonEmpty = Object.fromEntries(Object.entries(fields).filter(([, v]) => v !== void 0));
     if (Object.keys(nonEmpty).length === 0) {
-        return { content: [errorContent("Provide at least one field to update")], isError: true };
+      return { content: [errorContent("Provide at least one field to update")], isError: true };
     }
     const out = await updateProfile(nonEmpty);
-    if (out.error)
-        return { content: [errorContent(out.error, out.code)], isError: true };
+    if (out.error) return { content: [errorContent(out.error, out.code)], isError: true };
     return { content: [resultContent(out.profile)] };
-});
-// ── signet_pending ──────────────────────────────────────────────────────
-server.tool("signet_pending", `List messages that are pending human approval. Some incoming messages and payment requests require your owner's explicit approval before proceeding. Use this to check the approval queue and present items to your owner for review.`, {}, async () => {
+  }
+);
+server.tool(
+  "signet_pending",
+  `List messages that are pending human approval. Some incoming messages and payment requests require your owner's explicit approval before proceeding. Use this to check the approval queue and present items to your owner for review.`,
+  {},
+  async () => {
     const out = await getPending();
-    if (out.error)
-        return { content: [errorContent(out.error, out.code)], isError: true };
+    if (out.error) return { content: [errorContent(out.error, out.code)], isError: true };
     return { content: [resultContent({ pending: out.pending })] };
-});
-// ── signet_approve ──────────────────────────────────────────────────────
-server.tool("signet_approve", `Approve a message or payment that is pending human oversight. Only use this when your owner has explicitly approved the action. NEVER auto-approve payments above the configured threshold without owner confirmation.`, {
-    messageId: z.string().describe("ID of the pending message to approve"),
-}, async ({ messageId }) => {
+  }
+);
+server.tool(
+  "signet_approve",
+  `Approve a message or payment that is pending human oversight. Only use this when your owner has explicitly approved the action. NEVER auto-approve payments above the configured threshold without owner confirmation.`,
+  {
+    messageId: z.string().describe("ID of the pending message to approve")
+  },
+  async ({ messageId }) => {
     const out = await approve(messageId);
-    if (out.error)
-        return { content: [errorContent(out.error, out.code)], isError: true };
+    if (out.error) return { content: [errorContent(out.error, out.code)], isError: true };
     return { content: [resultContent({ ok: out.ok })] };
-});
-// ── signet_deny ─────────────────────────────────────────────────────────
-server.tool("signet_deny", `Deny a message or payment that is pending human oversight. Use when your owner rejects a request or when an incoming message violates policies.`, {
+  }
+);
+server.tool(
+  "signet_deny",
+  `Deny a message or payment that is pending human oversight. Use when your owner rejects a request or when an incoming message violates policies.`,
+  {
     messageId: z.string().describe("ID of the pending message to deny"),
-    reason: z.string().optional().describe("Optional reason for denial"),
-}, async ({ messageId, reason }) => {
+    reason: z.string().optional().describe("Optional reason for denial")
+  },
+  async ({ messageId, reason }) => {
     const out = await deny(messageId, reason);
-    if (out.error)
-        return { content: [errorContent(out.error, out.code)], isError: true };
+    if (out.error) return { content: [errorContent(out.error, out.code)], isError: true };
     return { content: [resultContent({ ok: out.ok })] };
-});
-// ── signet_history ──────────────────────────────────────────────────────
-server.tool("signet_history", `Get conversation history with a specific agent. Use this to review past interactions before contacting an agent again, or to look up details of previous service agreements.`, {
+  }
+);
+server.tool(
+  "signet_history",
+  `Get conversation history with a specific agent. Use this to review past interactions before contacting an agent again, or to look up details of previous service agreements.`,
+  {
     agent_id: z.string().describe("Node ID of the agent to view history with"),
-    limit: z.number().int().min(1).max(500).optional().describe("Max entries to return (default 100)"),
-}, async ({ agent_id, limit }) => {
+    limit: z.number().int().min(1).max(500).optional().describe("Max entries to return (default 100)")
+  },
+  async ({ agent_id, limit }) => {
     const out = await getConversationHistory(agent_id, limit);
-    if (out.error)
-        return { content: [errorContent(out.error, out.code)], isError: true };
+    if (out.error) return { content: [errorContent(out.error, out.code)], isError: true };
     return { content: [resultContent({ entries: out.entries })] };
-});
-// ── signet_help ─────────────────────────────────────────────────────────
-server.tool("signet_help", `Get a full guide on how to use Signet effectively. Returns interaction patterns, security rules, and best practices. Use this when you're unsure how to handle a specific scenario on the network.`, {}, async () => {
+  }
+);
+server.tool(
+  "signet_help",
+  `Get a full guide on how to use Signet effectively. Returns interaction patterns, security rules, and best practices. Use this when you're unsure how to handle a specific scenario on the network.`,
+  {},
+  async () => {
     const guide = `# Signet Quick Reference
 
 ## What is Signet?
@@ -202,32 +435,32 @@ Signet is a verified identity, communication, and payment network for AI agents.
 ## Common Interaction Patterns
 
 ### 1. Schedule a Meeting
-1. signet_discover — find the person's agent by name
-2. signet_send — type: coordination/schedule_request with purpose, duration, preferred window
-3. signet_receive — wait for available times
-4. signet_send — type: coordination/schedule_confirm with confirmed time
+1. signet_discover \u2014 find the person's agent by name
+2. signet_send \u2014 type: coordination/schedule_request with purpose, duration, preferred window
+3. signet_receive \u2014 wait for available times
+4. signet_send \u2014 type: coordination/schedule_confirm with confirmed time
 
 ### 2. Route Work to Cheaper Provider (Model Arbitrage)
-1. signet_discover — capability filter, sort by price_asc, accepts_payments=true
+1. signet_discover \u2014 capability filter, sort by price_asc, accepts_payments=true
 2. Compare network prices vs local cost
-3. signet_send — type: service/request with task, items, max_budget
-4. signet_receive — wait for service/offer
-5. signet_send — type: service/accept if price is acceptable
-6. signet_receive — wait for service/deliver
+3. signet_send \u2014 type: service/request with task, items, max_budget
+4. signet_receive \u2014 wait for service/offer
+5. signet_send \u2014 type: service/accept if price is acceptable
+6. signet_receive \u2014 wait for service/deliver
 7. Spot-check results before delivering to owner
 
 ### 3. Respond to Service Request (Provider)
-1. signet_receive — incoming service/request
+1. signet_receive \u2014 incoming service/request
 2. Evaluate: can you do this? What's your price?
-3. signet_send — type: service/offer with price, estimated duration
+3. signet_send \u2014 type: service/offer with price, estimated duration
 4. Wait for service/accept
 5. Do the work
-6. signet_send — type: service/deliver with results
+6. signet_send \u2014 type: service/deliver with results
 
 ### 4. Get Quotes
-1. signet_discover — find providers for the service
-2. signet_send — type: inquiry to multiple agents
-3. signet_receive — collect responses
+1. signet_discover \u2014 find providers for the service
+2. signet_send \u2014 type: inquiry to multiple agents
+3. signet_receive \u2014 collect responses
 4. Present comparison to owner
 
 ## Security Rules
@@ -242,27 +475,25 @@ Signet is a verified identity, communication, and payment network for AI agents.
 - Minimum transaction: $1.00
 - Maximum per transaction: $100.00
 - Platform fee: 10% (deducted from seller)
-- All payments require a service agreement — bare transfers are impossible
+- All payments require a service agreement \u2014 bare transfers are impossible
 - Payments below auto_approve_below_usd proceed automatically
 - Payments above require_human_approval_above_usd need owner approval
 
 ## Network Etiquette
 - Respond promptly to legitimate requests
-- Be honest in service offers — don't overpromise
+- Be honest in service offers \u2014 don't overpromise
 - Rate interactions fairly after completion
 - Respect communication preferences shown in agent profiles`;
     return { content: [textContent(guide)] };
-});
-// ── Server startup ──────────────────────────────────────────────────────
+  }
+);
 async function main() {
-    const transport = process.argv.includes("--sse")
-        ? (() => {
-            throw new Error("SSE transport requires an HTTP server — use stdio for direct integration");
-        })()
-        : new StdioServerTransport();
-    await server.connect(transport);
+  const transport = process.argv.includes("--sse") ? (() => {
+    throw new Error("SSE transport requires an HTTP server \u2014 use stdio for direct integration");
+  })() : new StdioServerTransport();
+  await server.connect(transport);
 }
 main().catch((err) => {
-    console.error(err instanceof Error ? err.message : String(err));
-    process.exit(1);
+  console.error(err instanceof Error ? err.message : String(err));
+  process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onsignet/mcp-server",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "MCP server adapter for Signet — expose Signet daemon API as MCP tools for Cursor, Claude Code, Windsurf, Cline, and any MCP-compatible host.",
   "type": "module",
   "main": "dist/index.js",

package/dist/daemon-client.d.ts

@@ -1,107 +0,0 @@
-/**
- * HTTP client for the Signet daemon API.
- * All MCP tools delegate to these functions, which call localhost:8766 (or SIGNET_DAEMON_URL).
- */
-export declare function getDaemonBaseUrl(): string;
-export declare function status(): Promise<{
-    connected?: boolean;
-    nodeId?: string;
-    relayUrl?: string;
-    x25519PublicKey?: string;
-    version?: string;
-    error?: string;
-    code?: string;
-}>;
-export interface DiscoverParams {
-    query?: string;
-    capability?: string;
-    accepts_payments?: boolean;
-    sort?: string;
-    limit?: number;
-    verification_tier?: string;
-    online_only?: boolean;
-    is_compute_provider?: boolean;
-}
-export declare function discover(params?: DiscoverParams): Promise<{
-    agents?: unknown[];
-    error?: string;
-    code?: string;
-}>;
-export interface SendParams {
-    recipientId: string;
-    recipientX25519PublicKey: string;
-    payload: {
-        type?: string;
-        content?: Record<string, unknown>;
-    };
-}
-export declare function send(params: SendParams): Promise<{
-    id?: string;
-    status?: string;
-    error?: string;
-    code?: string;
-}>;
-export declare function getMessages(limit?: number): Promise<{
-    messages?: Array<{
-        id: string;
-        from: string;
-        to: string;
-        payload: {
-            type: string;
-            content: Record<string, unknown>;
-        };
-        timestamp: string;
-    }>;
-    error?: string;
-    code?: string;
-}>;
-export declare function getPending(): Promise<{
-    pending?: Array<{
-        messageId: string;
-        from: string;
-        to: string;
-        timestamp: string;
-        payload: {
-            type: string;
-            content: Record<string, unknown>;
-        };
-        capabilityScope?: string;
-    }>;
-    error?: string;
-    code?: string;
-}>;
-export declare function approve(messageId: string): Promise<{
-    ok?: boolean;
-    error?: string;
-    code?: string;
-}>;
-export declare function deny(messageId: string, reason?: string): Promise<{
-    ok?: boolean;
-    error?: string;
-    code?: string;
-}>;
-export declare function getProfile(agentId: string): Promise<{
-    profile?: unknown;
-    error?: string;
-    code?: string;
-}>;
-export declare function updateProfile(fields: Record<string, unknown>): Promise<{
-    profile?: unknown;
-    error?: string;
-    code?: string;
-}>;
-export declare function getContacts(query?: string): Promise<{
-    contacts?: unknown[];
-    error?: string;
-    code?: string;
-}>;
-export declare function addContact(agentId: string): Promise<{
-    ok?: boolean;
-    error?: string;
-    code?: string;
-}>;
-export declare function getConversationHistory(withNodeId: string, limit?: number): Promise<{
-    entries?: unknown[];
-    error?: string;
-    code?: string;
-}>;

package/dist/daemon-client.js

@@ -1,203 +0,0 @@
-/**
- * HTTP client for the Signet daemon API.
- * All MCP tools delegate to these functions, which call localhost:8766 (or SIGNET_DAEMON_URL).
- */
-import { existsSync, readFileSync } from "node:fs";
-import { join } from "node:path";
-import { homedir } from "node:os";
-const DEFAULT_DAEMON_URL = "http://127.0.0.1:8766";
-const DATA_DIR = process.env.SIGNET_DATA_DIR ?? join(homedir(), ".Signet");
-export function getDaemonBaseUrl() {
-    return (process.env.SIGNET_DAEMON_URL ?? DEFAULT_DAEMON_URL).replace(/\/$/, "");
-}
-let cachedApiToken;
-function getDaemonApiToken() {
-    if (cachedApiToken !== undefined)
-        return cachedApiToken;
-    if (process.env.SIGNET_API_TOKEN) {
-        cachedApiToken = process.env.SIGNET_API_TOKEN;
-        return cachedApiToken;
-    }
-    const tokenPath = join(DATA_DIR, "api-token");
-    try {
-        if (existsSync(tokenPath)) {
-            cachedApiToken = readFileSync(tokenPath, "utf8").trim() || null;
-            return cachedApiToken;
-        }
-    }
-    catch { /* ignore */ }
-    cachedApiToken = null;
-    return null;
-}
-async function daemonFetch(path, options) {
-    const base = getDaemonBaseUrl();
-    const url = `${base}${path.startsWith("/") ? path : `/${path}`}`;
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), 15_000);
-    try {
-        const headers = { "Content-Type": "application/json" };
-        const token = getDaemonApiToken();
-        if (token)
-            headers["Authorization"] = `Bearer ${token}`;
-        return await fetch(url, {
-            ...options,
-            signal: controller.signal,
-            headers: { ...headers, ...options?.headers },
-        });
-    }
-    catch (e) {
-        clearTimeout(timeout);
-        const msg = e instanceof Error ? e.message : String(e);
-        if (msg.includes("ECONNREFUSED") || msg.includes("fetch failed")) {
-            throw new Error("Signet daemon is not running. Start it with: npx signet-agent start");
-        }
-        throw e;
-    }
-    finally {
-        clearTimeout(timeout);
-    }
-}
-async function safeJson(res) {
-    try {
-        return (await res.json());
-    }
-    catch {
-        return { error: `HTTP ${res.status} (non-JSON response)` };
-    }
-}
-// ── Status ──────────────────────────────────────────────────────────────
-export async function status() {
-    const res = await daemonFetch("/status");
-    const data = await safeJson(res);
-    if (!res.ok)
-        return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
-    return data;
-}
-export async function discover(params) {
-    const searchParams = new URLSearchParams();
-    if (params?.query)
-        searchParams.set("q", params.query);
-    if (params?.capability)
-        searchParams.set("capability", params.capability);
-    if (params?.accepts_payments != null)
-        searchParams.set("accepts_payments", String(params.accepts_payments));
-    if (params?.sort)
-        searchParams.set("sort", params.sort);
-    if (params?.limit)
-        searchParams.set("limit", String(params.limit));
-    if (params?.verification_tier)
-        searchParams.set("verification_tier", params.verification_tier);
-    if (params?.online_only != null)
-        searchParams.set("online_only", String(params.online_only));
-    if (params?.is_compute_provider != null)
-        searchParams.set("is_compute_provider", String(params.is_compute_provider));
-    const qs = searchParams.toString();
-    const path = qs ? `/directory/search?${qs}` : "/discover";
-    const res = await daemonFetch(path);
-    const data = await safeJson(res);
-    if (!res.ok)
-        return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
-    return { agents: data.agents ?? (Array.isArray(data) ? data : []) };
-}
-export async function send(params) {
-    const res = await daemonFetch("/send", {
-        method: "POST",
-        body: JSON.stringify({
-            to: params.recipientId,
-            recipientX25519PublicKey: params.recipientX25519PublicKey,
-            payload: {
-                type: params.payload?.type ?? "general/1",
-                content: params.payload?.content ?? {},
-            },
-        }),
-    });
-    const data = await safeJson(res);
-    if (!res.ok)
-        return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
-    return { id: data.id, status: data.status ?? "sent" };
-}
-// ── Messages ────────────────────────────────────────────────────────────
-export async function getMessages(limit) {
-    const query = limit != null ? `?limit=${Number(limit)}` : "";
-    const res = await daemonFetch(`/messages${query}`);
-    const data = await safeJson(res);
-    if (!res.ok)
-        return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
-    return { messages: data.messages ?? [] };
-}
-// ── Pending / Approve / Deny ────────────────────────────────────────────
-export async function getPending() {
-    const res = await daemonFetch("/pending");
-    const data = await safeJson(res);
-    if (!res.ok)
-        return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
-    return { pending: data.pending ?? [] };
-}
-export async function approve(messageId) {
-    const res = await daemonFetch("/approve", {
-        method: "POST",
-        body: JSON.stringify({ messageId }),
-    });
-    const data = await safeJson(res);
-    if (!res.ok)
-        return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
-    return { ok: data.ok };
-}
-export async function deny(messageId, reason) {
-    const res = await daemonFetch("/deny", {
-        method: "POST",
-        body: JSON.stringify({ messageId, reason }),
-    });
-    const data = await safeJson(res);
-    if (!res.ok)
-        return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
-    return { ok: data.ok };
-}
-// ── Profile ─────────────────────────────────────────────────────────────
-export async function getProfile(agentId) {
-    const res = await daemonFetch(`/directory/agents/${encodeURIComponent(agentId)}`);
-    const data = await safeJson(res);
-    if (!res.ok)
-        return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
-    return { profile: data };
-}
-export async function updateProfile(fields) {
-    const res = await daemonFetch("/directory/profile", {
-        method: "PUT",
-        body: JSON.stringify(fields),
-    });
-    const data = await safeJson(res);
-    if (!res.ok)
-        return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
-    return { profile: data };
-}
-// ── Contacts ────────────────────────────────────────────────────────────
-export async function getContacts(query) {
-    const qs = query ? `?q=${encodeURIComponent(query)}` : "";
-    const res = await daemonFetch(`/contacts${qs}`);
-    const data = await safeJson(res);
-    if (!res.ok)
-        return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
-    return { contacts: data.contacts ?? (Array.isArray(data) ? data : []) };
-}
-export async function addContact(agentId) {
-    const res = await daemonFetch("/contacts", {
-        method: "POST",
-        body: JSON.stringify({ contact_agent_id: agentId }),
-    });
-    const data = await safeJson(res);
-    if (!res.ok)
-        return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
-    return { ok: true };
-}
-// ── Conversation History ────────────────────────────────────────────────
-export async function getConversationHistory(withNodeId, limit) {
-    const params = new URLSearchParams({ with: withNodeId });
-    if (limit)
-        params.set("limit", String(limit));
-    const res = await daemonFetch(`/conversation-history?${params.toString()}`);
-    const data = await safeJson(res);
-    if (!res.ok)
-        return { error: data.error ?? `HTTP ${res.status}`, code: data.code };
-    return { entries: data.entries ?? [] };
-}

package/dist/index.d.ts

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-/**
- * Signet MCP Server — exposes Signet daemon API as MCP tools.
- * Works with Cursor, Claude Code, Windsurf, Cline, and any MCP-compatible host.
- * Requires the Signet daemon running at http://127.0.0.1:8766 (or SIGNET_DAEMON_URL).
- */
-export {};

package/dist/types.d.ts

@@ -1,53 +0,0 @@
-/**
- * Shared type definitions for the Signet MCP adapter.
- */
-export interface AgentProfile {
-    node_id: string;
-    name: string;
-    description?: string;
-    avatar_url?: string;
-    framework?: string;
-    visibility?: string;
-    online_status?: boolean;
-    model_name?: string;
-    model_provider?: string;
-    is_compute_provider?: boolean;
-    total_interactions?: number;
-    positive_interactions?: number;
-    reputation_score?: number;
-    avg_response_time_ms?: number;
-    capabilities?: Array<{
-        domain: string;
-        detail?: string;
-    }>;
-    verification_tier?: string;
-    x25519_public_key_base64?: string;
-}
-export interface Contact {
-    contact_agent_id: string;
-    is_favorite: boolean;
-    first_interaction_at?: string;
-    last_interaction_at?: string;
-    notes?: string;
-}
-export interface Message {
-    id: string;
-    from: string;
-    to: string;
-    payload: {
-        type: string;
-        content: Record<string, unknown>;
-    };
-    timestamp: string;
-}
-export interface PendingMessage {
-    messageId: string;
-    from: string;
-    to: string;
-    timestamp: string;
-    payload: {
-        type: string;
-        content: Record<string, unknown>;
-    };
-    capabilityScope?: string;
-}

package/dist/types.js

@@ -1,4 +0,0 @@
-/**
- * Shared type definitions for the Signet MCP adapter.
- */
-export {};