@topolo/mcp 0.1.2 → 0.2.1

package/dist/index.js

@@ -58,17 +58,38 @@ var TopoloHttpError = class extends TopoloSdkError {
     this.path = path;
   }
 };
-var DEFAULT_SERVICE_URLS = {
+var SERVICES = {
+  agent: "https://topolo-agent-worker.topolo.workers.dev",
   auth: "https://auth.topolo.app",
-  crm: "https://topolo-crm-worker.topolo.workers.dev"
+  bugfix: "https://bugfix.topolo.app",
+  bytes: "https://r2-media-manager-worker.topolo.workers.dev",
+  chat: "https://chat.topolo.app",
+  commerce: "https://topolo-commerce-api.topolo.workers.dev",
+  crm: "https://crm-api.topolo.app",
+  forecast: "https://forecast-worker-production.topolo.workers.dev",
+  learn: "https://topololearn-api.topolo.workers.dev",
+  mdm: "https://nodo-mdm-api.topolo.app",
+  messaging: "https://messages.topolo.app",
+  nexus: "https://topolo-nexus-gateway.topolo.workers.dev",
+  one: "https://topoloone-worker.topolo.workers.dev",
+  pay: "https://topolo-pay.topolo.workers.dev",
+  "quro.api": "https://api.ol0.me",
+  "quro.redirect": "https://ol0.me",
+  roadmapper: "https://roadmapper-api.topolo.app",
+  social_studio: "https://topolo-social-studio-api.topolo.workers.dev",
+  socialize: "https://socialize-prod-api.topolo.workers.dev",
+  support: "https://support.topolo.app",
+  "web.api": "https://web-api.topolo.app",
+  "web.runtime": "https://sites.topolo.app"
 };
 var PLATFORM_SERVICE_IDS = {
   crm: "srv_iCwM4jGXcwlj"
 };
+var DEFAULT_SERVICE_URLS = SERVICES;
 function resolveServiceUrl(service, overrides) {
   const override = overrides?.[service];
   if (override) return override;
-  const envKey = `TOPOLO_SERVICE_URL_${service.toUpperCase()}`;
+  const envKey = `TOPOLO_SERVICE_URL_${service.replace(/\./g, "_").toUpperCase()}`;
   const envValue = typeof process !== "undefined" ? process.env?.[envKey] : void 0;
   if (envValue) return envValue;
   return DEFAULT_SERVICE_URLS[service];
@@ -390,6 +411,8 @@ function splitService(servicePart) {
 }
 
 // src/tools.ts
+var SERVICE_IDS = Object.keys(DEFAULT_SERVICE_URLS).sort();
+var HTTP_METHODS = ["GET", "POST", "PUT", "PATCH", "DELETE"];
 var TOOLS = [
   {
     name: "topolo_whoami",
@@ -404,6 +427,26 @@ var TOOLS = [
     },
     handler: async (topolo) => topolo.identity.whoami()
   },
+  {
+    name: "topolo_list_services",
+    title: "List every Topolo service the agent can reach",
+    description: "Returns the service registry the SDK knows about: one entry per platform service with its stable service ID and current base URL. Use this to discover what `topolo_api_call` can address \u2014 the service IDs returned here are the exact values accepted by that tool. Pure metadata: no credential introspection, no permission check, no external call.",
+    requiredScopes: [],
+    destructive: false,
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    },
+    handler: async () => {
+      const services = Object.keys(DEFAULT_SERVICE_URLS).sort().map((id) => ({
+        id,
+        defaultUrl: DEFAULT_SERVICE_URLS[id],
+        effectiveUrl: resolveServiceUrl(id)
+      }));
+      return { services };
+    }
+  },
   {
     name: "topolo_crm_list_contacts",
     title: "List CRM contacts",
@@ -427,6 +470,75 @@ var TOOLS = [
       });
     }
   },
+  {
+    name: "topolo_api_call",
+    title: "Call any Topolo platform service",
+    description: `Low-level passthrough to any Topolo service. Use when no domain-specific tool exists for the operation you need. The request is signed with the current credential and scoped to the caller's organization \u2014 the target service will return 403 if your scopes do not permit the operation, even though this tool is advertised. Mutating calls (non-GET methods) require confirm:true. Known services: ${SERVICE_IDS.join(", ")}.`,
+    requiredScopes: [],
+    destructive: true,
+    inputSchema: {
+      type: "object",
+      properties: {
+        service: {
+          type: "string",
+          enum: SERVICE_IDS,
+          description: "Target service ID from the platform registry."
+        },
+        method: {
+          type: "string",
+          enum: HTTP_METHODS,
+          default: "GET",
+          description: "HTTP method. Defaults to GET."
+        },
+        path: {
+          type: "string",
+          minLength: 1,
+          description: 'Request path including any leading slash, e.g. "/api/contacts".'
+        },
+        body: {
+          description: "JSON request body. Ignored for GET."
+        },
+        query: {
+          type: "object",
+          additionalProperties: { type: "string" },
+          description: "Query string parameters as string values."
+        },
+        confirm: {
+          type: "boolean",
+          description: "Required for non-GET methods. Explicit human-in-the-loop acknowledgement for writes."
+        }
+      },
+      required: ["service", "path"],
+      additionalProperties: false
+    },
+    handler: async (topolo, args) => {
+      const service = args["service"];
+      const path = args["path"];
+      if (typeof service !== "string" || !SERVICE_IDS.includes(service)) {
+        throw new Error(`Unknown service "${String(service)}". Known: ${SERVICE_IDS.join(", ")}`);
+      }
+      if (typeof path !== "string" || !path) {
+        throw new Error("path is required");
+      }
+      const methodRaw = args["method"] ?? "GET";
+      if (typeof methodRaw !== "string" || !HTTP_METHODS.includes(methodRaw)) {
+        throw new Error(`Unknown HTTP method "${String(methodRaw)}"`);
+      }
+      const method = methodRaw;
+      const query = args["query"];
+      const normalisedQuery = query && typeof query === "object" && !Array.isArray(query) ? Object.fromEntries(
+        Object.entries(query).map(([k, v]) => [k, String(v)])
+      ) : void 0;
+      return topolo.client.request({
+        service,
+        method,
+        path,
+        body: args["body"],
+        ...normalisedQuery ? { query: normalisedQuery } : {},
+        confirm: Boolean(args["confirm"])
+      });
+    }
+  },
   {
     name: "topolo_crm_get_contact",
     title: "Fetch a single CRM contact",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topolo/mcp",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "description": "Model Context Protocol server for the Topolo platform. Exposes scope-gated tools that third-party agents (Claude, Codex, etc.) can call natively.",
   "type": "module",
   "bin": {