Skip to content

docs: Agency and ordered first comments #7

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
salmov wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: Agency and ordered first comments #7

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
33 changes: 28 additions & 5 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -126,17 +126,17 @@ The code in this repository is an April 2026 snapshot of the server. Its tool se

---

## Available Tools (18)
## Selected Hosted Tools

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

### Posts
| Tool | Description |
|------|-------------|
| `list_posts` | List posts with filters (status, platform, dates) |
| `create_post` | Create a draft or schedule a post; accepts `mediaUrls` and `platformSettings` |
| `get_post` | Get post details and status |
| `update_post` | Edit a draft or scheduled post: content, platforms, schedule, status |
| `create_post` | Create a draft or schedule a post; accepts `mediaUrls`, `platformSettings`, and ordered `firstComments` (or legacy `firstComment`) |
| `get_post` | Get post details, including per-target `firstCommentResults[]` |
| `update_post` | Edit a draft or scheduled post: content, platforms, schedule, status, and first comments |
| `delete_post` | Delete a post |

### Media
Expand Down Expand Up @@ -168,7 +168,30 @@ The hosted server at `mcp.publora.com/mcp` exposes:
| `linkedin_create_reshare` | Repost/reshare a LinkedIn post |
| `linkedin_list_mentionables` | List people you can @mention in a LinkedIn post |

LinkedIn analytics and workspace management are available through the [REST API](https://docs.publora.com), not MCP. Full parameters: [MCP Tools Reference](https://docs.publora.com/mcp/tools-reference).
### Agency
| Tool | Description |
|------|-------------|
| `company_save_post` | Create or update a client draft; accepts one `draft.firstComment` |
| `company_posts` | Read client posts and per-target first-comment results with `action: "detail"` |

LinkedIn analytics are also available through the [REST API](https://docs.publora.com). Full personal-tool parameters: [MCP Tools Reference](https://docs.publora.com/mcp/tools-reference).

### First comments on the hosted server

Personal `create_post` and `update_post` accept `firstComments` with up to three
ordered `{ text, platforms?, delaySeconds? }` items. `platforms` contains platform
types such as `linkedin`, never connection IDs. `delaySeconds` is an integer from
0 to 86,400; omit it for zero. Each later comment waits until the preceding
one posts, and a failure stops the sequence. Delivery runs on scheduler ticks.
Use the older `firstComment: { text, platforms? }` for one comment; never send
both fields. `firstComments: null` or `[]` clears the list on update. Read
`get_post` → `posts[].firstCommentResults[]` in order; the old
`firstCommentResult` field still mirrors the first item.

Agency tools accept one `draft.firstComment` through `company_save_post`; read
its per-target `firstCommentResult` with `company_posts` action `detail`.
Several comments are currently personal-only. These contracts describe the
hosted server; the local code in this repository is an older snapshot.

---

Expand Down
14 changes: 13 additions & 1 deletion docs/tools/overview.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,18 @@
# Publora MCP Tools Overview

Publora provides 16 MCP tools for managing social media via AI assistants.
This page describes the 16 tools in this repository's older local server
snapshot. The hosted server has additional tools and fields; see the
[hosted server tool reference](https://docs.publora.com/mcp/tools-reference).

On the hosted server, personal `create_post`/`update_post` accept up to three
ordered `firstComments: [{ text, platforms?, delaySeconds? }]` (integer delay
0–86,400 seconds). The legacy `firstComment` object remains available for one
comment. Use one input form at a time; `firstComments: null` or `[]` clears the
list on update. `get_post` exposes `posts[].firstCommentResults[]` in order,
with legacy `firstCommentResult` mirroring item 0. Agency
`company_save_post` accepts one `draft.firstComment`; read its result with
`company_posts` action `detail`. The local snapshot below does not implement
these hosted features.

## Posts (6 tools)

Expand Down
Loading