[sweetmantech]

Before: the MCP server page lists tool families but says nothing about scraping an artist's socials, reading a scrape run, or listing an artist's posts from MCP.

After: a "Social scrapes and posts" section on mcp-server.mdx documents scrape_artist_socials, get_scraper_results and get_artist_posts: their inputs, outputs, credit cost ($0.05 per started profile plus $0.01 per requested post), and that they are available to API-key and full mcp:tools connections but not the limited mcp:read/mcp:write grant. The section is marked pending until recoupable/api#1243 deploys.

How: authored in content/docs/source/mcp-server.mdx; manifest.json and llms-full.txt regenerated with pnpm docs:build. content/docs/contracts/mcp-inventories.json is pinned to an API commit, so it is refreshed only after api#1243 merges.

Checks run locally: pnpm docs:build, pnpm docs:check, pnpm test (154 tests) and pnpm lint pass.

Merge order: this PR first, then recoupable/api#1243.

Tracking: recoupable/app#2396 (the chat repo)

---

Generated by Claude Code

---

Summary by cubic

Documents the scrape_artist_socials, get_scraper_results, and get_artist_posts MCP tools in a new "Social scrapes and posts" section on the MCP server docs page.

• Covers each tool's inputs, outputs, and credit cost ($0.05 per started profile plus $0.01 per requested post), mirroring the REST endpoints.
• Notes the tools work with API-key and mcp:tools connections but not mcp:read/mcp:write grants.
• Documents that when every linked profile fails to start, the call returns a tool error and nothing is charged.
• Section is marked pending until feat(mcp): add scrape_artist_socials, get_scraper_results, get_artist_posts tools api#1243 deploys; this PR merges first, then the API release.
• Regenerates manifest.json and llms-full.txt via pnpm docs:build.

^{Written for commit 37578fa. Summary will update on new commits.}

[vercel]

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

Project	Deployment	Actions	Updated
docs	Ready	Preview	Nov 13, 2026 2:13pm UTC

[coderabbitai]

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

• X
• Mastodon
• Reddit
• LinkedIn

[sweetmantech]

Preview verification (docs-git-docs-mcp-social-scrape-posts-tools-recoup.vercel.app, 69f42aa)

Rendered /mcp-server on the PR preview (Vercel status success for 69f42aa7) in a headless browser at 1440x900 (dark + light) and 390x844 (light).

Check	Expected	Actual
New section renders	## Social scrapes and posts after Release Packs	renders, anchor #social-scrapes-and-posts
On-this-page TOC	lists the new section	listed last, after Release Packs
Three tools documented	scrape_artist_socials, get_scraper_results, get_artist_posts with inputs, outputs, cost, grant availability	all three present; inputs/outputs match api#1243 a23eae9 tool schemas; $0.05/profile + $0.01/post; excluded from limited mcp:read/mcp:write
Inline links	resolve	/api-reference/artist/socials-scrape 200, /api-reference/apify/scraper 200, /api-reference/posts/get 200, api#1243 200
Inline code / bullets wrap	no overflow	no horizontal scroll at 390px (scrollWidth 390 = viewport)
Light + dark	readable in both	both readable; code chips contrast OK

Drift found: api#1243 2b67e270 is not documented

api#1243's latest commit (2b67e270, "return a tool error when scrape_artist_socials starts no run") makes scrape_artist_socials return a tool error, No scrape runs started: <reasons>. No credits were charged., when every linked profile fails to start. The closing paragraph here lists only access errors, an unknown artist and insufficient credits. It needs that case added before merge. This also gets checked when api#1243 is re-verified on 2b67e270 with a real Apify run.

Screenshots

Desktop, dark: page top with new TOC entry

Desktop, dark: section

Desktop, light: section

Mobile 390px, light: section start / end

---

Generated by Claude Code