Skip to content
Draft
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
2 changes: 1 addition & 1 deletion content/docs/manifest.json

Large diffs are not rendered by default.

21 changes: 21 additions & 0 deletions content/docs/source/llms-full.txt
Original file line number Diff line number Diff line change
Expand Up @@ -1116,6 +1116,27 @@ API-key MCP and `mcp:tools` grants expose three tools that mirror REST; `mcp:rea
Access errors, an unknown artist and insufficient credits return a tool error with
`success: false` and a `message`; MCP has no HTTP status.

## Published posts and stats

Pending [api#1246](https://github.com/recoupable/api/pull/1246): until that release is
deployed, these tools are absent from `tools/list`. When deployed, API-key MCP and
`mcp:tools` grants expose two tools that mirror REST; `mcp:read` / `mcp:write` grants
don't. They read posts Recoup published for you, not scraped posts, which
`get_artist_posts` returns.

- `get_published_posts` takes optional `artist_account_id`, `platform`, `status`,
`limit` (1-50, default 20) and `offset`. It returns the same `{ status, posts }`
envelope as [List posts](https://docs.recoupable.dev/api-reference/publishing/list): your account's posts,
newest first. Each post's `id` is what `get_published_post_stats` takes. Free.
- `get_published_post_stats` takes a post `id` and returns the same `{ status, stats }`
envelope as [Get post stats](https://docs.recoupable.dev/api-reference/publishing/stats), read live from the
platform. Only published LinkedIn company-page posts have stats. Credits are checked
before LinkedIn is called, and a successful read charges $0.001; a failed read costs
nothing. Each call is a new paid read, so keep the result rather than polling.

Where REST answers 400, 403, 404, 409, 422, 402 or 502, the tool returns a tool error
with `success: false` and the same `message`; MCP has no HTTP status.


# Recoup public website API

Expand Down
21 changes: 21 additions & 0 deletions content/docs/source/mcp-server.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -121,3 +121,24 @@ API-key MCP and `mcp:tools` grants expose three tools that mirror REST; `mcp:rea

Access errors, an unknown artist and insufficient credits return a tool error with
`success: false` and a `message`; MCP has no HTTP status.

## Published posts and stats

Pending [api#1246](https://github.com/recoupable/api/pull/1246): until that release is
deployed, these tools are absent from `tools/list`. When deployed, API-key MCP and
`mcp:tools` grants expose two tools that mirror REST; `mcp:read` / `mcp:write` grants
don't. They read posts Recoup published for you, not scraped posts, which
`get_artist_posts` returns.

- `get_published_posts` takes optional `artist_account_id`, `platform`, `status`,
`limit` (1-50, default 20) and `offset`. It returns the same `{ status, posts }`
envelope as [List posts](/api-reference/publishing/list): your account's posts,
newest first. Each post's `id` is what `get_published_post_stats` takes. Free.
- `get_published_post_stats` takes a post `id` and returns the same `{ status, stats }`
envelope as [Get post stats](/api-reference/publishing/stats), read live from the
platform. Only published LinkedIn company-page posts have stats. Credits are checked
before LinkedIn is called, and a successful read charges $0.001; a failed read costs
nothing. Each call is a new paid read, so keep the result rather than polling.

Where REST answers 400, 403, 404, 409, 422, 402 or 502, the tool returns a tool error
with `success: false` and the same `message`; MCP has no HTTP status.
Loading