
Social research for AI agents. Hosted MCP server for Reddit, Hacker News & more. OAuth, read-only.
Social research for AI agents. Hosted MCP server for Reddit, Hacker News & more. OAuth, read-only.
·
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/mcpWebsite · Setup guide · Pricing · Free 14-day trial, then $19/month
Every client connects to the same hosted endpoint. OAuth is the recommended path: no API key to copy, store or rotate.
https://api.prowlo.com/mcp and click Add.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 mcp add --transport http prowlo https://api.prowlo.com/mcpThen 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
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" }
}
}code --add-mcp '{"name":"prowlo","type":"http","url":"https://api.prowlo.com/mcp"}'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" }
}
}
}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/mcpReady-to-copy config files for each client are in examples/.
Once connected, just ask your agent:
pricing, then list the tagged posts from this week."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.
Your own indexed posts, collected by your Watchers. Free, rate-limited only.
| Tool | What it does | Access |
|---|---|---|
search_dataset | Search your collected posts by meaning or keyword, with filters for community, platform, date, score, tags and more | Read |
list_records | List records in your Dataset with the same filters, page by page | Read |
get_record | Fetch one record with its full body and tags | Read |
get_record_comments | Fetch the current comment thread for a record (live, own daily cap) | Read |
get_dataset_summary | Record count, last update, busiest channels and today's live-read usage | Read |
Real-time Reddit and Hacker News reads. Metered: 1 credit each, daily cap.
| Tool | What it does | Access |
|---|---|---|
social_search | Search Reddit or Hacker News right now | Read |
social_list_posts | List a subreddit's posts or Hacker News stories (hot, new, top, ...) | Read |
social_get_post | Fetch one post or story with its comment thread | Read |
social_get_user | Public profile of an account in a thread you're reading (Reddit or Hacker News) | Read |
social_get_user_activity | Recent public posts or comments of an account in a thread you're reading | Read |
social_find_channels | Find subreddits, or get one subreddit's details and rules | Read |
Prowlo's directory of ~1,200 tracked subreddits. Free, not metered.
| Tool | What it does | Access |
|---|---|---|
catalog_search_subreddits | Find subreddits by topic | Read |
catalog_get_subreddit | Size, activity, growth, self-promotion tolerance and similar communities for one subreddit | Read |
catalog_top_subreddits | Rank subreddits: largest, most active or fastest growing | Read |
What Prowlo collects into your Dataset.
| Tool | What it does | Access |
|---|---|---|
list_watchers | List your Watchers, their sources, tags and status | Read |
watcher_create | Start watching a subreddit, Hacker News, a Mastodon or RSS feed, an X account, or a Reddit-wide search query | Write |
watcher_update | Pause or resume a Watcher, or replace its tags | Write |
watcher_delete | Delete a Watcher and its records | Write |
watcher_remove_source | Remove a source from a Watcher | Write |
keyword_monitor_list | List your Keyword Monitors and keyword quota | Read |
keyword_monitor_create | Search all of Reddit daily for a query and collect the matches | Write |
get_crawl_activity | Recent collection runs: new posts, matches, errors | Read |
Saved queries that notify you or chart a topic over time.
| Tool | What it does | Access |
|---|---|---|
alert_list | List your Alerts and their delivery stats | Read |
alert_create | Get a Slack or webhook notification when new posts match | Write |
alert_update | Change an Alert's query, destination, threshold or status | Write |
alert_delete | Delete an Alert | Write |
alert_get_deliveries | See what an Alert matched and where it was sent | Read |
trend_list | List your Trends | Read |
trend_get | Get a Trend's time series | Read |
trend_create | Track how often a topic comes up, by hour or day | Write |
trend_update | Change a Trend's query, interval or window | Write |
trend_delete | Delete a Trend | Write |
Your own labels on collected posts. These do not search Reddit.
| Tool | What it does | Access |
|---|---|---|
tag_rule_list | List your tagging rules | Read |
tag_rule_create | Create rules that label matching posts automatically | Write |
tag_rule_update | Rename or change a tagging rule | Write |
tag_rule_delete | Delete a tagging rule | Write |
tag_record | Add tags to one record | Write |
| Tool | What it does | Access |
|---|---|---|
get_account | Your organization, plan and connected Slack channels and webhooks | Read |
get_usage | Today's live-read usage, daily cap and reset time | Read |
get_operational_alerts | Failed collection runs and failed webhook deliveries | Read |
get_product_profile | Your product profile: description, audience, competitors | Read |
update_product_profile | Update your product profile | Write |
| Tool | What it does | Access |
|---|---|---|
research_get | Read your community research report: ranked subreddits with quoted evidence, competitors and voice of customer, if Prowlo has prepared one for your workspace | Read |
Full API reference: https://prowlo.com/docs/api-reference
| Source | Watch (collected into your records) | Live reads |
|---|---|---|
| Subreddits and keyword searches across all of Reddit | Yes | |
| Hacker News | Yes | Yes |
| Mastodon | Yes | — |
| RSS | Any feed | — |
| X | Accounts (paid plan) | — |
Each Watcher follows one source. When your agent creates a Watcher, it sets the platform to one of:
platform | Watches |
|---|---|
reddit | One subreddit (the default) |
reddit_search | A search query across all of Reddit, checked daily (a Keyword Monitor) |
hackernews | A Hacker News feed or query |
mastodon | A Mastodon hashtag or account feed |
rss | Any RSS or Atom feed |
x_user | One X account (paid plan only) |
New posts are collected on an hourly schedule and become searchable by meaning. Keyword Monitors search all of Reddit once a day.
Free 14-day trial, no card to start. Then $19/month (or $190/year).
The plan includes:
What counts against a limit:
social_* tools) use 1 credit each, against a daily cap.get_record_comments) have their own daily cap.Ask your agent to run get_usage to see today's usage and when it resets. Current details: https://prowlo.com/pricing.
Responsible use. Don't use Prowlo to build profiles of individuals or track specific people.
Read the Privacy Policy and Terms of Service.
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.
| File | Purpose |
|---|---|
server.json | Official MCP Registry entry (com.prowlo/reddit-x) |
plugin.json + mcp.json | Agent Plugins manifest and server config |
examples/ | Per-client connection configs |
The Claude Code plugin with skills lives in its own repository: github.com/prowlo-com/prowlo-plugin.
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.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add prowlo --transport http https://api.prowlo.com/mcp{
"mcpServers": {
"prowlo": {
"url": "https://api.prowlo.com/mcp"
}
}
}code --add-mcp '{"name":"prowlo","url":"https://api.prowlo.com/mcp"}'Runs as a hosted service. Your client connects over the network and nothing is installed locally.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/prowlo-mcp to learn what the "Prowlo Mcp" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add --transport http prowlo https://api.prowlo.com/mcpnpx mcp-remote https://api.prowlo.com/mcpThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: its endpoint did not list its tools to an anonymous client, which usually means it asks for an API key or a sign-in. The four checks that need a live server are left out, and the grade tops out at B until we can read its tools.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/prowlo-mcp)Nothing comparable is listed yet.
v1.1.0Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "prowlo-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.