ProductClank MCP Server (com.productclank/productclank)

ProductClank provides an MCP server for running community growth actions from an AI assistant. The server supports boosting posts and launching community content campaigns, including drafting social content into a pipeline, with OAuth 2.1 authentication and credit-based billing.

🛠️ Key Features

Launch community growth campaigns from an AI assistant
Boost posts with real replies, likes, and reposts
Draft social content into your own pipeline
Remote server endpoint: https://mcp.productclank.com/mcp (Streamable HTTP)
Auth: OAuth 2.1 using a ProductClank account (sign in and revoke anytime)
Billing: credit-billed via ProductClank credits
Tool count: 8

🚀 Use Cases

Boost a specific post using community engagement actions
Launch content campaigns that draw from real communities (and their agents)
Feed drafted social content into an existing pipeline

⚡ Developer Benefits

Single MCP server integration for multiple social/engagement actions
OAuth 2.1 support for delegated access from MCP clients

⚠️ Limitations

Access and operations depend on ProductClank OAuth authentication
Usage is constrained by ProductClank credit billing

ProductClank MCP Server

Launch community growth campaigns from your AI assistant. ProductClank turns real communities (and their agents) into a distribution network — this MCP server lets Claude, ChatGPT, or any MCP client rally that network on your behalf: boost a post with real replies, likes, and reposts; launch community content campaigns; draft social content into your own pipeline.

Remote server: https://mcp.productclank.com/mcp (Streamable HTTP)
Auth: OAuth 2.1 — sign in with your ProductClank account, revoke anytime
Billing: your ProductClank credits, per-tool costs shown below, with per-app daily spend caps
Website: productclank.com/mcp

The same URL works in both Claude and ChatGPT — the only difference is where each app hides its "add a connector" screen (and, for ChatGPT, a plan/Developer-mode requirement). Once connected, both drive the identical tools below.

Connect from Claude

In Claude, go to Settings → Connectors → Add custom connector (Desktop or web).
Paste the URL:
code
```
https://mcp.productclank.com/mcp
```
Approve the OAuth prompt — it signs you into ProductClank (Google or email) and asks for consent.
Ask Claude things like:

"Boost this post with replies from the ProductClank community: https://x.com/…" "Preview a content campaign for my product." "What's my ProductClank credit balance?"

Connect from ChatGPT

ChatGPT reaches custom MCP connectors through Developer mode.

Requirements — Custom connectors need a paid ChatGPT plan (Pro, Plus, Business, Enterprise, or Education) on the web app. They are not available on the free tier, so free-tier users won't see an "add connector" option — this is a ChatGPT limitation, not a ProductClank one.

In ChatGPT on the web, open Settings → Apps & Connectors → Advanced settings and turn on Developer mode.
Back in Apps & Connectors, click Create / Add custom connector.
Give it a name (e.g. ProductClank), a short description, and the MCP server URL:
code
```
https://mcp.productclank.com/mcp
```
Choose OAuth as the authentication method and connect — it signs you into ProductClank (Google or email) and asks for consent, exactly like Claude.
In a chat, enable the ProductClank connector and ask it to boost a post, preview a campaign, or check your balance.

Works in any MCP client that supports remote servers with OAuth (Claude web/desktop, Claude Code, ChatGPT Developer mode, and others).

Tools

Grow — run growth campaigns for a product

Tool	What it does	Cost
`search_products`	Resolve your ProductClank products to a `product_id`	free
`create_product`	List a product from just its website URL (token-free listing, auto-filled)	free
`create_campaign`	Create a discovery campaign: continuously find relevant posts + draft community replies	10 cr
`run_research` / `get_research`	Topic & competitor analysis — the free pre-flight before spending	free
`generate_posts`	Run discovery: scrape matching posts and draft a reply for each	12 cr/post
`list_campaigns` / `get_campaign` / `get_posts`	Campaign inventory, config + stats, discovered posts & drafts	free
`review_posts`	AI-score posts against relevancy rules, prune the irrelevant (dry-run billed too)	2 cr/post
`regenerate_replies`	Redraft selected replies with an edit request	5 cr/reply
`get_campaign_activity`	What's new since the last check — posts found, replies claimed, live links to what went out	free
`get_campaign_results`	Spend vs outcomes: the funnel, approval + survival rates, cost per usable reply	free
`update_campaign`	Merge keywords, enable the discovery sources research found, move the relevance bar, pause/resume, re-aim the platform targeting, change who posts the drafts	free
`set_campaign_schedule`	Put discovery on a schedule so it keeps finding conversations between sessions. Shows the projected daily cost and requires an explicit yes before enabling	free to set · 12cr per post found
`add_delegate`	Hand a campaign to a human to manage in the web app	free
`boost_post`	Rally the community to engage a specific post — 10 AI-drafted replies (200 cr), 10 AI-drafted quote posts (200 cr, X only — a repost with each member's own text, landing in their followers' feeds), 30 likes or 10 reposts (300 cr). Auto-detects platform from the URL: X, Instagram, TikTok, LinkedIn, Reddit, Farcaster, YouTube	200–300 cr

Earn — participate in campaigns for the connected user

Tool	What it does	Cost
`find_opportunities`	Browse unclaimed reply and quote-post drafts the user can post to earn (likes and reposts need a screenshot and stay in the web app)	free
`submit_participation`	Submit the posted reply's URL (X, Reddit, YouTube, LinkedIn) — attributed to the user's linked handle for that platform, then points/credits are awarded	earns
`find_open_campaigns`	Discover content & take-action campaigns the user can join — public ones plus their communities'	free
`get_campaign_brief`	Read a campaign's full brief: what to create or do, judging criteria, rewards, deadline, remaining allowance	free
`submit_campaign_work`	Submit the user's work: a content or action-proof URL, a hosted image/video made for the task (`media_url` — links only, no uploads), and/or a description. X posts are author-verified. Pending → owner review → Stars/points	earns
`get_my_submissions`	Track submission status + the reviewer's notes	free
`get_earnings`	The user's participation totals: points, credits, reply stats	free

Content Studio

Tool	What it does	Cost
`suggest_content_campaign`	AI-drafted preview of a community content campaign (title, description, CTA) + affordability check. Nothing is created	free
`create_content_campaign`	Launch the content campaign: the community creates posts/threads/videos for your product; submissions and winner selection happen in the web app	1,000 cr
`list_content_spaces`	List the content spaces you can draft into	free
`get_content_workspace`	The brand's calibration — voice, platforms, post types, playbook, topic inventory, style guides. Read it before drafting	free
`setup_content_space`	Turn content on for a brand from an onboarding chat (pair with the `setup_content_space` prompt): voice, platforms, post types, topics — can create a solo space for the brand. Also updates settings later	free by fields · 5 cr for a pasted brand doc
`manage_content_topics`	The inventory of aspects the brand talks about: list / add / update / remove / suggest	free
`write_content_candidates`	Draft up to 25 posts into the space, in the calibrated voice. They are auto-scored by the reviewer and wait in the queue for the user's approval; nothing auto-publishes	free
`get_content_queue`	The queue as the user sees it: each draft with its score, verdict, and the reviewer's one-line fix	free
`revise_content_draft`	Approve (`stage`), drop (`discard`), edit, or nudge a draft with a one-click preset — shorter, longer, punchier, deeper, simpler, more_specific, less_salesy, more_casual, more_formal — or a typed note; `fix` / `humanize` / `review`	stage · discard · edit free; rewrites & review 2 cr
`teach_content_voice`	Turn a reaction into a standing rule in the brand's voice KB so every future draft honors it	1 cr

Credits

Tool	What it does	Cost
`check_balance`	Your credit balance and plan	free
`credit_history`	Your credit transactions (spend + rewards), newest first	free

The server also exposes two MCP prompts — grow_product, a ready-made operating procedure for the growth loop, and setup_content_space, the Content Studio onboarding interview (brand → audience → tone → example posts → platforms → post types → topics, then first drafts and the approve / tweak / teach loop) — and a resource — productclank://capabilities, the tool/cost roster — so agents can plan spend before calling anything.

Costly actions are designed to be confirmed with the user first — tool descriptions instruct the model to preview and state the credit cost before spending.

How auth & billing work

The server is an OAuth 2.1 authorization server backed by the ProductClank web app (/connect/mcp login + consent). Every /mcp request requires a valid access token; tools act as the connected user and bill that user's credit balance. Users can see and revoke the connector — and set a daily credit spend cap per connected app — from their ProductClank profile ("Connected Apps").

Communication contract

Tool results are read by an assistant, not by the person paying the credits, so anything the user must know or decide travels in the payload:

user_note — one or two plain sentences for the assistant to relay.
decision_offer — a real choice (question + options with what_happens and cost + current + how_to_apply) for the assistant to present, never to answer on the user's behalf.

The main one is distribution: campaigns are created private (drafts wait in the owner's workbench) and the result offers community distribution — the reach the platform exists for — as an explicit, costed choice. Spends get the same treatment: suggest_content_campaign returns the 1000-credit launch as a yes/no, and a review_posts dry run says what it already cost and what the next step actually changes.

Telemetry

The server emits three PostHog events — mcp_connected (OAuth consent completed), mcp_tool_called (every tool, with ok and duration_ms) and mcp_tool_error (failures, with the message) — so the connect → first-call → repeat-use funnel is measurable and refused calls double as roadmap signal. Events are keyed to the user's Supabase auth id where resolvable, so connector activity joins the same PostHog person as their webapp activity. Capture is fire-and-forget and the whole thing no-ops without POSTHOG_API_KEY. See src/lib/analytics.ts; tools are instrumented centrally in src/tools/instrument.ts.

Architecture

A thin Express + @modelcontextprotocol/sdk wrapper over ProductClank's public agent REST API (/api/v1/agents/*). The REST API is canonical; this server and the ProductClank agent skill are parallel wrappers — capabilities.json is the parity source of truth and CI fails when they drift (npm run check:parity).

code

Claude / MCP client ──▶ mcp.productclank.com/mcp (this server)
                          │  OAuth 2.1 AS ──▶ productclank.com/connect/mcp (login + consent)
                          └─▶ ProductClank agent REST API (/api/v1/agents/*)

Development

bash

cp .env.example .env   # fill in (see DEPLOYMENT.md)
npm install
npm run dev            # tsx watch
npm run typecheck
npm run build && npm start

See DEPLOYMENT.md for production deployment (Docker / Railway) and CAPABILITIES.md for the tool roadmap.

Operations

When a release depends on new app-repo behavior, deploy the app repo first; tools must degrade gracefully against the older API.

Registry

Published to the official MCP Registry as com.productclank/productclank — see server.json.

License

MIT

query	string	required	Product name or keyword to search for
limit	integer	optional	Max results (default 5)

url	string	optional	Product website URL — auto-fills the listing. Provide this or `name`.
name	string	optional	Product name. Optional if `url` is given (extracted from the site); required otherwise.
tagline	string	optional	One-line value proposition (optional; overrides extracted).
description	string	optional	Short description of what the product does (optional).
website	string	optional	Canonical website, if different from `url` (optional).
twitter	string	optional	X/Twitter handle or profile URL (optional).
logo	string	optional	Logo image URL (optional; otherwise auto-resolved from the site).
category	array	optional	Category tags (optional).

post_url	string	required	Full URL of the post to boost (any supported platform)
product_id	string	optional	Optional product UUID (from search_products or create_product). Omit for a tweet-first boost.
action_type	string	optional	How the community engages. Default: replies. Reposts are Twitter/Farcaster only.
reply_guidelines	string	optional	Optional guidance for the tone and content of community replies

product_id	string	required	Product UUID from search_products
campaign_message	string	required	The core brief: what you want the community to create (e.g. 'Share how you use <product> in your daily workflow').
campaign_goals	array	optional	Campaign goals, e.g. ["awareness", "signups"]
target_audience	string	optional	Who the campaign should reach
preferred_platform	string	optional	Preferred platform, e.g. "x" or "farcaster"
additional_guidelines	string	optional	Extra do's/don'ts for creators
references	string	optional	Links or references to include in the campaign

product_id	string	required	Product UUID from search_products
campaign_message	string	required	The core brief: what you want the community to create (e.g. 'Share how you use <product> in your daily workflow').
campaign_goals	array	optional	Campaign goals, e.g. ["awareness", "signups"]
target_audience	string	optional	Who the campaign should reach
preferred_platform	string	optional	Preferred platform, e.g. "x" or "farcaster"
additional_guidelines	string	optional	Extra do's/don'ts for creators
references	string	optional	Links or references to include in the campaign

ProductClank