docs(mcp): contract for get_published_posts and get_published_post_stats
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 fromtools/listandmcp:read/mcp:writegrants don't expose them. get_published_postsmirrors List posts, is free, and each returned post'sidis whatget_published_post_statstakes.get_published_post_statsmirrors 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.jsonandllms-full.txtwithpnpm 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.