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.
- package/README.md +19 -3
- package/dist/index.js +94 -73
- package/dist/lib/api-client.d.ts +41 -0
- package/dist/lib/api-client.js +6 -0
- package/dist/lib/tool-annotations.d.ts +2 -0
- package/dist/lib/tool-annotations.js +37 -0
- package/dist/lib/version.d.ts +1 -1
- package/dist/lib/version.js +1 -1
- 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 +7 -7
- package/dist/tools/create-posts-batch.d.ts +18 -18
- 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 +65 -3
- package/dist/tools/list-posts.d.ts +2 -2
- package/dist/tools/reply-google-business-review.d.ts +2 -2
- package/dist/tools/submit-agent-feedback.d.ts +108 -0
- package/dist/tools/submit-agent-feedback.js +32 -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 -16
- package/dist/tools/update-post.js +7 -7
- package/dist/tools/validate-post.d.ts +1080 -0
- package/dist/tools/validate-post.js +28 -0
- package/package.json +5 -3
- package/scripts/test-tool-annotations.mjs +32 -0
- package/server.json +38 -0
- package/src/index.ts +106 -0
- package/src/lib/api-client.ts +45 -0
- package/src/lib/tool-annotations.ts +47 -0
- package/src/lib/version.ts +1 -1
- package/src/tools/create-post.ts +7 -7
- package/src/tools/get-post-analytics.ts +66 -3
- package/src/tools/submit-agent-feedback.ts +47 -0
- package/src/tools/trigger-platform-helper.ts +1 -1
- package/src/tools/update-post.ts +7 -7
- package/src/tools/validate-post.ts +41 -0
- 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.
|
|
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
|
|
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
|
|