AI Tool Integration (MCP)

• Search your Dataset — run semantic searches across every record your Watchers have indexed, with filters for source, freshness, and relevance
• Browse the feed — pull full record details including title, body, author, subreddit, and engagement counts
• Manage Watchers — list, create, and update the Watchers that decide which channels Prowlo crawls into your Dataset
• Track keywords across all of Reddit — create keyword Watchers that search all of Reddit for a query, checked daily
• Read live Reddit and Hacker News — fetch posts, comments, and search results in real time for context your Dataset hasn't captured yet
• Tag records — manage tagging rules that label records in your Dataset, or tag a single record by hand
• Set up Alerts and Trends — get notified in Slack or a webhook when something matches, and chart volume over time

• A Prowlo account with an active plan
• An MCP client: Claude, Claude Code, VS Code, Zed, Cursor, Cline, or Windsurf
• An API key only if you are not using OAuth — headless environments, or a client with no OAuth support (how to create one)

Every client below connects straight to the hosted endpoint — nothing runs on your machine. Where a config shows YOUR_API_KEY, you can usually drop the whole headers block instead and let the client prompt you to sign in with OAuth.

Claude Desktop

Open your config file at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or via Settings → Developer → Edit Config.

{
  "mcpServers": {
    "prowlo": {
      "url": "https://api.prowlo.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code

Two commands, no API key. See the full Claude Code guide.

claude mcp add --transport http -s user prowlo https://api.prowlo.com/mcp
claude mcp login prowlo

For headless environments, skip the login and pass a key instead:

claude mcp add --transport http -s user prowlo https://api.prowlo.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Add to your .cursor/mcp.json file:

{
  "mcpServers": {
    "prowlo": {
      "url": "https://api.prowlo.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Windsurf

Add to your ~/.codeium/windsurf/mcp_config.json file:

{
  "mcpServers": {
    "prowlo": {
      "url": "https://api.prowlo.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code

One command adds Prowlo to your user profile. VS Code opens a browser to sign in the first time the server is used — see the full VS Code guide.

code --add-mcp '{"name":"prowlo","type":"http","url":"https://api.prowlo.com/mcp"}'

Or edit .vscode/mcp.json directly — note the top-level key is servers, not mcpServers:

{
  "servers": {
    "prowlo": {
      "type": "http",
      "url": "https://api.prowlo.com/mcp"
    }
  }
}

Zed

Use Settings → AI → MCP Servers → Add Server → Add Remote Server, or add it to settings.json. Omitting the headers block is what triggers Zed's OAuth flow — see the full Zed guide.

{
  "context_servers": {
    "prowlo": {
      "url": "https://api.prowlo.com/mcp"
    }
  }
}

Every client above talks to https://api.prowlo.com/mcp directly. If you are on an older client that only speaks stdio, bridge it with mcp-remote (requires Node.js 18+). This is a shim on your side only — Prowlo is still fully hosted, and there is nothing to run or maintain.

{
  "mcpServers": {
    "prowlo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.prowlo.com/mcp"]
    }
  }
}

The MCP server exposes these tools to your AI assistant. Every connection signs in with OAuth or an API key.

Dataset & Feed

• search_dataset — run a semantic search across every record in your Dataset, with filters for source, freshness, and relevance
• list_records — browse the most recent records your Watchers have indexed
• get_record — pull a single record's full details: title, body, author, subreddit, and engagement counts
• get_record_comments — fetch the live comment thread for a record (up to 100 per call, plus the current comment count); comments aren't stored, so it's a snapshot of the thread right now
• get_dataset_summary — get a live overview of your Dataset: record counts, sources, and recent activity

Subreddit catalog

Research communities before watching them — the same data behind the free tools at prowlo.com/tools. Cached, free, no credits.

• catalog_search_subreddits — semantic search over Prowlo's ~1,200-community catalog: describe a product or audience, get ranked matches with subscribers, activity, growth, and promo tolerance
• catalog_get_subreddit — one community's full stat card (growth, posting cadence, promo tolerance) plus similar communities by content and by shared audience
• catalog_top_subreddits — the largest, most-active, and fastest-growing tracked communities, filterable by size band

Research

• research_get — read the Community research report Prowlo prepares for your workspace, section by section: summary, communities by tier, content that wins, competitors, voice of customer, the plan, or the full markdown.

Live Reddit & Hacker News

Real-time reads for context your Dataset hasn't captured yet. One platform parameter picks Reddit or Hacker News. Each call is 1 live-read credit, capped daily.

• social_search — live full-text search of a source
• social_list_posts — list a subreddit's posts, or a Hacker News ranking
• social_get_post — one post or story with its comment thread (up to 100 comments per call; commentOffset pages the rest)
• social_get_user / social_get_user_activity — a user's profile and recent posts and comments
• social_find_channels — search for subreddits live, or read one subreddit's metadata and rules

Watchers & Keyword Monitor

• list_watchers — list the Watchers that decide which channels Prowlo crawls into your Dataset, with each Watcher's channel and tags
• watcher_create — add Watchers (one channel each). Pass tags to label every record the Watcher ingests — the same chips shown in the dashboard
• watcher_update — pause or resume a Watcher, or replace its tags
• watcher_delete / watcher_remove_source — delete a Watcher, or remove one source from it
• keyword_monitor_list / keyword_monitor_create — list or add Keyword Monitor entries that search all of Reddit daily (3 on trial, 20 on the paid plan — the Keywords page in the dashboard). Pause or delete them with watcher_update / watcher_delete

Tagging

Tagging rules label records your Watchers already ingest — they don't search Reddit. Manage them from your AI assistant, no need to switch to the dashboard.

• tag_rule_list — list tagging rules with active status and match statistics
• tag_rule_create — add a rule, or several in one call (plan limits apply)
• tag_rule_update — rename a rule, describe what it refers to, or pause/resume it
• tag_rule_delete — permanently remove a rule
• tag_record — hand-tag one record (no rule, no effect on future posts)

Alerts & Trends

• alert_list / alert_create / alert_update / alert_delete — manage Alerts that fire on new matching records and deliver to Slack or a webhook
• alert_get_deliveries — see what an Alert matched and where it was sent
• trend_list / trend_get — read Trends and their time series (sparse: missing buckets mean zero)
• trend_create / trend_update / trend_delete — manage Trends

Product profile & account

• get_product_profile / update_product_profile — read or update the product context Prowlo's research builds on
• get_account — your organization, plan, and connected integrations (Slack, webhooks)
• get_usage — today's live-read and comment-read usage, caps, and reset time
• get_crawl_activity — recent crawl runs with fetched, matched, and new counts
• get_operational_alerts — Prowlo's own failures: errored crawl runs and failed webhook deliveries (not your Alerts)

Once connected, try asking your AI assistant:

• "Search my Dataset for posts about pricing complaints"
• "Summarize the latest records from r/SaaS"
• "What's in my Dataset right now? Give me a summary"
• "Find records that mention switching away from a competitor"
• "List my Watchers and which subreddits they cover"
• "Find subreddits where small SaaS teams complain about analytics pricing, check which are active, and watch the best three"
• "How big is r/selfhosted, is it growing, and what are its neighbors?"
• "Add a Watcher for r/devops"
• "Track 'CRM alternative' across all of Reddit and tag it competitor"
• "Show me my tags and how they're performing"
• "Add a tag for 'project management frustration'"
• "Pull the live Reddit comments for this post"