@jullury/shoanta-mcp 0.1.0 → 0.2.0

package/README.md

@@ -1,7 +1,7 @@
 # Shoanta MCP Server
 
 A **stdio-based MCP (Model Context Protocol) server** that lets any AI agent
-(Claude, opencode, Cursor, Windsurf, etc.) read and update Shoanta tickets
+(Claude, opencode, Cursor, Windsurf, etc.) read and update Shoanta documents
 through the Shoanta REST API (`/api/v1`).
 
 The MCP server is a thin proxy: it calls the Shoanta HTTP API using a
@@ -44,16 +44,16 @@ node dist/index.mjs
 
 ## Tools
 
-| Tool              | Description                                        |
-| ----------------- | -------------------------------------------------- |
-| `list_databases`  | List database boards in the workspace              |
-| `list_tickets`    | List tickets in a database board                   |
-| `get_ticket`      | Get one ticket by ID (with property values)        |
-| `create_ticket`   | Create a ticket in a board                         |
-| `update_ticket`   | Update title, content, and/or property values      |
-| `delete_ticket`   | Delete a ticket (or archive with `archive: true`)  |
-| `list_comments`   | List comments on a ticket                          |
-| `add_comment`     | Add a comment to a ticket                          |
+| Tool                   | Description                                       |
+| ---------------------- | ------------------------------------------------- |
+| `list_collections`     | List all collections (databases) in the workspace |
+| `list_documents`       | List all documents in a collection                |
+| `get_document`         | Get one document by ID (with property values)     |
+| `create_document`      | Create a document in a collection                 |
+| `update_document`      | Update title, content, and/or property values     |
+| `delete_document`      | Delete a document (or archive with `archive: true`) |
+| `list_comments`        | List comments on a document                       |
+| `add_comment`          | Add a comment to a document                       |
 
 ## Connecting an agent
 

package/dist/index.mjs

@@ -35525,7 +35525,7 @@ async function api(path, init = {}) {
 }
 var server = new McpServer({
   name: "shoanta",
-  version: "0.1.0"
+  version: "0.2.0"
 });
 var propertiesSchema = external_exports.record(
   external_exports.union([
@@ -35539,10 +35539,10 @@ var propertiesSchema = external_exports.record(
   'Property values keyed by property name, e.g. {"Status":"Done","Priority":"High"}'
 );
 server.registerTool(
-  "list_databases",
+  "list_collections",
   {
-    title: "List databases",
-    description: "List all databases (boards) in the Shoanta workspace."
+    title: "List collections",
+    description: "List all collections (databases) in the Shoanta workspace."
   },
   async () => {
     const data = await api("/databases");
@@ -35552,17 +35552,17 @@ server.registerTool(
   }
 );
 server.registerTool(
-  "list_tickets",
+  "list_documents",
   {
-    title: "List tickets",
-    description: "List all tickets (pages/cards) in a database board.",
+    title: "List documents",
+    description: "List all documents in a collection.",
     inputSchema: {
-      databaseId: external_exports.string().describe("ID of the database/board")
+      collectionId: external_exports.string().describe("ID of the collection (database)")
     }
   },
-  async ({ databaseId }) => {
+  async ({ collectionId }) => {
     const data = await api(
-      `/databases/${databaseId}/tickets`
+      `/databases/${collectionId}/tickets`
     );
     return {
       content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
@@ -35570,36 +35570,36 @@ server.registerTool(
   }
 );
 server.registerTool(
-  "get_ticket",
+  "get_document",
   {
-    title: "Get ticket",
-    description: "Get a single ticket by ID, including its property values.",
+    title: "Get document",
+    description: "Get a single document by ID, including its property values.",
     inputSchema: {
-      ticketId: external_exports.string().describe("Ticket ID")
+      documentId: external_exports.string().describe("Document ID")
     }
   },
-  async ({ ticketId }) => {
-    const data = await api(`/tickets/${ticketId}`);
+  async ({ documentId }) => {
+    const data = await api(`/tickets/${documentId}`);
     return {
       content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
     };
   }
 );
 server.registerTool(
-  "create_ticket",
+  "create_document",
   {
-    title: "Create ticket",
-    description: "Create a new ticket (card) in a database board.",
+    title: "Create document",
+    description: "Create a new document in a collection.",
     inputSchema: {
-      databaseId: external_exports.string().describe("ID of the database/board"),
-      title: external_exports.string().describe("Ticket title"),
-      content: external_exports.string().optional().describe("Ticket content (markdown)"),
+      collectionId: external_exports.string().describe("ID of the collection (database)"),
+      title: external_exports.string().describe("Document title"),
+      content: external_exports.string().optional().describe("Document content (markdown)"),
       properties: propertiesSchema.optional()
     }
   },
-  async ({ databaseId, title, content, properties }) => {
+  async ({ collectionId, title, content, properties }) => {
     const data = await api(
-      `/databases/${databaseId}/tickets`,
+      `/databases/${collectionId}/tickets`,
       {
         method: "POST",
         body: JSON.stringify({ title, content, properties })
@@ -35611,23 +35611,23 @@ server.registerTool(
   }
 );
 server.registerTool(
-  "update_ticket",
+  "update_document",
   {
-    title: "Update ticket",
-    description: "Update ticket title, content, and/or property values. Only provided fields are changed.",
+    title: "Update document",
+    description: "Update document title, content, and/or property values. Only provided fields are changed.",
     inputSchema: {
-      ticketId: external_exports.string().describe("Ticket ID"),
+      documentId: external_exports.string().describe("Document ID"),
       title: external_exports.string().optional().describe("New title"),
       content: external_exports.string().optional().describe("New content (markdown)"),
       properties: propertiesSchema.optional()
     }
   },
-  async ({ ticketId, title, content, properties }) => {
+  async ({ documentId, title, content, properties }) => {
     const body = {};
     if (title !== void 0) body.title = title;
     if (content !== void 0) body.content = content;
     if (properties !== void 0) body.properties = properties;
-    const data = await api(`/tickets/${ticketId}`, {
+    const data = await api(`/tickets/${documentId}`, {
       method: "PATCH",
       body: JSON.stringify(body)
     });
@@ -35637,18 +35637,18 @@ server.registerTool(
   }
 );
 server.registerTool(
-  "delete_ticket",
+  "delete_document",
   {
-    title: "Delete ticket",
-    description: "Delete a ticket. If archive is true, it is moved to trash instead of being permanently deleted.",
+    title: "Delete document",
+    description: "Delete a document. If archive is true, it is moved to trash instead of being permanently deleted.",
     inputSchema: {
-      ticketId: external_exports.string().describe("Ticket ID"),
+      documentId: external_exports.string().describe("Document ID"),
       archive: external_exports.boolean().optional().describe("Archive instead of hard-delete")
     }
   },
-  async ({ ticketId, archive }) => {
+  async ({ documentId, archive }) => {
     const qs = archive ? "?archive=true" : "";
-    const data = await api(`/tickets/${ticketId}${qs}`, {
+    const data = await api(`/tickets/${documentId}${qs}`, {
       method: "DELETE"
     });
     return {
@@ -35660,14 +35660,14 @@ server.registerTool(
   "list_comments",
   {
     title: "List comments",
-    description: "List comments on a ticket.",
+    description: "List comments on a document.",
     inputSchema: {
-      ticketId: external_exports.string().describe("Ticket ID")
+      documentId: external_exports.string().describe("Document ID")
     }
   },
-  async ({ ticketId }) => {
+  async ({ documentId }) => {
     const data = await api(
-      `/tickets/${ticketId}/comments`
+      `/tickets/${documentId}/comments`
     );
     return {
       content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
@@ -35678,15 +35678,15 @@ server.registerTool(
   "add_comment",
   {
     title: "Add comment",
-    description: "Add a comment to a ticket.",
+    description: "Add a comment to a document.",
     inputSchema: {
-      ticketId: external_exports.string().describe("Ticket ID"),
+      documentId: external_exports.string().describe("Document ID"),
       body: external_exports.string().describe("Comment body")
     }
   },
-  async ({ ticketId, body }) => {
+  async ({ documentId, body }) => {
     const data = await api(
-      `/tickets/${ticketId}/comments`,
+      `/tickets/${documentId}/comments`,
       {
         method: "POST",
         body: JSON.stringify({ body })

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jullury/shoanta-mcp",
-  "version": "0.1.0",
-  "description": "MCP server that lets AI agents read/update Shoanta tickets via the Shoanta REST API",
+  "version": "0.2.0",
+  "description": "MCP server that lets AI agents read/update Shoanta documents and collections via the Shoanta REST API",
   "type": "module",
   "main": "dist/index.mjs",
   "exports": {
@@ -23,7 +23,8 @@
     "mcp",
     "model-context-protocol",
     "shoanta",
-    "tickets",
+    "documents",
+    "collections",
     "ai",
     "agent"
   ],