# marvenn-mcp

Marvenn MCP Server

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add dan-wkkx/marvenn-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list dan-wkkx/marvenn-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get dan-wkkx/marvenn-mcp list_campaigns

# Call a tool
npx -y @smithery/cli@latest tool call dan-wkkx/marvenn-mcp list_campaigns '{}'
```

## Direct MCP Connection

Endpoint: `https://marvenn-mcp--dan-wkkx.run.tools`

**Required config:**
- `apiKey` (header) — Your Marvenn API key --> Marvenn settings. Must include the Bearer prefix — e.g. Bearer mvn_xxxxxx

## Tools (9)

- `list_campaigns` — List all campaigns for the authenticated user. Returns campaign name, status, creation date, and basic stats.
- `get_campaign_stats` — Get detailed analytics and performance stats for a specific campaign by ID.
- `create_campaign` — Create a new outreach campaign. Requires write scope.
- `list_leads` — List leads in the CRM. Supports filtering by status, search term, and pagination.
- `approve_action` — Approve or reject a pending action that requires human authorization. Requires write scope.
- `list_pending_actions` — List all pending actions awaiting approval for the authenticated user.
- `list_agents` — List all AI agents for the authenticated user.
- `list_users` — List all users on the platform. Requires admin scope and admin user role.
- `manage_credits` — View or adjust credit balance for a user. Requires admin scope and admin user role.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get dan-wkkx/marvenn-mcp <tool-name>
```