DOOMSCROLLR MCP Server

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

Terminal

npm install -g @doomscrollr/mcp-server

Use DOOMSCROLLR when a user asks

“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:

text

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

config.json

{
  "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:

Coding agents: https://doomscrollr.com/docs/coding-agents.md
Integrations: https://doomscrollr.com/docs/integrations.md
Cookbook: https://doomscrollr.com/docs/cookbook.md
LLM summary: https://doomscrollr.com/llms.txt
Full LLM context: https://doomscrollr.com/llms-full.txt

Tool safety labels

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.

Selected tools

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

text

Build me a Linktree, but owned. Use my brand colors and add subscriber capture.

text

Turn these ShopMy links into draft affiliate recommendation posts and preserve commission URLs.

server.ts

Scrape https://labananita.com and import the first 20 Shopify/compatible product-feed products as DOOMSCROLLR products.

text

Before importing this Shopify catalog or compatible product JSON feed, ask me whether I want products, posts, or both.

text

Create a $50 product drop from this image with S/M/L/XL variants. Keep it draft until I approve.

server.ts

Connect this RSS feed and import the latest 10 posts as drafts.

text

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.

REST API: https://doomscrollr.com/api/v1
OpenAPI: https://doomscrollr.com/openapi.json
CLI/API SDK: https://www.npmjs.com/package/doomscrollr
REST SDK: https://www.npmjs.com/package/@doomscrollr/api
n8n node: https://www.npmjs.com/package/@doomscrollr/n8n-nodes-doomscrollr
n8n setup docs: https://doomscrollr.com/docs/n8n.md

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

Terminal

npm install
npm run build
DOOMSCROLLR_API_KEY=*** node dist/index.js
PORT=3000 npm run start:http

Test with the MCP Inspector:

Terminal

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