From 8bf4ee89fc0941e48328b93b1a06623094e36107 Mon Sep 17 00:00:00 2001 From: Alex Salmov Date: Fri, 2 Oct 2026 12:53:19 +0400 Subject: [PATCH] docs(readme): list attach_media and account_context on the hosted server The hosted server (live tools/list, 2026-10-02) has 20 personal tools plus 12 company_* tools for Agency client work. attach_media is live since 2026-09-28, account_context since 2026-10-01. - README: Available Tools 18 -> 20; attach_media added to Media; Connections becomes "Account and connections" with account_context; the Local Development snapshot note now also lists attach_media, account_context and the company_* tools as missing from this code. - SKILL.md: its hosted tool list said 16 and named LinkedIn analytics and workspace tools the hosted server does not have; it now lists the 20 hosted tools and notes the REST-only features and the company_* tools. - context7.json: the hosted tool-count rule says 20 (+12 company_*). - docs/getting-started.md: "all 16 MCP tools" now links the hosted tool reference; the local overview stays linked as the older snapshot. Code is untouched; the snapshot's own docs (docs/tools/overview.md, docs/examples.md) are left as they are. --- README.md | 8 +++++--- SKILL.md | 37 ++++++++++++++++++++++++------------- context7.json | 2 +- docs/getting-started.md | 2 +- 4 files changed, 31 insertions(+), 18 deletions(-) diff --git a/README.md b/README.md index 649cd78..d5abb6c 100644 --- a/README.md +++ b/README.md @@ -121,12 +121,12 @@ PUBLORA_API_URL=https://api.publora.com npm start Server runs on `http://localhost:3100` -The code in this repository is an April 2026 snapshot of the server. Its tool set is older: it has LinkedIn analytics and workspace tools, and lacks `complete_media`, `delete_media`, `prune_media_reference`, `post_stats`, `profile_stats`, `linkedin_create_reshare` and `linkedin_list_mentionables`. Use the hosted server for the current tools. +The code in this repository is an April 2026 snapshot of the server. Its tool set is older: it has LinkedIn analytics and workspace tools, and lacks `attach_media`, `complete_media`, `delete_media`, `prune_media_reference`, `account_context`, `post_stats`, `profile_stats`, `linkedin_create_reshare`, `linkedin_list_mentionables` and the `company_*` Agency tools. Use the hosted server for the current tools. --- -## Available Tools (18) +## Available Tools (20) The hosted server at `mcp.publora.com/mcp` exposes: @@ -142,14 +142,16 @@ The hosted server at `mcp.publora.com/mcp` exposes: ### Media | Tool | Description | |------|-------------| +| `attach_media` | Attach an image or video from ChatGPT to an existing post; leaves the post in draft | | `get_upload_url` | Get a presigned URL for media upload | | `complete_media` | Finalize a file uploaded via `get_upload_url` | | `delete_media` | Remove a media slot from a post | | `prune_media_reference` | Remove a stale media reference that `delete_media` cannot handle | -### Connections +### Account and connections | Tool | Description | |------|-------------| +| `account_context` | Your plan, available features, publishing quotas and schedule horizon — check before a batch of posts or after a quota error | | `list_connections` | List connected social accounts | ### Statistics (Mastodon and Bluesky, Pro or Premium plan) diff --git a/SKILL.md b/SKILL.md index 60a3ad8..ca81c50 100644 --- a/SKILL.md +++ b/SKILL.md @@ -75,7 +75,7 @@ Add to MCP settings: mcporter add publora --transport http --url https://mcp.publora.com --header "Authorization: Bearer sk_your_api_key" ``` -## Available Tools (16 total) +## Available Tools (20 total) ### Posts @@ -86,32 +86,43 @@ mcporter add publora --transport http --url https://mcp.publora.com --header "Au | `get_post` | Get post details | | `update_post` | Reschedule or change status | | `delete_post` | Delete a post | + +### Media + +| Tool | Description | +|------|-------------| +| `attach_media` | Attach an image or video from ChatGPT to an existing post | | `get_upload_url` | Get media upload URL | +| `complete_media` | Finalize an uploaded file | +| `delete_media` | Remove a media file from a post | +| `prune_media_reference` | Remove a stale media reference | -### Connections +### Account and connections | Tool | Description | |------|-------------| +| `account_context` | Plan, features, publishing quotas and schedule horizon | | `list_connections` | List connected social accounts | -### LinkedIn Analytics +### Statistics (Mastodon and Bluesky, Pro or Premium plan) | Tool | Description | |------|-------------| -| `linkedin_post_stats` | Get post metrics | -| `linkedin_account_stats` | Get account metrics | -| `linkedin_followers` | Get follower count/growth | -| `linkedin_profile_summary` | Get profile overview | -| `linkedin_create_reaction` | React to a post | -| `linkedin_delete_reaction` | Remove reaction | +| `post_stats` | Get post engagement counters | +| `profile_stats` | Get followers, following and post count | -### Workspace +### LinkedIn Engagement | Tool | Description | |------|-------------| -| `list_workspace_users` | List team members | -| `create_workspace_user` | Add team member | -| `workspace_detach_user` | Remove team member | +| `linkedin_create_reaction` | React to a post | +| `linkedin_delete_reaction` | Remove reaction | +| `linkedin_create_comment` | Comment on a post | +| `linkedin_delete_comment` | Delete a comment | +| `linkedin_create_reshare` | Reshare a post | +| `linkedin_list_mentionables` | List people you can @mention | + +LinkedIn statistics and workspace (managed-user) administration are REST only. Clients also list 12 `company_*` tools; they are for Agency client work and only work on Agency accounts. ## Example Prompts diff --git a/context7.json b/context7.json index 5a5e3d5..c082558 100644 --- a/context7.json +++ b/context7.json @@ -7,7 +7,7 @@ "rules": [ "Publora MCP server is hosted at mcp.publora.com", "Authentication uses Bearer token with Publora API key (sk_...)", - "16 MCP tools available for posts, connections, analytics, and workspace", + "20 MCP tools for posts, media, account limits and connections, Mastodon and Bluesky statistics, and LinkedIn engagement, plus 12 company_* tools that only work on Agency accounts", "Supports 10 platforms: Twitter, LinkedIn, Instagram, Threads, TikTok, YouTube, Facebook, Bluesky, Mastodon, Telegram", "No coding required - users describe tasks in natural language", "Pricing starts at $5.40/month with full API and MCP access" diff --git a/docs/getting-started.md b/docs/getting-started.md index 6b4a89a..abcca67 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -98,6 +98,6 @@ You should see a list of your connected platforms. ## What's Next? -- [Available Tools](./tools/overview.md) — all 16 MCP tools +- [Available Tools](https://docs.publora.com/mcp/tools-reference) — the hosted server's 20 tools ([older local snapshot](./tools/overview.md)) - [Example Conversations](./examples.md) — common use cases - [Troubleshooting](./troubleshooting.md) — common issues