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