Marvenn

Marvenn MCP Server

The Marvenn MCP Server exposes the Marvenn AI-powered outreach and CRM platform to any MCP-compatible client (Claude Desktop, Continue, Cursor, etc.).

Connect your AI assistant to Marvenn and let it list campaigns, inspect leads, manage pending agent actions, and more — all through natural language.

---

Authentication

API key is optional for discovery (tools/list, prompts/list, resources/list). API key is required for executing tools (tools/call). Pass your key as a Bearer token: Authorization: Bearer <your-marvenn-api-key>

API keys are scoped. The scope granted to your key determines which tools are available:

Scope	Description
read	Read-only access to campaigns, leads, actions, and agents
write	Everything in read, plus creating campaigns and approving/rejecting actions
admin	Everything in write, plus user management and credit operations (also requires your Marvenn account role to be admin or super_admin)

Generate or manage your API keys from your account settings at marvenn.ai.

---

Transport

Transport	URL	Status
Streamable HTTP (recommended)	https://marvenn.ai/mcp	Working
SSE	https://marvenn.ai/mcp/sse	Working

---

Quick Start

Claude Desktop

Add the following to your claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "marvenn": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://marvenn.ai/mcp/sse",
        "--header",
        "Authorization: Bearer <your-marvenn-api-key>"
      ]
    }
  }
}

Restart Claude Desktop. You should see the Marvenn tools available in the tools panel.

curl

Open the SSE stream in one terminal:

curl -N \
  -H "Authorization: Bearer <your-marvenn-api-key>" \
  https://marvenn.ai/mcp/sse

The server responds with an endpoint event that provides a session-specific message URL, for example:

event: endpoint
data: https://marvenn.ai/mcp/sse/message?sessionId=mcp_1234567890_abc12345

Send a JSON-RPC message to that endpoint in a second terminal:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your-marvenn-api-key>" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}' \
  "https://marvenn.ai/mcp/sse/message?sessionId=mcp_1234567890_abc12345"

The result is delivered back over the open SSE stream.

---

Tools

list_campaigns — Read scope

List all campaigns for the authenticated user. Returns campaign name, status, creation date, and basic stats.

Parameter	Type	Required	Description
status	string	No	Filter by status: active, paused, completed, draft
limit	number	No	Max results to return (default 20, max 100)

---

get_campaign_stats — Read scope

Get detailed analytics and performance stats for a specific campaign.

Parameter	Type	Required	Description
campaign_id	number	Yes	Numeric ID of the campaign

---

create_campaign — Write scope

Create a new outreach campaign.

Parameter	Type	Required	Description
name	string	Yes	Campaign name (max 200 characters)
type	string	Yes	Campaign type: email, phone, social, multi_channel
targetAudience	string	No	Description of the target audience
objective	string	No	Campaign objective or goal

---

list_leads — Read scope

List leads in the CRM with optional filtering and pagination.

Parameter	Type	Required	Description
status	string	No	Filter by lead status: new, contacted, qualified, converted, lost
search	string	No	Search term matched against name, email, or company
limit	number	No	Max results per page (default 20, max 100)
page	number	No	Page number, 1-indexed (default 1)

---

list_pending_actions — Read scope

List all pending actions awaiting your approval.

Parameter	Type	Required	Description
limit	number	No	Max results to return (default 20)

---

approve_action — Write scope

Approve or reject a pending action that requires human authorization.

Parameter	Type	Required	Description
action_id	number	Yes	Numeric ID of the pending action
decision	string	Yes	approve or reject
notes	string	No	Optional notes or reason for the decision

---

list_agents — Read scope

List all AI agents for the authenticated user.

Parameter	Type	Required	Description
limit	number	No	Max results to return (default 20)

---

list_users — Admin scope

List all users on the platform. Requires admin scope and an admin account role.

Parameter	Type	Required	Description
limit	number	No	Max results to return (default 50, max 500)
subscriptionTier	string	No	Filter by tier: free, startup, team

---

manage_credits — Admin scope

View or adjust the credit balance for any user. Requires admin scope and an admin account role.

Parameter	Type	Required	Description
target_user_id	string	Yes	ID of the user whose credits to manage
action	string	Yes	get, add, or subtract
amount	number	Required for add/subtract	Number of credits to add or subtract
reason	string	Required for add/subtract	Reason for the adjustment

---

Error Handling

All errors are returned as JSON-RPC error objects with the following codes:

Code	Meaning
-32600	Invalid JSON-RPC request
-32601	Method or tool not found
-32602	Invalid arguments
-32603	Internal server error

Scope errors (e.g. calling create_campaign with a read-only key) are returned as a tool result with an error field in the response body, not as a JSON-RPC protocol error.

---

Links

• Website: https://marvenn.ai
• MCP Protocol: https://modelcontextprotocol.io