posterly-mcp-server 0.31.0 → 0.33.0

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 (53) hide show
  1. package/README.md +5 -2
  2. package/dist/index.js +96 -75
  3. package/dist/lib/api-client.d.ts +55 -2
  4. package/dist/lib/api-client.js +14 -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 +26 -15
  12. package/dist/tools/create-posts-batch.d.ts +18 -18
  13. package/dist/tools/generate-image.d.ts +4 -4
  14. package/dist/tools/generate-image.js +3 -3
  15. package/dist/tools/generate-video.d.ts +3 -3
  16. package/dist/tools/generate-video.js +2 -2
  17. package/dist/tools/get-connect-link.d.ts +2 -2
  18. package/dist/tools/get-credits.d.ts +8 -0
  19. package/dist/tools/get-credits.js +33 -0
  20. package/dist/tools/get-platform-schema.d.ts +2 -2
  21. package/dist/tools/get-platform-schema.js +5 -1
  22. package/dist/tools/get-post-analytics.js +65 -3
  23. package/dist/tools/get-updates.d.ts +24 -0
  24. package/dist/tools/get-updates.js +29 -0
  25. package/dist/tools/list-accounts.js +18 -3
  26. package/dist/tools/list-posts.d.ts +2 -2
  27. package/dist/tools/start-signup.js +1 -1
  28. package/dist/tools/submit-product-feedback.d.ts +4 -4
  29. package/dist/tools/trigger-platform-helper.d.ts +2 -2
  30. package/dist/tools/trigger-platform-helper.js +1 -1
  31. package/dist/tools/update-post.d.ts +41 -16
  32. package/dist/tools/update-post.js +21 -10
  33. package/dist/tools/validate-post.d.ts +24 -24
  34. package/package.json +4 -2
  35. package/scripts/test-payload-builders.mjs +87 -0
  36. package/scripts/test-tool-annotations.mjs +43 -0
  37. package/server.json +2 -2
  38. package/src/index.ts +108 -0
  39. package/src/lib/api-client.ts +58 -2
  40. package/src/lib/tool-annotations.ts +47 -0
  41. package/src/lib/version.ts +1 -1
  42. package/src/tools/create-post.ts +28 -15
  43. package/src/tools/generate-image.ts +4 -4
  44. package/src/tools/generate-video.ts +2 -2
  45. package/src/tools/get-credits.ts +38 -0
  46. package/src/tools/get-platform-schema.ts +5 -1
  47. package/src/tools/get-post-analytics.ts +66 -3
  48. package/src/tools/get-updates.ts +41 -0
  49. package/src/tools/list-accounts.ts +19 -3
  50. package/src/tools/start-signup.ts +1 -1
  51. package/src/tools/trigger-platform-helper.ts +1 -1
  52. package/src/tools/update-post.ts +21 -10
  53. package/tool-annotations.json +203 -0
package/README.md CHANGED
@@ -24,6 +24,7 @@ Posterly also exposes the same authenticated toolset over HTTP at [poster.ly/mcp
24
24
  - Agent skills: `https://www.poster.ly/.well-known/agent-skills/index.json`
25
25
  - Agent reference: `https://www.poster.ly/llms-full.txt`
26
26
  - Signup and API-key acquisition: `https://www.poster.ly/agents/signup`
27
+ - Smithery: `https://smithery.ai/servers/awpthorp/posterly`
27
28
  - Source: `https://github.com/awpthorp/posterly/tree/main/mcp-server`
28
29
 
29
30
  The official MCP Registry metadata is in `server.json`. Its canonical registry
@@ -121,7 +122,7 @@ Add the same server definition to your Cursor MCP settings:
121
122
 
122
123
  ## Available tools
123
124
 
124
- `posterly-mcp-server@0.31.0` exposes 75 tools.
125
+ `posterly-mcp-server@0.32.0` exposes 77 tools.
125
126
 
126
127
  Public setup tools work before `POSTERLY_API_KEY` exists:
127
128
 
@@ -180,6 +181,7 @@ Authenticated tools require `POSTERLY_API_KEY`:
180
181
  - `get_video_options`
181
182
  - `run_video_function` (read-only Veo helpers for cost estimation and request validation)
182
183
  - `generate_video` (queues a cost-guarded Veo video job)
184
+ - `get_credits` (read-only AI credit balance)
183
185
  - `get_video_job` (poll one job or list recent jobs)
184
186
  - `get_account_analytics`
185
187
  - `get_post_analytics`
@@ -200,6 +202,7 @@ Authenticated tools require `POSTERLY_API_KEY`:
200
202
  > Google Business tip: pass `account_id` (the integer `id` from `list_accounts`) to every GBP tool. If you use `location_id` instead, it is the numeric `location_id` from `list_accounts` (the GBP location id), not the `ChIJ...` Place ID that `get_google_business_review_link` returns. Passing the Place ID resolves to no account and returns "Google Business Profile account not found".
201
203
 
202
204
  - `list_activity`
205
+ - `get_updates` (read the latest posterly product updates and news)
203
206
  - `list_webhooks`
204
207
  - `create_webhook` (create a webhook after explicit confirmation)
205
208
  - `update_webhook` (update a webhook after explicit confirmation)
@@ -270,7 +273,7 @@ Details: [poster.ly/dashboard/api](https://www.poster.ly/dashboard/api)
270
273
  - API add-on: [poster.ly/dashboard/api](https://www.poster.ly/dashboard/api)
271
274
  - MCP server card: [/.well-known/mcp/server-card.json](https://www.poster.ly/.well-known/mcp/server-card.json)
272
275
  - OAuth authorization server metadata: [/.well-known/oauth-authorization-server](https://www.poster.ly/.well-known/oauth-authorization-server)
273
- - OAuth protected resource metadata: [/.well-known/oauth-protected-resource](https://www.poster.ly/.well-known/oauth-protected-resource)
276
+ - OAuth protected resource metadata: [/.well-known/oauth-protected-resource/api/mcp](https://www.poster.ly/.well-known/oauth-protected-resource/api/mcp)
274
277
 
275
278
  ## Development
276
279