Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
</details>

---

## Available Tools (18)
## Available Tools (20)

The hosted server at `mcp.publora.com/mcp` exposes:

Expand All @@ -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)
Expand Down
37 changes: 24 additions & 13 deletions SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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

Expand Down
2 changes: 1 addition & 1 deletion context7.json
Original file line number Diff line number Diff line change
Expand Up @@ -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"
Expand Down
2 changes: 1 addition & 1 deletion docs/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Loading