posterly-mcp-server 0.26.0 → 0.27.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/README.md +19 -3
  2. package/dist/index.js +94 -73
  3. package/dist/lib/api-client.d.ts +41 -0
  4. package/dist/lib/api-client.js +6 -0
  5. package/dist/lib/tool-annotations.d.ts +2 -0
  6. package/dist/lib/tool-annotations.js +37 -0
  7. package/dist/lib/version.d.ts +1 -1
  8. package/dist/lib/version.js +1 -1
  9. package/dist/tools/create-connect-session.d.ts +2 -2
  10. package/dist/tools/create-post.d.ts +42 -42
  11. package/dist/tools/create-post.js +7 -7
  12. package/dist/tools/create-posts-batch.d.ts +18 -18
  13. package/dist/tools/get-connect-link.d.ts +2 -2
  14. package/dist/tools/get-platform-schema.d.ts +2 -2
  15. package/dist/tools/get-post-analytics.js +65 -3
  16. package/dist/tools/list-posts.d.ts +2 -2
  17. package/dist/tools/reply-google-business-review.d.ts +2 -2
  18. package/dist/tools/submit-agent-feedback.d.ts +108 -0
  19. package/dist/tools/submit-agent-feedback.js +32 -0
  20. package/dist/tools/trigger-platform-helper.d.ts +2 -2
  21. package/dist/tools/trigger-platform-helper.js +1 -1
  22. package/dist/tools/update-post.d.ts +16 -16
  23. package/dist/tools/update-post.js +7 -7
  24. package/dist/tools/validate-post.d.ts +1080 -0
  25. package/dist/tools/validate-post.js +28 -0
  26. package/package.json +5 -3
  27. package/scripts/test-tool-annotations.mjs +32 -0
  28. package/server.json +38 -0
  29. package/src/index.ts +106 -0
  30. package/src/lib/api-client.ts +45 -0
  31. package/src/lib/tool-annotations.ts +47 -0
  32. package/src/lib/version.ts +1 -1
  33. package/src/tools/create-post.ts +7 -7
  34. package/src/tools/get-post-analytics.ts +66 -3
  35. package/src/tools/submit-agent-feedback.ts +47 -0
  36. package/src/tools/trigger-platform-helper.ts +1 -1
  37. package/src/tools/update-post.ts +7 -7
  38. package/src/tools/validate-post.ts +41 -0
  39. package/tool-annotations.json +199 -0
package/README.md CHANGED
@@ -16,6 +16,20 @@ This package gives Claude Desktop, Cursor, Windsurf, Cline, and other local MCP
16
16
 
17
17
  Posterly also exposes the same authenticated toolset over HTTP at [poster.ly/mcp](https://www.poster.ly/mcp), but this npm package is the local `stdio` connection for desktop AI clients.
18
18
 
19
+ ## Public discovery
20
+
21
+ - Hosted Streamable HTTP endpoint: `https://www.poster.ly/api/mcp`
22
+ - Server card: `https://www.poster.ly/.well-known/mcp/server-card.json`
23
+ - OpenAPI: `https://www.poster.ly/api/openapi`
24
+ - Agent skills: `https://www.poster.ly/.well-known/agent-skills/index.json`
25
+ - Agent reference: `https://www.poster.ly/llms-full.txt`
26
+ - Signup and API-key acquisition: `https://www.poster.ly/agents/signup`
27
+ - Smithery: `https://smithery.ai/servers/awpthorp/posterly`
28
+ - Source: `https://github.com/awpthorp/posterly/tree/main/mcp-server`
29
+
30
+ The official MCP Registry metadata is in `server.json`. Its canonical registry
31
+ name is `io.github.awpthorp/posterly`, matching this package's `mcpName`.
32
+
19
33
  ## Requirements
20
34
 
21
35
  - Node.js `20+`
@@ -108,7 +122,7 @@ Add the same server definition to your Cursor MCP settings:
108
122
 
109
123
  ## Available tools
110
124
 
111
- `posterly-mcp-server@0.26.0` exposes 73 tools.
125
+ `posterly-mcp-server@0.27.0` exposes 75 tools.
112
126
 
113
127
  Public setup tools work before `POSTERLY_API_KEY` exists:
114
128
 
@@ -149,6 +163,8 @@ Authenticated tools require `POSTERLY_API_KEY`:
149
163
  - `get_post_missing`
150
164
  - `ask_support` (authenticated docs-backed support with read-only account/post diagnostics; human tickets require explicit confirmation)
151
165
  - `create_post` (supports `thread_posts: string[]` for X / Threads reply chains, plus `platform_settings` for platform-specific composer controls)
166
+ - `validate_post` (checks and normalizes a post without creating it; call before requesting confirmation for `create_post`)
167
+ - `submit_agent_feedback` (writes bounded private operational telemetry after a real workflow outcome; never include secrets, prompts, captions, media URLs, or personal data)
152
168
  - `create_posts_batch` (create up to 25 confirmed posts in one API request)
153
169
  - `update_post` (also accepts `platform_settings`)
154
170
  - `update_post_status` (pause, resume, schedule, or draft a post after confirmation)
@@ -242,7 +258,7 @@ This package uses the Posterly API/MCP add-on:
242
258
  - `$3/month` add-on
243
259
  - `100 create-post requests/hour` per API key, with separate media/read limits
244
260
  - user-created API keys per plan: Starter 1, Pro 2, Power 3, Agency 4
245
- - works across all 17 supported platforms
261
+ - works across all 18 supported platforms: Instagram, Facebook, TikTok, X, LinkedIn, YouTube, Pinterest, Threads, Google Business, Telegram, Bluesky, Discord, Slack, Mastodon, Dev.to, Hashnode, WordPress, and Lemmy
246
262
 
247
263
  Each API call counts as one request, so use `create_posts_batch` when you need to schedule multiple posts in one confirmed operation.
248
264
 
@@ -255,7 +271,7 @@ Details: [poster.ly/dashboard/api](https://www.poster.ly/dashboard/api)
255
271
  - API add-on: [poster.ly/dashboard/api](https://www.poster.ly/dashboard/api)
256
272
  - MCP server card: [/.well-known/mcp/server-card.json](https://www.poster.ly/.well-known/mcp/server-card.json)
257
273
  - OAuth authorization server metadata: [/.well-known/oauth-authorization-server](https://www.poster.ly/.well-known/oauth-authorization-server)
258
- - OAuth protected resource metadata: [/.well-known/oauth-protected-resource](https://www.poster.ly/.well-known/oauth-protected-resource)
274
+ - OAuth protected resource metadata: [/.well-known/oauth-protected-resource/api/mcp](https://www.poster.ly/.well-known/oauth-protected-resource/api/mcp)
259
275
 
260
276
  ## Development
261
277