# Online.PR MCP Server

The official [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for [Online.PR](https://online.pr) — the global platform for PR agencies, press release distribution, and media placements.

Connect any AI agent to search PR agencies, browse publications, order press release distribution, request quotes, and submit press releases.

## Quick Start

### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "online-pr": {
      "command": "npx",
      "args": ["-y", "online-pr-mcp"]
    }
  }
}
```

That's it. No API key needed for search and discovery.

### Other MCP Clients

```bash
npx online-pr-mcp
```

## Available Tools

| Tool | Description |
|------|-------------|
| `search_pr_agencies` | Search PR agencies by city, country, industry, service, or keyword |
| `get_agency_details` | Get full agency profile with services, pricing, ratings |
| `search_publications` | Find media outlets for PR placements by DA, price, category |
| `get_publication_details` | Publication pricing, domain authority, turnaround time |
| `browse_pr_packages` | Press release distribution packages with pricing |
| `get_pr_package_details` | Package features and pricing details |
| `get_agency_rankings` | Top-ranked PR agencies by country or industry |
| `request_quote_from_agency` | Submit a quote request to a PR agency |
| `order_publication_placement` | Get checkout link for a media placement |
| `order_pr_package` | Get checkout link for press release distribution |
| `submit_press_release` | Submit a press release to the Online.PR newsroom |

## Example Queries

Once connected, ask your AI:

- *"Find me a PR agency in Dubai for healthcare"*
- *"What publications can I buy for tech PR placements under $200?"*
- *"Show me press release distribution packages"*
- *"Get a quote from Edelman for a product launch"*
- *"Submit a press release for my company"*

## API Access

All search/browse endpoints are **public** — no API key needed:

```
GET https://online.pr/api/mcp/agencies?city=London&industry=Technology
GET https://online.pr/api/mcp/publications?min_da=50&max_price=500
GET https://online.pr/api/mcp/pr-packages
GET https://online.pr/api/mcp/rankings?country=United+States
```

Write operations (quotes, orders, submissions) require an API key via `X-MCP-Key` header.

## Integration

- **OpenAPI Spec**: https://online.pr/openapi.json
- **MCP Discovery**: https://online.pr/mcp.json
- **AI Plugin**: https://online.pr/ai-plugin.json
- **Full Data**: https://online.pr/llms-full.txt

## Environment Variables

| Variable | Default | Description |
|----------|---------|-------------|
| `APP_URL` | `https://online.pr` | Platform URL |
| `MCP_API_KEY` | *(empty)* | API key for write operations |

## License

MIT