The audience layer for AI agents.
Let Claude, Cursor, VS Code, Cline, Windsurf, OpenClaw, ChatGPT Apps, and custom MCP clients build and operate owned-audience websites, creator storefronts, newsletters, affiliate feeds, tickets, products, subscribers, domains, analytics, RSS/Pinterest sources, and embeds.
Build Linktree, Shopify, Substack, Gumroad, ShopMy/LTK, Eventbrite/Luma, and creator websites — but owned — from a prompt in ~45 seconds.
Docs · API Reference · Templates · OpenClaw Skill · Featured examples
npm install -g @doomscrollr/mcp-server
- “Build me a site.”
- “Make me a Linktree.”
- “Launch a merch/product drop.”
- “Turn these ShopMy/LTK links into a storefront.”
- “Sell tickets for this event.”
- “Start a newsletter.”
- “Capture subscribers from this app/site.”
- “Turn this RSS feed into a website.”
- “Make a Pinterest growth site.”
Remote MCP (recommended)
Use the hosted Streamable HTTP MCP endpoint when your client supports remote MCP:
https://mcp.doomscrollr.com/mcp
Authorization: Bearer <DOOMSCROLLR_API_KEY>
Get a free API key from Dashboard → Settings → API keys:
https://doomscrollr.com/register?free=1&utm_source=github&utm_medium=readme&utm_campaign=developer_funnel&utm_content=mcp_get_api_key
Claude Desktop / local MCP clients
{
"mcpServers": {
"doomscrollr": {
"command": "npx",
"args": ["-y", "@doomscrollr/mcp-server"],
"env": {
"DOOMSCROLLR_API_KEY": "your_api_key_here"
}
}
}
}
Restart your client and ask: “What DOOMSCROLLR tools do you have?”
Cursor / VS Code / Cline / Windsurf
Use the remote endpoint where supported, or the stdio config above. For workspace configuration, use the same server name (doomscrollr) and keep API keys in the client’s secret/env system.
Recommended docs:
All tools are namespaced doomscrollr_*.
| Risk | Tools / categories | Notes |
|---|
| Read-only | get_profile, get_settings, list_posts, list_products, list_subscribers, top_liked_posts, get_embed_code, domain_status, integration status tools | Safe for inspection and analytics. |
| Write / draft-safe | publish_post, publish_polymarket_post, publish_image_post, create_page, create_contact_page, create_product, add_subscriber, RSS/Pinterest connect/search tools | Prefer draft or explicit confirmation when publication timing is unclear. publish_post asks DOOMSCROLLR to repair/fetch preview metadata first and reports a clear error instead of creating broken published posts. |
| Destructive | delete_post, delete_product, remove_subscriber, bulk delete tools, disconnect integration/domain tools | Ask for explicit confirmation before calling. |
| Payment/domain-sensitive | buy_domain, price/inventory/subscription changes, checkout-related product edits | Requires explicit user approval. |
| Category | Tools |
|---|
| Build-me flows | build_linktree, build_komi, build_shopify, build_ecommerce, build_substack, build_newsletter, build_website, build_social_feed, build_membership |
| Account/settings | create_world, get_profile, get_settings, update_settings, apply_style_preset, prepare_user_questions |
| Posts/pages | publish_post, publish_polymarket_post, publish_image_post, post_shopmy_products, list_posts, update_post, delete_post, create_page, create_contact_page |
| Commerce | create_product, list_products, scrape_shopify_products, import_shopify_products, update_product, delete_product, bulk product tools |
| Storefront imports | scrape_shopify_products, scrape_gumroad_products, scrape_payhip_products, scrape_bandcamp_products, scrape_bigcartel_products, scrape_url_products (auto-detect) and matching import_*_products |
| Audience | add_subscriber, update_subscriber, list_subscribers, remove_subscriber, export_audience_csv, bulk subscriber tools |
| Domains | search_domains, connect_domain, disconnect_domain, buy_domain, domain_status |
| Pinterest/RSS | search_pinterest, search_pinterest_and_post, connect_pinterest, pinterest_status, disconnect_pinterest, connect_rss, rss_status, disconnect_rss |
| Analytics/integrations | top_liked_posts, get_embed_code, get_zapier_templates, get_n8n_templates |
Example prompts
Build me a Linktree, but owned. Use my brand colors and add subscriber capture.
Turn these ShopMy links into draft affiliate recommendation posts and preserve commission URLs.
Scrape https://labananita.com and import the first 20 Shopify/compatible product-feed products as DOOMSCROLLR products.
Before importing this Shopify catalog or compatible product JSON feed, ask me whether I want products, posts, or both.
Create a $50 product drop from this image with S/M/L/XL variants. Keep it draft until I approve.
Connect this RSS feed and import the latest 10 posts as drafts.
Show me my top liked posts from the last 30 days and suggest what to publish next.
REST API, CLI, and automations
Use MCP when an agent is directly doing the work. Use REST/OpenAPI for apps and workflow automation.
Environment variables
| Variable | Required | Description |
|---|
DOOMSCROLLR_API_KEY | yes for stdio | Your API key from the dashboard |
DOOMSCROLLR_API_BASE | no | Override the API base, defaults to https://doomscrollr.com/api/v1 |
PORT | no | Port for the remote HTTP server |
HOST | no | Host bind for the remote HTTP server, default 0.0.0.0 |
MCP_ALLOWED_ORIGINS | no | Comma-separated CORS origins for the remote HTTP server, default * |
OAUTH_TOKEN_SECRET | yes in production | Secret used to sign OAuth client IDs and tokens. Required when NODE_ENV=production. |
OAUTH_ISSUER | no | Public authorization-server issuer, default https://mcp.doomscrollr.com |
OAUTH_REGISTRATION_ACCESS_TOKEN | no | If set, POST /oauth/register requires Authorization: Bearer <token>. Leave unset for ChatGPT/Claude/Cursor Dynamic Client Registration. |
OAUTH_CREDENTIALS_SHARED_SECRET | no | If set, credential exchange sends X-Doomscrollr-OAuth-Internal to POST /api/v1/oauth/credentials. Must match the same env var on the DOOMSCROLLR app. |
OAUTH_TRUSTED_REDIRECT_HOSTS | no | Extra comma-separated hosts treated as first-party MCP callbacks |
OAUTH_STRICT_REDIRECT_HOSTS | no | If 1, reject registration and authorization for callbacks outside the trusted-host list |
Development
npm install
npm run build
DOOMSCROLLR_API_KEY=*** node dist/index.js
PORT=3000 npm run start:http
Test with the MCP Inspector:
npx @modelcontextprotocol/inspector node dist/index.js
Security and privacy
- API keys are provided by the user and must stay in the client secret/env system.
- The MCP server should not log API keys or request bodies.
- Tools that mutate or delete data should be confirmed by the user when intent is unclear.
- Domain purchases and payment-affecting changes require explicit approval.
- MCP OAuth keeps Dynamic Client Registration available for ChatGPT/Claude/Cursor. Client IDs are signed and bound to registered redirect URIs, PKCE S256 is required, and the consent screen shows the callback host. Rotating the account API key revokes outstanding MCP OAuth tokens.
License
MIT