open-index/open-npm huggingface dataset:
npm package: @prowlo/mcp-server
Description: MCP server for connecting AI tools to Prowlo opportunity feeds — browse Reddit opportunities, read engagement signals, and submit reply drafts from Claude, Cursor, or any MCP-compatible AI tool.
Author: Prowlo
Latest version: 0.1.0

# @prowlo/mcp-server

MCP server that connects AI tools to your [Prowlo](https://prowlo.com) account. Browse Reddit opportunities, read engagement signals, and submit reply drafts — all from Claude, Cursor, or any MCP-compatible AI assistant.

## What You Can Do

| Tool | Description |
|------|-------------|
| `list_opportunities` | Browse your opportunity feed — filter by freshness, score, and risk |
| `get_opportunity` | Get full post details, engagement signals, and guidance |
| `submit_draft` | Write a reply draft for review in the Prowlo web UI |
| `get_product_profile` | Read your product context — name, audience, tone, guidelines |

## Setup

### 1. Get Your API Key

Go to **Settings > API Keys** in your Prowlo dashboard and create a new key.

### 2. Install

```bash
npm install -g @prowlo/mcp-server
```

Or run directly with npx:

```bash
npx @prowlo/mcp-server
```

### 3. Configure Your AI Tool

#### Claude Desktop

Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):

```json
{
  "mcpServers": {
    "prowlo": {
      "command": "npx",
      "args": ["-y", "@prowlo/mcp-server"],
      "env": {
        "PROWLO_API_KEY": "pk_live_your_key_here"
      }
    }
  }
}
```

#### Claude Code

Add to your project's `.claude/settings.json` or global settings:

```json
{
  "mcpServers": {
    "prowlo": {
      "command": "npx",
      "args": ["-y", "@prowlo/mcp-server"],
      "env": {
        "PROWLO_API_KEY": "pk_live_your_key_here"
      }
    }
  }
}
```

#### Cursor

Add to your Cursor MCP settings (`.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "prowlo": {
      "command": "npx",
      "args": ["-y", "@prowlo/mcp-server"],
      "env": {
        "PROWLO_API_KEY": "pk_live_your_key_here"
      }
    }
  }
}
```

#### Windsurf

Add to your Windsurf MCP config (`~/.codeium/windsurf/mcp_config.json`):

```json
{
  "mcpServers": {
    "prowlo": {
      "command": "npx",
      "args": ["-y", "@prowlo/mcp-server"],
      "env": {
        "PROWLO_API_KEY": "pk_live_your_key_here"
      }
    }
  }
}
```

## Usage Examples

Once configured, ask your AI assistant:

- "Show me today's Reddit opportunities"
- "Find high-score opportunities from the last 3 days"
- "Get the details on opportunity X"
- "Draft a reply for this opportunity"
- "What's my product profile?"

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `PROWLO_API_KEY` | Yes | Your Prowlo API key (starts with `pk_live_`) |
| `PROWLO_API_URL` | No | Custom API URL (defaults to Prowlo production) |

## Requirements

- Node.js 20+
- A [Prowlo](https://prowlo.com) account with an active subscription

## License

Apache-2.0