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 — fetch posts, comments, and search results straight from Reddit for context your Dataset hasn't captured yet
• Tag records — list, create, update, and delete keyword tags that label records in your Dataset

• 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", "@anthropic-ai/mcp-remote", "https://api.prowlo.com/mcp"]
    }
  }
}

The MCP server exposes these tools to your AI assistant:

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_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

Watchers & Live Reddit

• list_watchers — list the Watchers that decide which channels Prowlo crawls into your Dataset, with each Watcher's channels and tags
• watcher_create / watcher_update — add or edit Watchers; use platform reddit_search to add a keyword that searches all of Reddit daily (3 on trial, 20 on the paid plan — the Keyword Monitor page in the dashboard). Pass tags on create (or replace them via watcher_update) to label every record the Watcher ingests — the same chips shown in the dashboard
• reddit_* — read live Reddit (posts, comments, search) for context your Dataset hasn't captured yet

Tagging

Manage the keyword tags that label records in your Dataset, entirely from your AI assistant — no need to switch to the dashboard.

• keyword_list — list all tags with active status, match counts, and last match timestamps
• keyword_create — add a tag, or several in one call via keywords (2-100 characters each, plan limits apply)
• keyword_update — activate or pause a tag without deleting its match history
• keyword_delete — permanently remove a tag and all its match history

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"