@glie/mcp-polaris 0.10.0 → 0.12.0

package/dist/index.js

@@ -442,7 +442,7 @@ var TOOLS = [
   },
   {
     name: "polaris.task.schedule",
-    description: "Schedule a mkt creative for publication: approval \u2192 agendado, and the publisher takes it to `done` when its time arrives. The creative must be bound to an active social account (resolved from its market + channel) and have a publish_at in the future. Its copy is frozen while scheduled \u2014 editing it requires unscheduling first.",
+    description: "Schedule a mkt creative for publication: release \u2192 agendado, and the publisher takes it to `done` when its time arrives. The creative must be bound to an active social account (resolved from its market + channel) and have a publish_at in the future. Its copy is frozen while scheduled \u2014 editing it requires unscheduling first.",
     inputSchema: objSchema({ id: intSchema() }, ["id"]),
     call: async (args) => (await apiCall("POST", `/api/tasks/${args.id}/schedule`)).body
   },
@@ -454,9 +454,12 @@ var TOOLS = [
   },
   {
     name: "polaris.task.mark_published",
-    description: "The creative has gone out: `release` \u2192 `done`, optionally with the permalink of the post. This is the LAST transition, not a shortcut \u2014 approve it into `release` first (cleared to go out), then mark it published once it actually has. Recorded as a manual human action; use it when the post went out outside the scheduler.",
-    inputSchema: objSchema({ id: intSchema() }, ["id"]),
-    call: async (args) => (await apiCall("POST", `/api/tasks/${args.id}/mark-published`)).body
+    description: "The creative has gone out: `release` \u2192 `done`, with the link of the post. The link is what closes it \u2014 without one it waits in `release` \u2014 except a newsletter, which goes out by email and closes without a link. This is the LAST transition, not a shortcut: approve it into `release` first (cleared to go out), then mark it published once it actually has. A creative never reaches `done` through polaris.task.transition. Human-only; use it when the post went out outside the scheduler.",
+    inputSchema: objSchema({
+      id: intSchema(),
+      permalink: strSchema("The http(s) address of the published post. Optional only for a newsletter.")
+    }, ["id"]),
+    call: async (args) => (await apiCall("POST", `/api/tasks/${args.id}/mark-published`, typeof args.permalink === "string" ? { permalink: args.permalink } : {})).body
   },
   {
     name: "polaris.task.dep_add",
@@ -766,10 +769,30 @@ var TOOLS = [
   },
   {
     name: "polaris.presence.list",
-    description: "Where a product exists in the world: the channels it publishes on and the directories it is listed in, each with its state (missing \u2192 exists \u2192 connected). Read this before writing a campaign \u2014 a channel that is not connected cannot be published to. Each row carries what the catalogue knows in `place`: read `place.actor` before planning work there \u2014 `agent` means there is a publishing tool, `human` means a person does it and records where, and `place.final_state` says how far this particular place can ever get.",
+    description: "Where a product exists in the world: the channels it publishes on and the directories it is listed in, each with its state (missing \u2192 exists \u2192 connected). Where a creative may go is polaris.destination.list, which is read from these. Each row carries what the catalogue knows in `place`: read `place.actor` before planning work there \u2014 `agent` means there is a publishing tool, `human` means a person does it and records where, and `place.final_state` says how far this particular place can ever get.",
     inputSchema: objSchema({ key: strSchema("project key") }, ["key"]),
     call: async (args) => (await apiCall("GET", `/api/projects/${args.key}/presences`)).body
   },
+  {
+    name: "polaris.destination.list",
+    description: "Where a creative may go: the product's destinations. A destination is a presence \u2014 a place in a market where the product is \u2014 on a place pieces are made for, and each says its market, the formats it takes and how it goes out (`by_hand` always, `polaris` when a publishing adapter and an active account make it possible). `meta.not_plannable` says why any other presence is not a destination. Plan pieces only for these.",
+    inputSchema: objSchema({ key: strSchema("project key") }, ["key"]),
+    call: async (args) => (await apiCall("GET", `/api/projects/${args.key}/destinations`)).body
+  },
+  {
+    name: "polaris.social_account.list",
+    description: "The social accounts connected to publish through: a product's (`key`), or the organization's own when `key` is left out \u2014 the company's identity, which publishes as the company and not as a product. Each account says its channel, handle, market and timezone, whether it is `schedulable` (market and timezone set), and whether its credential needs a person (`token_expired`). No credential ever comes back. Connecting is a person's job, through the provider's consent screen; read this to know where a creative can go.",
+    inputSchema: objSchema({
+      key: strSchema("project key; leave it out for the organization's own accounts")
+    }),
+    call: async (args) => (await apiCall("GET", args.key ? `/api/projects/${args.key}/social-accounts` : "/api/org-social-accounts")).body
+  },
+  {
+    name: "polaris.org_presence.list",
+    description: "Where the COMPANY exists in the world, as opposed to one of its products: the organization's own entries (Crunchbase, the GitHub organization, Apple Business) and its own social networks. Same shape as polaris.presence.list.",
+    inputSchema: objSchema({}),
+    call: async () => (await apiCall("GET", "/api/org-presences")).body
+  },
   {
     name: "polaris.place.list",
     description: "The catalogue of places a product can exist in \u2014 every social network, paid surface, syndication platform, app store and software directory the studio knows about. The world's list, not ours: read it to decide WHERE a product should be. Each entry says what the place is, who acts there (`actor`: agent = there is a publishing tool; human = a person does it and records where), how far it can get (`final_state`), WHY it is worth being there (`note`), and the URL that was verified (`source`). Whether we are actually there is a PRESENCE \u2014 polaris.presence.list.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glie/mcp-polaris",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "Model Context Protocol (stdio) server exposing Polaris, glie's ops platform, as native tools in Claude Code and any MCP client.",
   "license": "Apache-2.0",
   "author": "glie <carlos@glie.ai>",