docs(mcp): document scrape_artist_socials, get_scraper_results, get_artist_posts

Draft
SW
7h ago
+59-1

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 recoupable/api#1243 deploys; this PR merges first, then the API release.
  • Regenerates manifest.json and llms-full.txt via pnpm docs:build.