docs(facebookadsmcp): add Facebook Ads MCP connector documentation

[ravibits]

Adds AgentKit connector documentation for Facebook Ads MCP (Meta's official Ads MCP Server), covering 95 tools across catalog management, campaign/ad management, signals & datasets, A/B tests & Conversion Lift, reporting, activity logs, and help/troubleshooting.

Stub disclosure: _setup-facebookadsmcp.mdx has auth-type-specific setup steps auto-generated for bring-your-own OAuth 2.1 with PKCE (Meta's DCR endpoint rejects DCR registration despite advertising support, so this connector requires a manually registered Meta OAuth app). Still needs: (a) screenshots replacing {/* TODO: add screenshot ... */} markers, and (b) verification of the provider-specific navigation steps replacing {/* TODO: add provider-specific steps ... */} markers (Meta's app dashboard layout changes periodically). _section-after-setup-facebookadsmcp-common-workflows.mdx needs workflow examples added (cloned stub only, left for human review).

Preview link: https://deploy-preview-937--scalekit-starlight.netlify.app/agentkit/connectors/facebookadsmcp/

Test plan

• Open the preview link and verify the page renders.
• Tool list shows 95 tools.
• Replace {/* TODO: add screenshot ... */} markers in _setup-facebookadsmcp.mdx.
• Review the setup steps for connector-specific accuracy (Meta app dashboard navigation).

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: e5e5cda0-0b2e-4703-ac94-caf504d05739

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

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

_{Comment @coderabbitai help to get the list of available commands.}

[netlify]

✅ Deploy Preview for scalekit-starlight ready!

Name	Link
🔨 Latest commit	ff1d8cb
🔍 Latest deploy log	https://app.netlify.com/projects/scalekit-starlight/deploys/6a751a72b10b220007bd4af9
😎 Deploy Preview	https://deploy-preview-937--scalekit-starlight.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
Lighthouse	1 paths audited Performance: 78 (🟢 up 22 from production) Accessibility: 100 (no change from production) Best Practices: 92 (no change from production) SEO: 92 (no change from production) PWA: - View the detailed breakdown and full score reports
🤖 Make changes	Run an agent on this branch

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[saif-at-scalekit]

Status: not ready to merge

This connector is not live in production. A production sync will not pick it up yet.

What I checked

Latest scalekit-inc/tool-agent main (3009f993, 15 Aug — Seismic connector):

• No providers/facebookadsmcp folder
• No file on main mentions facebookadsmcp

The connector exists only on a draft branch:

• scalekit-inc/tool-agent#487 — Add Facebook Ads MCP connector with 95 tools
• State: open draft, not merged
• Last update: 6 Aug

That branch has the provider JSON and 95 tools. coming_soon is false in the JSON. The branch is still not on main.

A second, unrelated Facebook draft also exists: tool-agent#486 (16 tools). Also not merged.

Why this docs PR is still open

1. Draft — CodeRabbit skipped review for that reason.
2. CONFLICTING with main — 15 commits behind. Later connector syncs rewrote catalog.ts and the template index.
3. Unfinished setup copy — TODO markers remain for screenshots, Meta console steps, and workflow examples.
4. No human review — GitHub still says review required.
5. Blocked on tool-agent — docs cannot ship a live connector page until tool-agent#487 lands.

pnpm run sync-agent-connectors is not the missing step. The last production sync (#951, 14 Aug) already ran. It added Twitter OAuth / Bearer. It did not add Facebook Ads MCP, because the provider was not on tool-agent main.

A later production sync still would not write the hand-authored _setup-facebookadsmcp.mdx or workflow section. Those files are unique to this PR.

To merge later

1. Merge tool-agent#487 so the connector is live.
2. Rebase this branch onto main.
3. Replace the TODO stubs, or mark the remaining gaps as known.
4. Mark the PR ready for review and get a review.