posterly-mcp-server 0.30.0 → 0.31.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.
- package/README.md +3 -5
- package/dist/index.js +84 -95
- package/dist/lib/api-client.d.ts +21 -46
- package/dist/lib/api-client.js +3 -14
- package/dist/lib/version.d.ts +1 -1
- package/dist/lib/version.js +1 -1
- package/dist/tools/add-google-business-media.d.ts +2 -2
- package/dist/tools/create-connect-session.d.ts +2 -2
- package/dist/tools/create-post.d.ts +42 -42
- package/dist/tools/create-post.js +10 -18
- package/dist/tools/create-posts-batch.d.ts +18 -18
- package/dist/tools/generate-image.d.ts +4 -4
- package/dist/tools/generate-image.js +3 -3
- package/dist/tools/generate-video.d.ts +3 -3
- package/dist/tools/generate-video.js +2 -2
- package/dist/tools/get-connect-link.d.ts +2 -2
- package/dist/tools/get-platform-schema.d.ts +2 -2
- package/dist/tools/get-post-analytics.js +3 -65
- package/dist/tools/list-posts.d.ts +2 -2
- package/dist/tools/submit-product-feedback.d.ts +88 -0
- package/dist/tools/submit-product-feedback.js +39 -0
- package/dist/tools/trigger-platform-helper.d.ts +2 -2
- package/dist/tools/trigger-platform-helper.js +1 -1
- package/dist/tools/update-post.d.ts +16 -41
- package/dist/tools/update-post.js +8 -16
- package/dist/tools/validate-post.d.ts +24 -24
- package/package.json +2 -4
- package/server.json +2 -2
- package/src/index.ts +15 -107
- package/src/lib/api-client.ts +26 -53
- package/src/lib/version.ts +1 -1
- package/src/tools/create-post.ts +10 -20
- package/src/tools/generate-image.ts +4 -4
- package/src/tools/generate-video.ts +2 -2
- package/src/tools/get-post-analytics.ts +3 -66
- package/src/tools/submit-product-feedback.ts +56 -0
- package/src/tools/trigger-platform-helper.ts +1 -1
- package/src/tools/update-post.ts +8 -16
- package/dist/lib/tool-annotations.d.ts +0 -2
- package/dist/lib/tool-annotations.js +0 -37
- package/dist/tools/get-credits.d.ts +0 -8
- package/dist/tools/get-credits.js +0 -33
- package/dist/tools/get-updates.d.ts +0 -24
- package/dist/tools/get-updates.js +0 -29
- package/scripts/test-payload-builders.mjs +0 -87
- package/scripts/test-tool-annotations.mjs +0 -32
- package/src/lib/tool-annotations.ts +0 -47
- package/src/tools/get-credits.ts +0 -38
- package/src/tools/get-updates.ts +0 -41
- package/tool-annotations.json +0 -202
package/README.md
CHANGED
|
@@ -24,7 +24,6 @@ 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`
|
|
28
27
|
- Source: `https://github.com/awpthorp/posterly/tree/main/mcp-server`
|
|
29
28
|
|
|
30
29
|
The official MCP Registry metadata is in `server.json`. Its canonical registry
|
|
@@ -122,7 +121,7 @@ Add the same server definition to your Cursor MCP settings:
|
|
|
122
121
|
|
|
123
122
|
## Available tools
|
|
124
123
|
|
|
125
|
-
`posterly-mcp-server@0.
|
|
124
|
+
`posterly-mcp-server@0.31.0` exposes 75 tools.
|
|
126
125
|
|
|
127
126
|
Public setup tools work before `POSTERLY_API_KEY` exists:
|
|
128
127
|
|
|
@@ -165,6 +164,7 @@ Authenticated tools require `POSTERLY_API_KEY`:
|
|
|
165
164
|
- `create_post` (supports `thread_posts: string[]` for X / Threads reply chains, plus `platform_settings` for platform-specific composer controls)
|
|
166
165
|
- `validate_post` (checks and normalizes a post without creating it; call before requesting confirmation for `create_post`)
|
|
167
166
|
- `submit_agent_feedback` (writes bounded private operational telemetry after a real workflow outcome; never include secrets, prompts, captions, media URLs, or personal data)
|
|
167
|
+
- `submit_product_feedback` (files a product bug/idea/feedback on the public dashboard board after explicit user confirmation; not for tool failures)
|
|
168
168
|
- `create_posts_batch` (create up to 25 confirmed posts in one API request)
|
|
169
169
|
- `update_post` (also accepts `platform_settings`)
|
|
170
170
|
- `update_post_status` (pause, resume, schedule, or draft a post after confirmation)
|
|
@@ -180,7 +180,6 @@ Authenticated tools require `POSTERLY_API_KEY`:
|
|
|
180
180
|
- `get_video_options`
|
|
181
181
|
- `run_video_function` (read-only Veo helpers for cost estimation and request validation)
|
|
182
182
|
- `generate_video` (queues a cost-guarded Veo video job)
|
|
183
|
-
- `get_credits` (read-only AI credit balance)
|
|
184
183
|
- `get_video_job` (poll one job or list recent jobs)
|
|
185
184
|
- `get_account_analytics`
|
|
186
185
|
- `get_post_analytics`
|
|
@@ -201,7 +200,6 @@ Authenticated tools require `POSTERLY_API_KEY`:
|
|
|
201
200
|
> 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".
|
|
202
201
|
|
|
203
202
|
- `list_activity`
|
|
204
|
-
- `get_updates` (read the latest posterly product updates and news)
|
|
205
203
|
- `list_webhooks`
|
|
206
204
|
- `create_webhook` (create a webhook after explicit confirmation)
|
|
207
205
|
- `update_webhook` (update a webhook after explicit confirmation)
|
|
@@ -272,7 +270,7 @@ Details: [poster.ly/dashboard/api](https://www.poster.ly/dashboard/api)
|
|
|
272
270
|
- API add-on: [poster.ly/dashboard/api](https://www.poster.ly/dashboard/api)
|
|
273
271
|
- MCP server card: [/.well-known/mcp/server-card.json](https://www.poster.ly/.well-known/mcp/server-card.json)
|
|
274
272
|
- OAuth authorization server metadata: [/.well-known/oauth-authorization-server](https://www.poster.ly/.well-known/oauth-authorization-server)
|
|
275
|
-
- OAuth protected resource metadata: [/.well-known/oauth-protected-resource
|
|
273
|
+
- OAuth protected resource metadata: [/.well-known/oauth-protected-resource](https://www.poster.ly/.well-known/oauth-protected-resource)
|
|
276
274
|
|
|
277
275
|
## Development
|
|
278
276
|
|