@sutraspaces/mcp-server 1.0.0 → 1.1.1

package/README.md

@@ -1,17 +1,17 @@
 # Sutra MCP Server
 
-An [MCP](https://modelcontextprotocol.io) server that connects AI agents to the [Sutra Admin API](https://sutra.co). Manage spaces, members, content, discussions, surveys, plans, broadcasts, and more — all through your AI tools.
+An [MCP](https://modelcontextprotocol.io) server that connects AI agents to the [Sutra Admin API](https://sutra.co). Manage spaces, members, contacts, content, discussions, surveys, plans, broadcasts, and more — all through your AI tools.
 
 ## Quick Start
 
 ```bash
-npm install
+npm install -g @sutraspaces/mcp-server
 ```
 
-Set your Sutra API token:
+Or run directly with npx:
 
 ```bash
-export SUTRA_API_TOKEN="sutra_live_sk_..."
+SUTRA_API_TOKEN="sutra_live_sk_..." npx -y @sutraspaces/mcp-server
 ```
 
 You can get an API token from your Sutra account settings or by contacting support@sutra.co.
@@ -26,8 +26,8 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 {
   "mcpServers": {
     "sutra": {
-      "command": "node",
-      "args": ["/path/to/sutra-mcp/src/index.js"],
+      "command": "npx",
+      "args": ["-y", "@sutraspaces/mcp-server"],
       "env": {
         "SUTRA_API_TOKEN": "sutra_live_sk_..."
       }
@@ -39,12 +39,12 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 ### Claude Code
 
 ```bash
-claude mcp add sutra -- env SUTRA_API_TOKEN=sutra_live_sk_... node /path/to/sutra-mcp/src/index.js
+claude mcp add sutra -- env SUTRA_API_TOKEN=sutra_live_sk_... npx -y @sutraspaces/mcp-server
 ```
 
 ### Cursor / Windsurf / Other MCP Clients
 
-Point your MCP client at the server entry point with the `SUTRA_API_TOKEN` environment variable set. The server communicates over stdio.
+Point your MCP client at `npx -y @sutraspaces/mcp-server` with the `SUTRA_API_TOKEN` environment variable set. The server communicates over stdio.
 
 ## Configuration
 
@@ -60,6 +60,7 @@ Point your MCP client at the server entry point with the `SUTRA_API_TOKEN` envir
 
 ### Spaces
 - **list_spaces** — List all spaces the API token can access
+- **list_membership_spaces** — List basic read-only information about spaces where the API token owner is a member
 - **get_space** — Get details for a single space
 - **list_child_spaces** — List direct child spaces
 - **create_space** — Create a new space (top-level or child)
@@ -68,7 +69,7 @@ Point your MCP client at the server entry point with the `SUTRA_API_TOKEN` envir
 - **reorder_child_spaces** — Reorder children within a parent
 
 ### Members
-- **list_members** — List space members with optional email/user_id filtering
+- **list_members** — List space members with optional email, user_id, search, role, state, and custom property filtering
 - **get_member** — Get member details
 - **add_member** — Add a member by email or user ID
 - **update_member** — Update role or notification settings
@@ -77,6 +78,13 @@ Point your MCP client at the server entry point with the `SUTRA_API_TOKEN` envir
 - **bulk_add_members** — Add up to 100 members at once
 - **bulk_remove_members** — Remove up to 100 members at once
 
+### Contacts
+- **list_contacts** — List CRM contacts from the Contacts/Interested layer with optional email, search, and custom property filtering
+- **get_contact** — Get contact details
+- **get_contact_property_values** — Read property values for a contact
+- **update_contact_property_values** — Set or clear property values for a contact
+- **bulk_update_contact_property_values** — Set or clear property values for up to 100 contacts at once
+
 ### Content & Discussions
 - **list_content** / **get_content_block** / **create_content** / **update_content** / **delete_content** — Manage content blocks
 - **reorder_content** — Reorder content blocks within a space
@@ -85,7 +93,8 @@ Point your MCP client at the server entry point with the `SUTRA_API_TOKEN` envir
 
 ### Properties
 - **list_member_properties** / **create_member_property** / **update_member_property** / **delete_member_property** — Manage custom member property definitions
-- **get_member_property_values** / **update_member_property_values** — Read and set property values per member
+- **get_member_property_values** / **update_member_property_values** / **bulk_update_member_property_values** — Read, set, and bulk set property values for members
+- **get_contact_property_values** / **update_contact_property_values** / **bulk_update_contact_property_values** — Read, set, and bulk set property values for contacts
 - **list_space_properties** / **create_space_property** / **update_space_property** / **delete_space_property** — Manage custom space property definitions
 - **get_space_property_values** / **update_space_property_values** — Read and set property values per space
 
@@ -111,19 +120,40 @@ Point your MCP client at the server entry point with the `SUTRA_API_TOKEN` envir
 - **send_broadcast** — Send a broadcast to space members
 - **get_broadcast_delivery_status** — Check delivery progress
 
+## Available Resources
+
+- **sutra://admin-api/overview** — Core Admin API concepts, public ID prefixes, scopes, pagination, and filtering
+- **sutra://admin-api/membership-spaces** — Difference between admin-manageable spaces and limited membership-space inventory
+- **sutra://admin-api/contacts-properties** — Contact listing and member/contact property value workflows
+- **sutra://admin-api/people-filtering** — Member and contact search, email, state, role, and custom property filtering
+
 ## API Concepts
 
 **Spaces** are the core building block — they can be courses, communities, forums, or any structured container. Spaces form hierarchies through parent-child relationships.
 
+**Membership spaces** are spaces where the API token owner is enrolled as a member. Use `list_membership_spaces` for basic read-only inventory. Use `list_spaces` for spaces where the token has admin access; membership-only spaces may still return 404 or 403 from admin subresource tools.
+
 **Members** belong to spaces. They have roles (member, editor, moderator) and can have custom properties attached.
 
+**Contacts** are CRM people in a space who are not enrolled members. Contacts use the same member property definitions as members, so AI agents can tag imported contacts before they join.
+
 **Content blocks** are structured content created by facilitators. **Messages** are discussion posts from participants. **Reflections** are threaded replies to messages.
 
-**All IDs** use readable prefixes: `sp_` (space), `mem_` (member), `usr_` (user), `blk_` (block/message), `reply_` (reflection), `surv_` (survey), `plan_` (plan), `enr_` (enrollment), `pay_` (payment), `cpn_` (coupon), `bcst_` (broadcast), `inv_` (invitation), `mprop_` / `sprop_` (property definitions).
+**All IDs** use readable prefixes: `sp_` (space), `mem_` (member), `contact_` (contact), `usr_` (user), `blk_` (block/message), `reply_` (reflection), `surv_` (survey), `plan_` (plan), `enr_` (enrollment), `pay_` (payment), `cpn_` (coupon), `bcst_` (broadcast), `inv_` (invitation), `mprop_` / `sprop_` (property definitions).
 
 **Pagination** is cursor-based. List endpoints return `{ data, pagination: { next_cursor, has_more } }`. Pass `cursor` to get the next page.
 
-**Scopes** control what the API token can access. Tokens have read/write scope pairs like `spaces:read`, `members:write`, etc. Operations that exceed the token's scopes will return 403.
+**Filtering & Search** — most list endpoints accept optional query parameters to narrow results:
+- `q` — case-insensitive text search (spaces by name, members/contacts by name/email when scoped, surveys/broadcasts/plans by title/name, coupons by code)
+- `state` / `status` — exact-match enum filters (e.g. `state=active` for spaces, `status=sent` for broadcasts)
+- `role` — filter members or invitations by role
+- `type` / `privacy` / `frequency` — filter by type, privacy level, or billing frequency
+- `user_id` — filter messages or payments by author/user
+- `email` — filter members, contacts, or invitations by email (requires `members.email:read` scope)
+- `property_key` / `property_value` — filter members or contacts by one custom member property (requires `member_properties:read` scope)
+- `property_filters` — filter members or contacts by multiple custom member properties
+
+**Scopes** control what the API token can access. Tokens have read/write scope pairs like `spaces:read`, `members:write`, etc. `membership_spaces:read` is required for read-only membership-space inventory. Operations that exceed the token's scopes will return 403.
 
 ## Architecture
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sutraspaces/mcp-server",
-  "version": "1.0.0",
-  "description": "MCP server for the Sutra Admin API — manage spaces, members, content, and more via AI agents",
+  "version": "1.1.1",
+  "description": "MCP server for the Sutra Admin API — manage spaces, members, contacts, content, and more via AI agents",
   "type": "module",
   "main": "src/index.js",
   "bin": {

package/src/index.js

@@ -14,6 +14,9 @@ import { registerPlanTools } from "./tools/plans.js";
 import { registerCouponTools } from "./tools/coupons.js";
 import { registerBroadcastTools } from "./tools/broadcasts.js";
 import { registerDeepTool } from "./tools/deep.js";
+import { registerAutomationTools } from "./tools/automations.js";
+import { registerHelpCenterTools } from "./tools/help-center.js";
+import { registerAdminApiResources } from "./resources/admin-api.js";
 
 const SUTRA_API_TOKEN = process.env.SUTRA_API_TOKEN;
 const SUTRA_BASE_URL = process.env.SUTRA_BASE_URL;
@@ -29,9 +32,9 @@ if (!SUTRA_API_TOKEN) {
 
 const server = new McpServer({
   name: "sutra",
-  version: "1.0.0",
+  version: "1.1.0",
   description:
-    "Sutra Admin API — manage spaces, members, content, discussions, surveys, plans, broadcasts, and more.",
+    "Sutra Admin API — manage spaces, members, contacts, content, discussions, surveys, plans, broadcasts, and more.",
 });
 
 const client = new SutraAdminClient(SUTRA_API_TOKEN, SUTRA_BASE_URL);
@@ -46,6 +49,9 @@ registerPlanTools(server, client);
 registerCouponTools(server, client);
 registerBroadcastTools(server, client);
 registerDeepTool(server, client);
+registerAutomationTools(server, client);
+registerHelpCenterTools(server);
+registerAdminApiResources(server);
 
 async function main() {
   const transport = new StdioServerTransport();

package/src/resources/admin-api.js

@@ -0,0 +1,136 @@
+const RESOURCES = [
+  {
+    name: "sutra-admin-api-overview",
+    title: "Sutra Admin API Overview",
+    uri: "sutra://admin-api/overview",
+    description: "Core Sutra Admin API concepts, IDs, scopes, pagination, and filtering.",
+    text: `# Sutra Admin API Overview
+
+The Sutra Admin API lets authorized tokens manage spaces, members, contacts, content, invitations, properties, surveys, plans, coupons, and broadcasts.
+
+Important IDs:
+- Spaces use sp_ IDs.
+- Members use mem_ IDs.
+- Contacts use contact_ IDs.
+- Users use usr_ IDs.
+- Member property definitions use mprop_ IDs.
+- Space property definitions use sprop_ IDs.
+
+Pagination:
+- List tools return data and pagination.
+- Pass cursor to fetch the next page.
+- Limit defaults to 25 unless the tool says otherwise.
+
+Scopes:
+- members:read reads members and contacts.
+- members:write writes member/contact-related values where supported.
+- spaces:read lists spaces where the token owner has admin access.
+- membership_spaces:read lists basic read-only inventory for spaces where the token owner is a member.
+- members.email:read is required to see or filter by email.
+- member_properties:read is required to list definitions, read values, and filter people by properties.
+- member_properties:write is required to create/update definitions or set values.
+`,
+  },
+  {
+    name: "sutra-contacts-properties",
+    title: "Contacts and Member Properties",
+    uri: "sutra://admin-api/contacts-properties",
+    description: "How to list contacts and set custom property values for members or contacts.",
+    text: `# Contacts and Member Properties
+
+Contacts are CRM people in a space who are not enrolled members. They appear in Sutra's Contacts/Interested layer and use the same member property definitions as members.
+
+Useful tools:
+- list_contacts: list contacts in a space.
+- get_contact: get one contact by contact_ ID.
+- get_contact_property_values: read values for one contact.
+- update_contact_property_values: set or clear values for one contact.
+- bulk_update_contact_property_values: set or clear values for up to 100 contacts in one idempotent request.
+- bulk_update_member_property_values: set or clear values for up to 100 members in one idempotent request.
+
+Property value payloads are objects keyed by property key or mprop_ ID. Use null to clear a value.
+
+Example contact bulk update item:
+{
+  "contact_id": "contact_abc123",
+  "properties": {
+    "mailing_list_opt_in": "Not yet subscribed",
+    "in_person_workshop": "Sweden"
+  }
+}
+
+Use an idempotency_key for bulk updates so retries are safe.
+`,
+  },
+  {
+    name: "sutra-people-filtering",
+    title: "Member and Contact Filtering",
+    uri: "sutra://admin-api/people-filtering",
+    description: "Filtering members and contacts by search, email, state, role, and custom property values.",
+    text: `# Member and Contact Filtering
+
+list_members supports:
+- email: exact email filter, requires members.email:read.
+- q: case-insensitive name/email search.
+- user_id: exact usr_ filter.
+- role: member, editor, or moderator.
+- state: active or pending.
+- property_key and property_value: filter by one custom property.
+- property_filters: filter by multiple custom properties.
+
+list_contacts supports:
+- email: exact email filter, requires members.email:read.
+- q: case-insensitive name/email search.
+- property_key and property_value: filter by one custom property.
+- property_filters: filter by multiple custom properties.
+
+Property filtering requires member_properties:read. property_key can be a property key or an mprop_ ID. Select and multi_select filters may use option names or stored option values.
+
+Example multiple filters:
+[
+  { "property_key": "mailing_list_opt_in", "property_value": "Not yet subscribed" },
+  { "property_key": "in_person_workshop", "property_value": "Sweden" }
+]
+`,
+  },
+  {
+    name: "sutra-membership-spaces",
+    title: "Membership Spaces",
+    uri: "sutra://admin-api/membership-spaces",
+    description: "Difference between admin-manageable spaces and limited membership-space inventory.",
+    text: `# Membership Spaces
+
+Use list_spaces when you need spaces where the API token can perform admin operations.
+
+Use list_membership_spaces when you only need a basic inventory of spaces where the token owner is a member. It returns IDs, names, type, state, privacy, timestamps, membership state, membership role, joined_at, and admin_access.
+
+Membership-space results are read-only. A space with admin_access: false is included for inventory, but admin subresource tools such as list_members, list_content, list_child_spaces, or get_space can still return 404 or 403 for that space.
+
+Required scope:
+- membership_spaces:read
+`,
+  },
+];
+
+export function registerAdminApiResources(server) {
+  for (const resource of RESOURCES) {
+    server.registerResource(
+      resource.name,
+      resource.uri,
+      {
+        title: resource.title,
+        description: resource.description,
+        mimeType: "text/markdown",
+      },
+      async () => ({
+        contents: [
+          {
+            uri: resource.uri,
+            mimeType: "text/markdown",
+            text: resource.text,
+          },
+        ],
+      })
+    );
+  }
+}

package/src/tools/automations.js

@@ -0,0 +1,89 @@
+import { z } from "zod";
+
+export function registerAutomationTools(server, client) {
+  server.tool(
+    "list_automations",
+    "List automations configured on a space. Returns automation IDs (auto_...), trigger type, step summary, and member counts.",
+    {
+      space_id: z.string().describe("Space ID (sp_...)"),
+      limit: z.number().optional().describe("Max results (default 25)"),
+      cursor: z.string().optional().describe("Pagination cursor"),
+    },
+    async ({ space_id, limit, cursor }) => {
+      const data = await client.get(`/spaces/${space_id}/automations`, { limit, cursor });
+      return json(data);
+    }
+  );
+
+  server.tool(
+    "get_automation",
+    "Get details for a specific automation, including its steps.",
+    {
+      automation_id: z.string().describe("Automation ID (auto_...)"),
+    },
+    async ({ automation_id }) => {
+      const data = await client.get(`/automations/${automation_id}`);
+      return json(data);
+    }
+  );
+
+  server.tool(
+    "list_automation_members",
+    "List members enrolled in an automation. Filter by status (ongoing or completed).",
+    {
+      automation_id: z.string().describe("Automation ID (auto_...)"),
+      status: z.enum(["ongoing", "completed"]).optional().describe("Filter by enrollment status"),
+      limit: z.number().optional().describe("Max results (default 25)"),
+      cursor: z.string().optional().describe("Pagination cursor"),
+    },
+    async ({ automation_id, status, limit, cursor }) => {
+      const data = await client.get(`/automations/${automation_id}/members`, { status, limit, cursor });
+      return json(data);
+    }
+  );
+
+  server.tool(
+    "get_automation_member",
+    "Get a specific member's enrollment status in an automation.",
+    {
+      automation_id: z.string().describe("Automation ID (auto_...)"),
+      enrollment_id: z.string().describe("Automation enrollment ID (aenr_...)"),
+    },
+    async ({ automation_id, enrollment_id }) => {
+      const data = await client.get(`/automations/${automation_id}/members/${enrollment_id}`);
+      return json(data);
+    }
+  );
+
+  server.tool(
+    "add_automation_member",
+    "Enroll a member in an automation. This triggers the automation flow for that member. Identify the member by member_id, user_id, or email.",
+    {
+      automation_id: z.string().describe("Automation ID (auto_...)"),
+      member_id: z.string().optional().describe("Member ID (mem_...) — member must belong to the automation's space"),
+      user_id: z.string().optional().describe("User ID (usr_...) — alternative to member_id"),
+      email: z.string().optional().describe("User email — alternative to member_id or user_id"),
+    },
+    async ({ automation_id, ...body }) => {
+      const data = await client.post(`/automations/${automation_id}/members`, body);
+      return json(data);
+    }
+  );
+
+  server.tool(
+    "remove_automation_member",
+    "Remove a member from an automation, stopping the automation flow for them.",
+    {
+      automation_id: z.string().describe("Automation ID (auto_...)"),
+      enrollment_id: z.string().describe("Automation enrollment ID (aenr_...)"),
+    },
+    async ({ automation_id, enrollment_id }) => {
+      const data = await client.delete(`/automations/${automation_id}/members/${enrollment_id}`);
+      return json(data);
+    }
+  );
+}
+
+function json(data) {
+  return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}

package/src/tools/broadcasts.js

@@ -3,14 +3,16 @@ import { z } from "zod";
 export function registerBroadcastTools(server, client) {
   server.tool(
     "list_broadcasts",
-    "List broadcasts for a space. Broadcasts are mass communications sent to space members.",
+    "List broadcasts for a space. Broadcasts are mass communications sent to space members. Use `q` to search by title.",
     {
       space_id: z.string().describe("Space ID (sp_...)"),
       limit: z.number().optional().describe("Max results (default 25)"),
       cursor: z.string().optional().describe("Pagination cursor"),
+      q: z.string().optional().describe("Search broadcasts by title (case-insensitive)"),
+      status: z.enum(["draft", "scheduled", "sent"]).optional().describe("Filter by status"),
     },
-    async ({ space_id, limit, cursor }) => {
-      const data = await client.get(`/spaces/${space_id}/broadcasts`, { limit, cursor });
+    async ({ space_id, limit, cursor, q, status }) => {
+      const data = await client.get(`/spaces/${space_id}/broadcasts`, { limit, cursor, q, status });
       return json(data);
     }
   );

package/src/tools/content.js

@@ -89,14 +89,15 @@ export function registerContentTools(server, client) {
 
   server.tool(
     "list_messages",
-    "List discussion messages in a space. Messages are top-level discussion posts that members create.",
+    "List discussion messages in a space. Messages are top-level discussion posts that members create. Filter by author with user_id.",
     {
       space_id: z.string().describe("Space ID (sp_...)"),
       limit: z.number().optional().describe("Max results (default 25)"),
       cursor: z.string().optional().describe("Pagination cursor"),
+      user_id: z.string().optional().describe("Filter by author user ID (usr_...)"),
     },
-    async ({ space_id, limit, cursor }) => {
-      const data = await client.get(`/spaces/${space_id}/messages`, { limit, cursor });
+    async ({ space_id, limit, cursor, user_id }) => {
+      const data = await client.get(`/spaces/${space_id}/messages`, { limit, cursor, user_id });
       return json(data);
     }
   );

package/src/tools/coupons.js

@@ -3,14 +3,16 @@ import { z } from "zod";
 export function registerCouponTools(server, client) {
   server.tool(
     "list_coupons",
-    "List coupons for a space.",
+    "List coupons for a space. Use `q` to search by coupon code.",
     {
       space_id: z.string().describe("Space ID (sp_...)"),
       limit: z.number().optional().describe("Max results (default 25)"),
       cursor: z.string().optional().describe("Pagination cursor"),
+      q: z.string().optional().describe("Search coupons by code (case-insensitive)"),
+      status: z.string().optional().describe("Filter by coupon status"),
     },
-    async ({ space_id, limit, cursor }) => {
-      const data = await client.get(`/spaces/${space_id}/coupons`, { limit, cursor });
+    async ({ space_id, limit, cursor, q, status }) => {
+      const data = await client.get(`/spaces/${space_id}/coupons`, { limit, cursor, q, status });
       return json(data);
     }
   );

package/src/tools/help-center.js

@@ -0,0 +1,425 @@
+import { z } from "zod";
+
+const HELP_BASE_URL = process.env.SUTRA_HELP_CENTER_BASE_URL || "https://api.sutra.co/api/v4/lotus/help";
+
+async function getImageDimensions(url) {
+  try {
+    const res = await fetch(url, { signal: AbortSignal.timeout(5000) });
+    if (!res.ok) return null;
+    const buf = Buffer.from(await res.arrayBuffer());
+    if (buf[0] === 0x89 && buf[1] === 0x50) {
+      // PNG: width at bytes 16-19, height at 20-23
+      return { width: buf.readUInt32BE(16), height: buf.readUInt32BE(20) };
+    }
+    if (buf[0] === 0xFF && buf[1] === 0xD8) {
+      // JPEG: scan for SOF markers
+      let offset = 2;
+      while (offset < buf.length - 8) {
+        if (buf[offset] !== 0xFF) break;
+        const marker = buf[offset + 1];
+        const len = buf.readUInt16BE(offset + 2);
+        if (marker >= 0xC0 && marker <= 0xCF && marker !== 0xC4 && marker !== 0xC8) {
+          return { width: buf.readUInt16BE(offset + 7), height: buf.readUInt16BE(offset + 5) };
+        }
+        offset += 2 + len;
+      }
+    }
+    if (buf.slice(0, 4).toString() === "GIF8") {
+      return { width: buf.readUInt16LE(6), height: buf.readUInt16LE(8) };
+    }
+    if (buf.slice(0, 4).toString() === "RIFF" && buf.slice(8, 12).toString() === "WEBP") {
+      if (buf.slice(12, 16).toString() === "VP8 ") {
+        return { width: buf.readUInt16LE(26) & 0x3FFF, height: buf.readUInt16LE(28) & 0x3FFF };
+      }
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+function imageWidthForDimensions(dims) {
+  if (!dims) return "100%";
+  return dims.width >= dims.height ? "100%" : "60%";
+}
+
+async function normalizeGleapContent(doc) {
+  if (!doc || typeof doc !== "object") return doc;
+  const nodes = doc.content;
+  if (!Array.isArray(nodes)) return doc;
+  const normalized = nodes.flatMap(normalizeNode);
+  await resolveImageWidths(normalized);
+  return { ...doc, content: normalized };
+}
+
+async function resolveImageWidths(nodes) {
+  const imageNodes = [];
+  function collect(list) {
+    for (const node of list) {
+      if (node.type === "image" && node.attrs?.src && node.attrs?._needsResize) {
+        imageNodes.push(node);
+      }
+      if (node.content && Array.isArray(node.content)) collect(node.content);
+    }
+  }
+  collect(nodes);
+  await Promise.all(imageNodes.map(async (node) => {
+    const dims = await getImageDimensions(node.attrs.src);
+    const w = imageWidthForDimensions(dims);
+    node.attrs.resizeableWidth = w;
+    delete node.attrs._needsResize;
+    delete node.attrs.style;
+  }));
+}
+
+function normalizeNode(node) {
+  if (!node || typeof node !== "object") return [node];
+
+  if (node.type === "callout") {
+    const children = Array.isArray(node.content) ? node.content : [];
+    const textNodes = [];
+    const blockNodes = [];
+    for (const child of children) {
+      if (child.type === "text") textNodes.push(child);
+      else if (child.type === "paragraph") blockNodes.push(child);
+      else blockNodes.push(child);
+    }
+    const paragraphs = [];
+    if (textNodes.length) paragraphs.push({ type: "paragraph", attrs: { textAlign: "left" }, content: textNodes });
+    paragraphs.push(...blockNodes);
+    return [{
+      type: "infobox",
+      attrs: {
+        customSpacing: true,
+        icon: "info",
+        iconColor: "#364fc7",
+        badgeBgColor: "rgba(255,255,255,0.6)",
+        iconPosition: "left",
+        iconVerticalAlign: "top",
+        badgeShape: "circle",
+        badgeSize: 40,
+        iconSize: 20,
+        iconOffset: 18,
+        iconVerticalOffset: 18,
+        contentOffset: 70,
+        contentVerticalOffset: 20,
+        styles: {
+          "margin-top": "0px",
+          "margin-bottom": "0px",
+          "margin-left": "0px",
+          "margin-right": "0px",
+          "padding-top": "15px",
+          "padding-bottom": "10px",
+          "padding-left": "0px",
+          "padding-right": "0px",
+        },
+      },
+      content: [{
+        type: "column",
+        attrs: {
+          size: 12,
+          position: 0,
+          radius: "with-radius",
+          styles: {
+            "align-items": "flex-start",
+            "background-color": "#dbe4ff",
+            "background-image": "none",
+            "background-position": "center center",
+            "background-size": "cover",
+            "background-repeat": "no-repeat",
+            "margin-top": "0px",
+            "margin-bottom": "0px",
+            "margin-left": "0px",
+            "margin-right": "0px",
+            "padding-top": "20px",
+            "padding-bottom": "20px",
+            "padding-left": "70px",
+            "padding-right": "20px",
+          },
+          flexLayout: "stack",
+          flexGap: 0,
+          nestedRadius: "no-radius",
+        },
+        content: paragraphs.length ? paragraphs : [{ type: "paragraph", attrs: { textAlign: "left" } }],
+      }],
+    }];
+  }
+
+  if (node.type === "editor-button") {
+    const label = node.content?.[0]?.text || "Button";
+    const href = node.attrs?.href || "#";
+    return [{
+      type: "paragraph",
+      attrs: { textAlign: "left" },
+      content: [{
+        type: "text",
+        marks: [{ type: "link", attrs: { href, target: "_blank", rel: "noopener noreferrer nofollow" } }, { type: "bold" }],
+        text: `👉 ${label}`,
+      }],
+    }];
+  }
+
+  if (node.type === "imageBlock") {
+    return [{
+      type: "image",
+      attrs: {
+        src: node.attrs?.src,
+        alt: node.attrs?.alt || null,
+        textAlign: "center",
+        _needsResize: true,
+      },
+    }];
+  }
+
+  if (node.type === "image" && node.attrs?.src) {
+    return [{
+      ...node,
+      attrs: { ...node.attrs, _needsResize: true },
+    }];
+  }
+
+  if (node.type === "heading") {
+    const level = node.attrs?.level || 1;
+    const paddingTop = { 1: "32px", 2: "20px", 3: "16px", 4: "12px", 5: "10px", 6: "8px" };
+    const styles = {
+      "margin-top": "0px", "margin-bottom": "0px", "margin-left": "0px", "margin-right": "0px",
+      "padding-top": paddingTop[level] || "20px", "padding-bottom": "0px",
+      "padding-left": "0px", "padding-right": "0px",
+      "font-size": "", "line-height": "", "font-family": "",
+      ...(node.attrs?.styles || {}),
+    };
+    if (!node.attrs?.styles?.["padding-top"]) styles["padding-top"] = paddingTop[level] || "20px";
+    return [{ ...node, attrs: { ...node.attrs, styles } }];
+  }
+
+  if (node.content && Array.isArray(node.content)) {
+    return [{ ...node, content: node.content.flatMap(normalizeNode) }];
+  }
+
+  return [node];
+}
+
+export function registerHelpCenterTools(server) {
+  const token = process.env.SUTRA_HELP_CENTER_TOKEN;
+  if (!token) return;
+
+  async function request(method, path, { params, body } = {}) {
+    const url = new URL(`${HELP_BASE_URL}${path}`);
+    if (params) {
+      for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined && v !== null) url.searchParams.set(k, String(v));
+      }
+    }
+    const headers = {
+      Authorization: `Bearer ${token}`,
+      Accept: "application/json",
+      ...(body ? { "Content-Type": "application/json" } : {}),
+    };
+    const res = await fetch(url.toString(), {
+      method,
+      headers,
+      body: body ? JSON.stringify(body) : undefined,
+    });
+    const text = await res.text();
+    if (!res.ok) throw new Error(`${method} ${path} → ${res.status}: ${text}`);
+    return text ? JSON.parse(text) : {};
+  }
+
+  // --- Articles ---
+
+  server.tool(
+    "help_list_articles",
+    "List Help Center articles with optional filters. Returns article summaries and stats.",
+    {
+      status: z.enum(["draft", "published", "archived"]).optional().describe("Filter by status"),
+      review_status: z.string().optional().describe("Filter by review status"),
+      collection_id: z.number().optional().describe("Filter by collection ID"),
+      product_area: z.string().optional().describe("Filter by product area"),
+      intent_type: z.string().optional().describe("Filter by intent type"),
+      q: z.string().optional().describe("Search title and excerpt"),
+    },
+    async (params) => {
+      const data = await request("GET", "/articles.json", { params });
+      return json(data);
+    }
+  );
+
+  server.tool(
+    "help_get_article",
+    "Get a Help Center article with full content, metadata, and version history.",
+    {
+      id: z.number().describe("Article ID"),
+    },
+    async ({ id }) => {
+      const data = await request("GET", `/articles/${id}.json`);
+      return json(data);
+    }
+  );
+
+  server.tool(
+    "help_create_article",
+    "Create a new Help Center article. Returns the article and its first version.",
+    {
+      title: z.string().describe("Article title"),
+      slug: z.string().optional().describe("URL slug (auto-generated from title if omitted)"),
+      excerpt: z.string().optional().describe("Short description/excerpt"),
+      help_collection_id: z.number().optional().describe("Collection ID to place article in"),
+      product_area: z.string().optional().describe("Product area tag"),
+      intent_type: z.string().optional().describe("Intent type tag"),
+      subsection: z.string().optional().describe("Subsection within collection"),
+      position: z.number().optional().describe("Sort position within collection"),
+      status: z.enum(["draft", "published", "archived"]).optional().describe("Initial status (default: draft)"),
+      content: z.any().optional().describe("Tiptap JSON content"),
+      commit_message: z.string().optional().describe("Version commit message"),
+      meta_title: z.string().optional().describe("SEO meta title"),
+      meta_description: z.string().optional().describe("SEO meta description"),
+      og_image_url: z.string().optional().describe("Open Graph image URL"),
+      audience: z.array(z.string()).optional().describe("Target audience tags"),
+      applies_to_plan: z.array(z.string()).optional().describe("Applicable plan types"),
+      alternate_phrasings: z.array(z.string()).optional().describe("Alternate search phrasings"),
+      publish: z.boolean().optional().describe("Publish immediately after creation"),
+    },
+    async (params) => {
+      const { publish, ...articleFields } = params;
+      if (articleFields.content) articleFields.content = await normalizeGleapContent(articleFields.content);
+      const data = await request("POST", "/articles.json", {
+        body: { article: articleFields, publish },
+      });
+      return json(data);
+    }
+  );
+
+  server.tool(
+    "help_update_article",
+    "Update an existing Help Center article and create a new version.",
+    {
+      id: z.number().describe("Article ID"),
+      title: z.string().optional().describe("Article title"),
+      slug: z.string().optional().describe("URL slug"),
+      excerpt: z.string().optional().describe("Short description/excerpt"),
+      help_collection_id: z.number().optional().describe("Collection ID"),
+      product_area: z.string().optional().describe("Product area tag"),
+      intent_type: z.string().optional().describe("Intent type tag"),
+      subsection: z.string().optional().describe("Subsection within collection"),
+      position: z.number().optional().describe("Sort position"),
+      status: z.string().optional().describe("Status (draft/published/archived)"),
+      content: z.any().optional().describe("Tiptap JSON content"),
+      commit_message: z.string().optional().describe("Version commit message"),
+      meta_title: z.string().optional().describe("SEO meta title"),
+      meta_description: z.string().optional().describe("SEO meta description"),
+      og_image_url: z.string().optional().describe("Open Graph image URL"),
+      audience: z.array(z.string()).optional().describe("Target audience tags"),
+      applies_to_plan: z.array(z.string()).optional().describe("Applicable plan types"),
+      alternate_phrasings: z.array(z.string()).optional().describe("Alternate search phrasings"),
+      publish: z.boolean().optional().describe("Publish this version immediately"),
+    },
+    async ({ id, publish, ...articleFields }) => {
+      if (articleFields.content) articleFields.content = await normalizeGleapContent(articleFields.content);
+      const data = await request("PUT", `/articles/${id}.json`, {
+        body: { article: articleFields, publish },
+      });
+      return json(data);
+    }
+  );
+
+  server.tool(
+    "help_publish_article",
+    "Publish a Help Center article version. Publishes the latest version if no version_id is given.",
+    {
+      id: z.number().describe("Article ID"),
+      version_id: z.number().optional().describe("Specific version ID to publish (defaults to latest)"),
+    },
+    async ({ id, version_id }) => {
+      const data = await request("POST", `/articles/${id}/publish.json`, {
+        body: version_id ? { version_id } : {},
+      });
+      return json(data);
+    }
+  );
+
+  server.tool(
+    "help_review_article",
+    "Approve or reject a pending Help Center article version.",
+    {
+      id: z.number().describe("Article ID"),
+      version_id: z.number().describe("Version ID to review"),
+      decision: z.enum(["approve", "reject"]).describe("Review decision"),
+      comment: z.string().optional().describe("Review comment"),
+    },
+    async ({ id, ...body }) => {
+      const data = await request("POST", `/articles/${id}/review.json`, { body });
+      return json(data);
+    }
+  );
+
+  // --- Collections ---
+
+  server.tool(
+    "help_list_collections",
+    "List all Help Center collections (categories).",
+    {},
+    async () => {
+      const data = await request("GET", "/collections.json");
+      return json(data);
+    }
+  );
+
+  server.tool(
+    "help_create_collection",
+    "Create a new Help Center collection.",
+    {
+      name: z.string().describe("Collection name"),
+      slug: z.string().optional().describe("URL slug"),
+      description: z.string().optional().describe("Collection description"),
+      icon_library: z.string().optional().describe("Icon library name"),
+      icon_name: z.string().optional().describe("Icon name"),
+      icon_color: z.string().optional().describe("Icon color hex"),
+      position: z.number().optional().describe("Sort position"),
+      published: z.boolean().optional().describe("Whether collection is published"),
+    },
+    async (params) => {
+      const data = await request("POST", "/collections.json", {
+        body: { collection: params },
+      });
+      return json(data);
+    }
+  );
+
+  server.tool(
+    "help_update_collection",
+    "Update a Help Center collection.",
+    {
+      id: z.number().describe("Collection ID"),
+      name: z.string().optional().describe("Collection name"),
+      slug: z.string().optional().describe("URL slug"),
+      description: z.string().optional().describe("Collection description"),
+      icon_library: z.string().optional().describe("Icon library name"),
+      icon_name: z.string().optional().describe("Icon name"),
+      icon_color: z.string().optional().describe("Icon color hex"),
+      position: z.number().optional().describe("Sort position"),
+      published: z.boolean().optional().describe("Whether collection is published"),
+    },
+    async ({ id, ...fields }) => {
+      const data = await request("PUT", `/collections/${id}.json`, {
+        body: { collection: fields },
+      });
+      return json(data);
+    }
+  );
+
+  server.tool(
+    "help_delete_collection",
+    "Delete a Help Center collection. Archives it if it has articles, permanently deletes if empty.",
+    {
+      id: z.number().describe("Collection ID"),
+    },
+    async ({ id }) => {
+      const data = await request("DELETE", `/collections/${id}.json`);
+      return json(data);
+    }
+  );
+}
+
+function json(data) {
+  return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}

package/src/tools/invitations.js

@@ -3,14 +3,17 @@ import { z } from "zod";
 export function registerInvitationTools(server, client) {
   server.tool(
     "list_invitations",
-    "List invitations for a space.",
+    "List invitations for a space. Filter by email, state, or role.",
     {
       space_id: z.string().describe("Space ID (sp_...)"),
       limit: z.number().optional().describe("Max results (default 25)"),
       cursor: z.string().optional().describe("Pagination cursor"),
+      email: z.string().optional().describe("Search by email (case-insensitive, requires members.email:read scope)"),
+      state: z.enum(["pending", "accepted", "declined"]).optional().describe("Filter by invitation state"),
+      role: z.enum(["member", "editor", "moderator"]).optional().describe("Filter by role"),
     },
-    async ({ space_id, limit, cursor }) => {
-      const data = await client.get(`/spaces/${space_id}/invitations`, { limit, cursor });
+    async ({ space_id, limit, cursor, email, state, role }) => {
+      const data = await client.get(`/spaces/${space_id}/invitations`, { limit, cursor, email, state, role });
       return json(data);
     }
   );

package/src/tools/members.js

@@ -1,18 +1,85 @@
 import { z } from "zod";
 
 export function registerMemberTools(server, client) {
+  const propertyValueSchema = z.union([z.string(), z.number(), z.boolean()]).describe("Exact property value");
+  const propertyFilterSchema = z.object({
+    property_key: z.string().optional().describe("Property key or mprop_ ID"),
+    key: z.string().optional().describe("Property key"),
+    property_id: z.string().optional().describe("Property ID (mprop_...)"),
+    member_property_id: z.string().optional().describe("Property ID (mprop_...)"),
+    property_value: propertyValueSchema.optional(),
+    value: propertyValueSchema.optional(),
+  });
+
   server.tool(
     "list_members",
-    "List members of a space. Returns member IDs (mem_...), user info, roles, and states.",
+    "List members of a space. Returns member IDs (mem_...), user info, roles, and states. Use `q` to search by name or email. Use property_key/property_value or property_filters for custom property filtering.",
     {
       space_id: z.string().describe("Space ID (sp_...)"),
       limit: z.number().optional().describe("Max results (default 25)"),
       cursor: z.string().optional().describe("Pagination cursor"),
       user_id: z.string().optional().describe("Filter by user ID (usr_...)"),
       email: z.string().optional().describe("Filter by exact email (requires members.email:read scope)"),
+      q: z.string().optional().describe("Search by member name or email (case-insensitive)"),
+      role: z.enum(["member", "editor", "moderator"]).optional().describe("Filter by role"),
+      state: z.enum(["active", "pending"]).optional().describe("Filter by state"),
+      property_key: z.string().optional().describe("Filter by member property key or mprop_ ID (requires member_properties:read)"),
+      property_value: propertyValueSchema.optional().describe("Exact property value for property_key. Select values may use option names or option values."),
+      property_filters: z.array(propertyFilterSchema).optional().describe("Multiple property filters. Each filter needs a property key/ID and value."),
+    },
+    async ({ space_id, limit, cursor, user_id, email, q, role, state, property_key, property_value, property_filters }) => {
+      const data = await client.get(`/spaces/${space_id}/members`, {
+        limit,
+        cursor,
+        user_id,
+        email,
+        q,
+        role,
+        state,
+        property_key,
+        property_value,
+        property_filters: encodePropertyFilters(property_filters),
+      });
+      return json(data);
+    }
+  );
+
+  server.tool(
+    "list_contacts",
+    "List CRM contacts in a space. Contacts are non-member people in the Contacts/Interested layer. Use property_key/property_value to filter by custom member properties.",
+    {
+      space_id: z.string().describe("Space ID (sp_...)"),
+      limit: z.number().optional().describe("Max results (default 25)"),
+      cursor: z.string().optional().describe("Pagination cursor"),
+      email: z.string().optional().describe("Filter by exact email (requires members.email:read scope)"),
+      q: z.string().optional().describe("Search by contact name, and by email when scoped"),
+      property_key: z.string().optional().describe("Filter by member property key or mprop_ ID (requires member_properties:read)"),
+      property_value: propertyValueSchema.optional().describe("Exact property value for property_key. Select values may use option names or option values."),
+      property_filters: z.array(propertyFilterSchema).optional().describe("Multiple property filters. Each filter needs a property key/ID and value."),
+    },
+    async ({ space_id, limit, cursor, email, q, property_key, property_value, property_filters }) => {
+      const data = await client.get(`/spaces/${space_id}/contacts`, {
+        limit,
+        cursor,
+        email,
+        q,
+        property_key,
+        property_value,
+        property_filters: encodePropertyFilters(property_filters),
+      });
+      return json(data);
+    }
+  );
+
+  server.tool(
+    "get_contact",
+    "Get details for a specific CRM contact in a space.",
+    {
+      space_id: z.string().describe("Space ID (sp_...)"),
+      contact_id: z.string().describe("Contact ID (contact_...)"),
     },
-    async ({ space_id, limit, cursor, user_id, email }) => {
-      const data = await client.get(`/spaces/${space_id}/members`, { limit, cursor, user_id, email });
+    async ({ space_id, contact_id }) => {
+      const data = await client.get(`/spaces/${space_id}/contacts/${contact_id}`);
       return json(data);
     }
   );
@@ -139,6 +206,10 @@ export function registerMemberTools(server, client) {
   );
 }
 
+function encodePropertyFilters(filters) {
+  return filters && filters.length > 0 ? JSON.stringify(filters) : undefined;
+}
+
 function json(data) {
   return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
 }

package/src/tools/plans.js

@@ -5,14 +5,17 @@ export function registerPlanTools(server, client) {
 
   server.tool(
     "list_plans",
-    "List plans (offerings) for a space. Plans describe what can be purchased or enrolled in.",
+    "List plans (offerings) for a space. Plans describe what can be purchased or enrolled in. Use `q` to search by name.",
     {
       space_id: z.string().describe("Space ID (sp_...)"),
       limit: z.number().optional().describe("Max results (default 25)"),
       cursor: z.string().optional().describe("Pagination cursor"),
+      q: z.string().optional().describe("Search plans by name (case-insensitive)"),
+      status: z.string().optional().describe("Filter by status"),
+      frequency: z.string().optional().describe("Filter by billing frequency"),
     },
-    async ({ space_id, limit, cursor }) => {
-      const data = await client.get(`/spaces/${space_id}/plans`, { limit, cursor });
+    async ({ space_id, limit, cursor, q, status, frequency }) => {
+      const data = await client.get(`/spaces/${space_id}/plans`, { limit, cursor, q, status, frequency });
       return json(data);
     }
   );
@@ -101,14 +104,16 @@ export function registerPlanTools(server, client) {
 
   server.tool(
     "list_payments",
-    "List payments for a space.",
+    "List payments for a space. Filter by user or status.",
     {
       space_id: z.string().describe("Space ID (sp_...)"),
       limit: z.number().optional().describe("Max results (default 25)"),
       cursor: z.string().optional().describe("Pagination cursor"),
+      user_id: z.string().optional().describe("Filter by user ID (usr_...)"),
+      status: z.string().optional().describe("Filter by payment status"),
     },
-    async ({ space_id, limit, cursor }) => {
-      const data = await client.get(`/spaces/${space_id}/payments`, { limit, cursor });
+    async ({ space_id, limit, cursor, user_id, status }) => {
+      const data = await client.get(`/spaces/${space_id}/payments`, { limit, cursor, user_id, status });
       return json(data);
     }
   );

package/src/tools/properties.js

@@ -89,6 +89,75 @@ export function registerPropertyTools(server, client) {
     }
   );
 
+  server.tool(
+    "bulk_update_member_property_values",
+    "Set property values for up to 100 members. Requires an Idempotency-Key. Use null to clear a value.",
+    {
+      space_id: z.string().describe("Space ID (sp_...)"),
+      idempotency_key: z.string().describe("Unique key for this batch operation"),
+      items: z.array(z.object({
+        member_id: z.string().describe("Member ID (mem_...)"),
+        properties: z.record(z.any()).describe("Object keyed by property key or mprop_ ID, values to set (null to clear)"),
+      })).describe("Array of member property updates (max 100)"),
+    },
+    async ({ space_id, idempotency_key, items }) => {
+      const data = await client.patch(
+        `/spaces/${space_id}/members/properties/bulk`,
+        { items },
+        { "Idempotency-Key": idempotency_key }
+      );
+      return json(data);
+    }
+  );
+
+  server.tool(
+    "get_contact_property_values",
+    "Get all property values for a specific contact in a space. Contacts use the same member property definitions as members.",
+    {
+      space_id: z.string().describe("Space ID (sp_...)"),
+      contact_id: z.string().describe("Contact ID (contact_...)"),
+    },
+    async ({ space_id, contact_id }) => {
+      const data = await client.get(`/spaces/${space_id}/contacts/${contact_id}/properties`);
+      return json(data);
+    }
+  );
+
+  server.tool(
+    "update_contact_property_values",
+    "Set property values for a contact. Use null to clear a value. Keys can be property keys or mprop_ IDs.",
+    {
+      space_id: z.string().describe("Space ID (sp_...)"),
+      contact_id: z.string().describe("Contact ID (contact_...)"),
+      properties: z.record(z.any()).describe("Object keyed by property key or mprop_ ID, values to set (null to clear)"),
+    },
+    async ({ space_id, contact_id, properties }) => {
+      const data = await client.patch(`/spaces/${space_id}/contacts/${contact_id}/properties`, { properties });
+      return json(data);
+    }
+  );
+
+  server.tool(
+    "bulk_update_contact_property_values",
+    "Set property values for up to 100 contacts. Requires an Idempotency-Key. Use null to clear a value.",
+    {
+      space_id: z.string().describe("Space ID (sp_...)"),
+      idempotency_key: z.string().describe("Unique key for this batch operation"),
+      items: z.array(z.object({
+        contact_id: z.string().describe("Contact ID (contact_...)"),
+        properties: z.record(z.any()).describe("Object keyed by property key or mprop_ ID, values to set (null to clear)"),
+      })).describe("Array of contact property updates (max 100)"),
+    },
+    async ({ space_id, idempotency_key, items }) => {
+      const data = await client.patch(
+        `/spaces/${space_id}/contacts/properties/bulk`,
+        { items },
+        { "Idempotency-Key": idempotency_key }
+      );
+      return json(data);
+    }
+  );
+
   // --- Space Properties ---
 
   server.tool(

package/src/tools/spaces.js

@@ -3,13 +3,30 @@ import { z } from "zod";
 export function registerSpaceTools(server, client) {
   server.tool(
     "list_spaces",
-    "List all spaces the API token can access. Returns space IDs (sp_...), names, types, and states. Start here to discover available spaces.",
+    "List all spaces the API token can access. Returns space IDs (sp_...), names, types, and states. Use `q` to search by name.",
+    {
+      limit: z.number().optional().describe("Max results per page (default 25, max 100)"),
+      cursor: z.string().optional().describe("Pagination cursor from a previous response"),
+      q: z.string().optional().describe("Search spaces by name (case-insensitive)"),
+      state: z.enum(["active", "archived"]).optional().describe("Filter by state"),
+      type: z.string().optional().describe("Filter by type (e.g. content, forum)"),
+      privacy: z.enum(["open", "closed", "secret"]).optional().describe("Filter by privacy level"),
+    },
+    async ({ limit, cursor, q, state, type, privacy }) => {
+      const data = await client.get("/spaces", { limit, cursor, q, state, type, privacy });
+      return json(data);
+    }
+  );
+
+  server.tool(
+    "list_membership_spaces",
+    "List basic information about spaces where the API token owner is a member. This is read-only membership inventory, not admin access to space subresources.",
     {
       limit: z.number().optional().describe("Max results per page (default 25, max 100)"),
       cursor: z.string().optional().describe("Pagination cursor from a previous response"),
     },
     async ({ limit, cursor }) => {
-      const data = await client.get("/spaces", { limit, cursor });
+      const data = await client.get("/me/membership_spaces", { limit, cursor });
       return json(data);
     }
   );

package/src/tools/surveys.js

@@ -3,14 +3,16 @@ import { z } from "zod";
 export function registerSurveyTools(server, client) {
   server.tool(
     "list_surveys",
-    "List surveys in a space.",
+    "List surveys in a space. Use `q` to search by title.",
     {
       space_id: z.string().describe("Space ID (sp_...)"),
       limit: z.number().optional().describe("Max results (default 25)"),
       cursor: z.string().optional().describe("Pagination cursor"),
+      q: z.string().optional().describe("Search surveys by title (case-insensitive)"),
+      type: z.string().optional().describe("Filter by survey type"),
     },
-    async ({ space_id, limit, cursor }) => {
-      const data = await client.get(`/spaces/${space_id}/surveys`, { limit, cursor });
+    async ({ space_id, limit, cursor, q, type }) => {
+      const data = await client.get(`/spaces/${space_id}/surveys`, { limit, cursor, q, type });
       return json(data);
     }
   );