docs(mcp): contract for get_published_posts and get_published_post_stats

Draft
SW
5d ago
+43-1

Before: the MCP Server page documents no way to list the posts Recoup published or read their stats. get_artist_posts only returns scraped posts, which carry no post id that stats can take.

After: a "Published posts and stats" section documents two tools, marked pending the api release. get_published_posts mirrors List posts and is free. get_published_post_stats mirrors Get post stats: LinkedIn company-page posts only, credits checked before LinkedIn is called, $0.001 per successful read. REST errors come back as tool errors with the same message.

How: one new section in content/docs/source/mcp-server.mdx after "Social scrapes and posts", same shape as docs#38. manifest.json and llms-full.txt regenerated with pnpm docs:build. The contract inventory is pinned in a follow-up docs PR after the api PR merges, as docs#39 did.

Checks run locally: pnpm docs:check, pnpm test (164 passed), pnpm type-check, pnpm lint.

Merge sequencing: this docs PR -> api PR -> docs inventory pin. Tracking: recoupable/app#2399


Generated by Claude Code


Summary by cubic

Documents the contract for two new MCP tools—get_published_posts and get_published_post_stats—so the MCP server docs cover how to list posts Recoup published and read their stats. get_artist_posts only returns scraped posts, which carry no post id that stats can take.

  • Adds a "Published posts and stats" section to content/docs/source/mcp-server.mdx, marked pending api#1246; until that release deploys, the tools are absent from tools/list and mcp:read/mcp:write grants don't expose them.
  • get_published_posts mirrors List posts, is free, and each returned post's id is what get_published_post_stats takes.
  • get_published_post_stats mirrors Get post stats: LinkedIn company-page posts only, credits checked before LinkedIn is called, $0.001 per successful read, nothing on failure.
  • REST failures come back as tool errors with the same message; MCP has no HTTP status.
  • Regenerates manifest.json and llms-full.txt with pnpm docs:build; a merge with main regenerated the manifest to resolve a conflict with the CLI guide changes. Merge order: this docs PR → API PR → docs inventory pin (tracking recoupable/app#2399); checks run locally: pnpm docs:check, pnpm test, pnpm type-check, pnpm lint.