Docs/AI tools (MCP)/MCP setup

Connect Your AI Agent to Prowlo

Prowlo's MCP server gives your AI agent direct access to your Dataset and live Reddit — semantic search, typed JSON, read-only. The easiest way is a one-URL custom connector in Claude (sign in with OAuth, no API key); other tools connect with an API key.

Works with Claude

Claude

Claude Code Cursor

Cursor

Cline

Windsurf

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI agents talk to external services through one typed interface. Instead of copying data between tabs, your agent queries Prowlo directly and gets clean, structured results back.

With Prowlo's MCP server, Claude, Cursor, Cline, and any MCP-speaking client get filtered, ranked Reddit access — semantic search over a curated dataset plus live Reddit lookups — as typed JSON the agent can reason over. No raw HTML, no scraping, no Reddit API credentials. It's read-only: your agent reads, you decide what to do.

Easiest: add Prowlo as a custom connector

The simplest way to connect — no API key, no config file, no restart. In Claude, add Prowlo as a custom connector and sign in with your browser:

https://api.prowlo.com/mcp

1.Open Settings → Connectors → Add custom connector.
2.Paste the URL above and click Add.
3.Click Connect and sign in to Prowlo in the browser window (OAuth).

When to use this

Custom connectors require a paid Claude plan (Pro, Max, or Team) — this is the recommended path for Claude. For Claude Code, Cursor, Cline, Windsurf, or free Claude, use the API-key method below.

Prerequisites (API-key method)

•A Prowlo account (the 14-day trial includes full MCP access)
•An API key ( learn how to create one)
•One of the supported clients: Claude Desktop, Claude Code, Cursor, Cline, or Windsurf

Connect with an API key (other tools)

Create an API Key

a.Go to API Access in your Prowlo dashboard
b.Click Generate Key
c.Copy your key (starts with prowlo_)

Add the Config

Paste this into your client's MCP settings (the exact location depends on the tool — see the per-tool guides below):

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

Replace YOUR_API_KEY with the key you just copied.

Restart Your Client

a.Fully quit your client (don't just minimize it)
b.Reopen it — Prowlo's tools load automatically
c.Try asking: "What is r/MachineLearning saying about vector databases this week?"

Claude Cowork

In Claude Cowork, use the custom connector method above — paste https://api.prowlo.com/mcp, click Connect, and sign in with OAuth. No API key, no JSON, no restart.

One-click marketplace listing is coming

A fully-listed Prowlo connector — connectable in one click from Claude's directory — ships once it clears Anthropic's review. Until then, the custom-connector URL above gets you the same OAuth experience today.

Tool-Specific Guides

Claude Desktop

Add Prowlo in Claude Desktop’s developer config.

Claude Code

One command to register Prowlo in Claude Code.

Cursor

Enable Prowlo in Cursor’s MCP settings.

Windsurf

Configure Prowlo in Windsurf’s Cascade panel.

Available Tools

Once connected, your agent has these tools. You never call them by name — you ask in plain English and the agent composes the calls. All Reddit content is read-only.

Semantic dataset

search_dataset

Search a curated Reddit corpus by meaning. Every record carries a vector embedding, so the agent gets the handful of posts that actually match — ranked, typed JSON, not a thousand raw threads.

list_records · get_record · get_dataset_summary

List and filter records, fetch a single record by ID, summarize what's in the dataset, or pull your matched feed.

Live sources

social_search · social_list_posts · social_get_post

Search a source live, list a channel or ranking, and pull a post/story with its comment thread. One platform parameter selects Reddit or Hacker News — same tools, typed JSON, read-only.

social_get_user · social_get_user_activity · social_find_channels

Read a user's profile and recent activity, or discover/inspect channels (Reddit subreddits). Each call is 1 credit.

Watchers & keywords

Manage what Prowlo tracks for you, straight from your agent — no switching to the dashboard.

list_watchers · keyword_list

See your active watchers and tracked keywords, with match counts and last-match timestamps.

keyword_create · keyword_update · keyword_delete

Add a tracked term (new keywords backfill recent matches), pause a noisy one, or remove it. Plan limits apply.

Trends & alerts

trend_list · trend_get

Read time-series on volume and activity for the topics you track.

alert_list · alert_create · alert_update · alert_delete

Create and manage alerts — e.g. ping Slack whenever a brand or keyword is mentioned on Reddit.

What You Can Ask

"What is r/MachineLearning saying about vector databases this week?"

"Pull this thread and its comments so I can summarize the pain points."

"Find people describing the problem my product solves and summarize the recurring pain points."

"Alert me in Slack whenever "Acme" gets mentioned on Reddit."

"What are the rules and recent activity in r/SaaS, r/startups, and r/Entrepreneur?"

"Show me what changed in my watched topics over the last 7 days."

"Add "Sanity alternative" as a tracked keyword and pause "CMS" — too noisy."

Your agent handles the rest — composing the calls, reasoning over your Dataset and live Reddit, and coming back with something you can use. Prowlo is read-only: it reads and serves data; any action you take stays in your hands.

Ready to Connect?

Generate a key, paste the config, restart your client. If you run into issues, check our troubleshooting guide.

Generate an API Key API Key Guide

← Help Center Claude Desktop →