Prowlo — Reddit & X for AI agents

Prowlo — Reddit, Hacker News & more for your AI agent

[License: MIT] [MCP Registry]

Social research for AI agents — research that runs 24/7. Prowlo is a hosted MCP server. Watchers collect new posts from Reddit and Hacker News (plus Mastodon, RSS and X), and your agent searches them by meaning from Claude, Cursor or any MCP client.

https://api.prowlo.com/mcp

Website · Setup guide · Pricing · Free 14-day trial, then $19/month

• Memory, not a one-off peek. Watchers keep collecting while your laptop is closed, so your agent can look back at last week or last month.
• Search by meaning. Ask for "people frustrated with their CRM" and get those posts, not just exact keyword hits.
• Live reads when you need them. Pull a Reddit or Hacker News post or comment thread right now.
• Prowlo is read-only. It never posts, comments or votes.
• No setup. Sign in with OAuth. No Reddit API keys, no config files for most clients.

Contents

• Connect in 30 seconds
• What you can ask
• Tools
• Sources
• Limits & pricing
• Privacy & security
• Support
• About this repository

Connect in 30 seconds

Every client connects to the same hosted endpoint. OAuth is the recommended path: no API key to copy, store or rotate.

Claude (web, Desktop, mobile)

1. Open Customize → Connectors → Add custom connector.
2. Paste https://api.prowlo.com/mcp and click Add.
3. Click Connect and sign in to Prowlo.

On Claude's Free plan you can add one custom connector. On Team and Enterprise, an org Owner adds it. If that blocks you, Claude Code, Cursor and VS Code connect per user over the same endpoint.

Claude Code

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

Then run /mcp inside Claude Code, pick prowlo and choose Authenticate. Add -s user to the first command to make Prowlo available in every project.

Claude Code plugin with skills: github.com/prowlo-com/prowlo-plugin

Cursor

Add to ~/.cursor/mcp.json (or Settings → MCP → Add new server). Cursor opens a browser window to sign in.

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

VS Code

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

Windsurf and Cline

Windsurf (~/.codeium/windsurf/mcp_config.json) signs in with OAuth when there is no headers block:

{  "mcpServers": {    "prowlo": { "serverUrl": "https://api.prowlo.com/mcp" }  }}

Cline (cline_mcp_settings.json) and other clients that need a key: create an API key in your Prowlo settings and send it as a header. Cline needs "type": "streamableHttp"; without it, Cline falls back to the legacy SSE transport.

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

Any other client (stdio bridge)

For clients that only speak stdio, bridge to the hosted server with mcp-remote (Node.js 18+). It runs a small local shim; the server is still the hosted one.

npx mcp-remote https://api.prowlo.com/mcp

Ready-to-copy config files for each client are in examples/.

What you can ask

Once connected, just ask your agent:

• "Watch r/SaaS and r/startups, and add a keyword monitor for 'GummySearch alternative' across all of Reddit."
• "Search my Prowlo records from the last 30 days for discussions about tracking Reddit mentions. Summarize the main points with links."
• "Which subreddits are best for indie SaaS founders, and what are their posting rules?"
• "What are people on Hacker News saying about running LLMs locally this week? Read the top thread and summarize the main arguments."
• "Create an alert that sends new posts mentioning our brand to Slack."
• "Set up a daily trend for mentions of our competitor and show me how it changed this month."
• "Pull the most common complaints about our competitor from my records and quote the exact wording people used."
• "Tag every post that mentions pricing as pricing, then list the tagged posts from this week."

Tools

Prowlo exposes 43 tools. Read tools never change anything. Write tools change only your own Prowlo setup (Watchers, Alerts, Trends, tags, profile), never anything on Reddit or X. Every tool carries MCP readOnlyHint / destructiveHint annotations, so clients can ask before running a write.

Dataset

Your own indexed posts, collected by your Watchers. Free, rate-limited only.

Live reads

Real-time Reddit and Hacker News reads. Metered: 1 credit each, daily cap.

Catalog

Prowlo's directory of ~1,200 tracked subreddits. Free, not metered.

Watchers & Keyword monitors

What Prowlo collects into your Dataset.

Alerts & Trends

Saved queries that notify you or chart a topic over time.

Tagging

Your own labels on collected posts. These do not search Reddit.

Account & usage

Research

Full API reference: https://prowlo.com/docs/api-reference

Sources

Each Watcher follows one source. When your agent creates a Watcher, it sets the platform to one of:

New posts are collected on an hourly schedule and become searchable by meaning. Keyword Monitors search all of Reddit once a day.

Limits & pricing

Free 14-day trial, no card to start. Then $19/month (or $190/year).

The plan includes:

• 25 Watchers, each checked hourly
• 20 Keyword Monitors across all of Reddit (3 during the trial)
• 200 live reads per day (50/day during the trial)
• 10 Alerts + Trends and 3 webhook destinations
• MCP, REST and webhooks

What counts against a limit:

• Live reads (social_* tools) use 1 credit each, against a daily cap.
• Record comment threads (get_record_comments) have their own daily cap.
• Your records, the catalog and research reports are not metered, only rate-limited.

Ask your agent to run get_usage to see today's usage and when it resets. Current details: https://prowlo.com/pricing.

Privacy & security

• Read-only. Prowlo never posts, comments or votes on any platform.
• No platform credentials. You never hand over a Reddit or X login or API key.
• OAuth sign-in. Your client signs in to your Prowlo account through a browser. The API key is only a fallback for clients that need one.
• Revocable. Disconnect in your client, or revoke under Settings → Connected Apps in your Prowlo account (admins).
• Scoped to your account. Your Watchers, records, Alerts and tags belong to your organization.

Responsible use. Don't use Prowlo to build profiles of individuals or track specific people.

Read the Privacy Policy and Terms of Service.

Support

• Email: [email protected]
• Setup guide: https://prowlo.com/docs/mcp-setup
• Bugs or doc fixes for this repo: open an issue

About this repository

This repository holds documentation, connection examples and registry manifests only. It contains no server code and there is nothing to install or run: Prowlo is a hosted service at https://api.prowlo.com/mcp.

The Claude Code plugin with skills lives in its own repository: github.com/prowlo-com/prowlo-plugin.

License

The MIT License covers the documentation and examples in this repository. The Prowlo service itself is proprietary and is governed by the Terms of Service.