Skip to content

docs(mcp): contract for get_published_posts and get_published_post_stats - #40

Draft
sweetmantech wants to merge 3 commits into
mainfrom
claude/project-thread-w4bdrf
Draft

sweetmantech wants to merge 3 commits into
mainfrom
claude/project-thread-w4bdrf

Conversation

@sweetmantech

@sweetmantech sweetmantech commented Nov 17, 2026 •

Copy link
Copy Markdown
Contributor

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 Add MCP tools to list published posts and read their LinkedIn stats app#2399); checks run locally: pnpm docs:check, pnpm test, pnpm type-check, pnpm lint.

Written for commit 2a4808f. Summary will update on new commits.

View guided diff Turn on auto-fix

Tracking: recoupable/app#2399

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Nov 17, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Nov 18, 2026 3:21am UTC

Request Review

@coderabbitai

coderabbitai Bot commented Nov 17, 2026

Copy link
Copy Markdown

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Copy link
Copy Markdown
Contributor Author

Preview check on docs-oo6zckwjr-recoup.vercel.app, built from 90ebc19 (this PR's head). CI: check, build, cli-guide, test pass.

Done-when Result
pnpm docs:check, pnpm test, pnpm type-check, pnpm lint Pass locally and in CI
Preview page shows "Published posts and stats" Pass: /raw/mcp-server.md renders the section after "Social scrapes and posts", with the pending link to api#1246 and working links to List posts and Get post stats

Kept as draft; not merging.


Generated by Claude Code

Regenerate content/docs/manifest.json with pnpm docs:build to resolve the
conflict with main's CLI guide changes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants