Skip to main content

RevyOps MCP Server

Connect Claude to your RevyOps outbound campaign data using the Model Context Protocol.

Quick Start

1. Install uv (if you don't have it)

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Get your API key

Log in to RevyOps and go to Settings > API Keys to create one.

3. Add to Claude Desktop

Open your Claude Desktop config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following (merge into your existing config if you have other MCP servers):

{
  "mcpServers": {
    "revyops": {
      "command": "uvx",
      "args": ["revyops-mcp"],
      "env": {
        "REVYOPS_API_KEYS": "RO-your-key-here"
      }
    }
  }
}

For multiple workspaces, comma-separate your keys:

{
  "env": {
    "REVYOPS_API_KEYS": "RO-key-for-client-a, RO-key-for-client-b"
  }
}

4. Restart Claude Desktop

The RevyOps tools will appear automatically. Ask Claude things like:

  • "Show me campaign performance for last month"
  • "Which campaigns have the highest reply rate?"
  • "Find contacts at acme.com"
  • "What's our deliverability looking like?"

Available Tools

Tool Description
list_clients List available workspaces
get_campaigns Campaign performance metrics
get_campaign_drilldown Individual contacts/companies in a campaign
get_email_thread Full email thread with a contact
get_deliverability Sending domain health metrics
get_campaign_stats High-level campaign statistics
get_contacts_stats Contact-level aggregate stats
get_variable_report_variables Available A/B tracking variables
get_variable_report A/B test report by tracking variables
add_campaign_note Add/update a campaign note
archive_campaign Archive or unarchive a campaign
search_contacts Search contacts by email, name, domain
get_contact Full contact details
update_contact Update contact fields
search_companies Search companies by domain or name
get_company Full company details
update_company Update company fields
search_emails Search email records
mark_email_interested Flag an email as interested

Environment Variables

Variable Required Description
REVYOPS_API_KEYS Yes Comma-separated API keys
REVYOPS_API_URL No API base URL (default: https://app.revyops.com)

Metadata

Release files for revyops-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for revyops-mcp 0.1.0
File Size Uploaded
revyops_mcp-0.1.0.tar.gz 8.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for revyops-mcp 0.1.0
File Interpreter ABI Platform
revyops_mcp-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 17.6 kB

Release files / revyops_mcp-0.1.0.tar.gz

Download URL revyops_mcp-0.1.0.tar.gz
Size 8.2 kB
Tags Source
SHA-256 checksum
How to use checksums
b8bfe323b3aeb886b10e104329bd4f2f814846eeda5899197e1afd7f0fbc41a1
BLAKE2b-256 checksum
How to use checksums
815b84f9c0f616b06cccdd7b7ab0c376223a04efee6027dcb206c88cb56d7cb5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.24 {"installer":{"name":"uv","version":"0.9.24","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / revyops_mcp-0.1.0-py3-none-any.whl

Download URL revyops_mcp-0.1.0-py3-none-any.whl
Size 9.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5a247bd652e34f7c1e1e1694a36ffa3a3c731e8a6955523b57c3922484befc95
BLAKE2b-256 checksum
How to use checksums
192d7b5aaa0a2a7257e778d0424128ce3a55110c02b1a1e665db795629f3db5a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.24 {"installer":{"name":"uv","version":"0.9.24","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page