Webalza MCP — run your outreach from your own agent

Connect Claude, Codex, Cursor, or any MCP-capable agent to your Webalza workspace. Your agent can create and manage LinkedIn and email campaigns, work the leads CRM, triage the inbox, manage audiences and templates, and answer questions about your subscription, credits and usage — without you opening the dashboard.

Connect Your Agent Mate docs

What it costs

MCP usage itself is free — your agent brings its own model, so you pay your provider for its tokens, never a Webalza Mate fee. Platform mechanics still apply as if you clicked the buttons yourself: real campaign sends, website redesigns and other credit-bearing actions consume plan credits, and plan abilities decide which tools you see.

Quickstart

Every MCP client connects to the same streamable-HTTP endpoint:

Server URL

https://server.webalza.com/api/mcp

Set up Claude

OAuth — no keys to store

Claude Code (terminal)

Run the command, then start Claude Code. It discovers Webalza's OAuth setup automatically and opens the consent screen once — tokens refresh on their own from then on.

claude mcp add --transport http webalza https://server.webalza.com/api/mcp

Claude on the web & desktop

Go to Settings → Connectors (claude.ai/customize/connectors), choose Add custom connector, and paste the server URL. Approve the Webalza consent screen and the connector appears in new chats.

Custom connector URL

https://server.webalza.com/api/mcp

Set up Codex

OAuth or API key

CLI

The first command registers the server; the second runs the OAuth sign-in against Webalza's consent screen.

codex mcp add webalza --url https://server.webalza.com/api/mcp
codex mcp login webalza

Or edit ~/.codex/config.toml

~/.codex/config.toml

[mcp_servers.webalza]
url = "https://server.webalza.com/api/mcp"

# Or authenticate with an API key instead of OAuth:
bearer_token_env_var = "WEBALZA_API_KEY"

Set up OpenCode

OAuth or API key

Add the server to opencode.json

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "webalza": {
      "type": "remote",
      "url": "https://server.webalza.com/api/mcp",
      "enabled": true
    }
  }
}

Or skip OAuth and use an API key header instead (next step).

opencode mcp auth webalza

API key alternative

"webalza": {
  "type": "remote",
  "url": "https://server.webalza.com/api/mcp",
  "enabled": true,
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  }
}

Set up Antigravity

API key

Open the MCP config

In the agent side panel click … → MCP Servers → Manage MCP Servers → View raw config. The file lives at ~/.gemini/config/mcp_config.json (or per-workspace at .agents/mcp_config.json).

Add Webalza (remote servers use serverUrl)

mcp_config.json

{
  "mcpServers": {
    "webalza": {
      "serverUrl": "https://server.webalza.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Set up Cursor

OAuth

Add the server

.cursor/mcp.json (project) or ~/.cursor/mcp.json (global)

{
  "mcpServers": {
    "webalza": {
      "url": "https://server.webalza.com/api/mcp"
    }
  }
}

Enable and sign in

Open Cursor Settings → Tools & MCP, enable Webalza, and approve the Webalza consent screen when Cursor opens it. Cursor discovers the OAuth details from the server automatically.

Set up ZCode

API key

Create an API key first

Dashboard → Connect Your Agent → API Keys. The key is shown once — copy it into the config below.

Add the server

~/.zcode/cli/config.json (user) or <repo>/.zcode/config.json (workspace)

{
  "mcp": {
    "servers": {
      "webalza": {
        "type": "http",
        "url": "https://server.webalza.com/api/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
}

Confirm the connection

Check Settings → MCP in ZCode — Webalza should show as connected for new sessions.

Set up Command Code

API key

Point it at the endpoint

Command Code takes the standard MCP client config — a server entry with the streamable-HTTP URL and your key in the Authorization header:

{
  "mcpServers": {
    "webalza": {
      "url": "https://server.webalza.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Set up Any agent

OAuth or API key

If your client supports OAuth for remote MCP servers

Add the server URL below as a remote MCP server. Webalza publishes the standard discovery documents (RFC 9728), so capable clients sign in without any manual setup — you just approve the consent screen.

Streamable-HTTP endpoint

https://server.webalza.com/api/mcp

Everything else — the mcp-remote bridge

Any client that can launch a local MCP server can talk to Webalza through mcp-remote, which forwards your API key as a header:

API key via mcp-remote

{
  "mcpServers": {
    "webalza": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://server.webalza.com/api/mcp",
        "--header",
        "Authorization: Bearer ${WEBALZA_API_KEY}"
      ]
    }
  }
}

A first prompt to try

Paste this once you're connected:

Connect to my Webalza workspace and show my active campaigns,
the number of unread inbox threads, and my remaining credits.

Supported clients

Claude (web, desktop & Code), Codex, OpenCode, Google Antigravity, Cursor, ZCode, Command Code, ChatGPT connectors, Windsurf — and any client speaking the MCP Streamable-HTTP transport (stateless, JSON responses). Plan-gated tools (LinkedIn/email campaigns, website redesigns) only appear on plans that include them.

Tool reference

70 tools across 10 domains. Live-action tools perform real sends, launches or spend credits — good clients ask before running them.

Account & billing

What your subscription includes, what it costs, and what you have left.

get_subscription

Your plan, price, billing cycle, renewal date, auto-renew state and everything it includes (abilities and limits).

get_credit_balance

Plan + top-up credit pools, the total spendable balance, and recent credit movements.

get_mate_usage

How much of the in-dashboard Mate assistant was used today and this month, and when the windows reset.

Sending accounts

The LinkedIn and email accounts that do the sending.

list_connected_accounts

List sending accounts with connection status and daily limits.

set_account_daily_limit Live action

Change how many actions a sending account may perform per day.

disconnect_account Live action

Disconnect a sending account — every campaign using it pauses automatically.

get_account_connect_url

Get a hosted link to connect or reconnect a sending account (the user signs in).

Analytics

Workspace-wide numbers and email events.

dashboard_stats

Workspace totals: leads, emails sent, replies, active campaigns.

get_deliverability_summary

30-day email deliverability: delivery, open, click and bounce rates.

get_growth_timeseries

Daily growth trend of new leads plus email engagement over up to 90 days.

get_email_activity

Raw email events (sent, opened, clicked, bounced, replied) for the workspace or one campaign.

Audience lists

Recipient lists for email campaigns.

get_audience_summary

Live member count and composition of an audience list (top companies, titles, countries).

list_audiences

List audience lists usable as email campaign recipients.

add_lead_to_audience

Add an existing lead to an audience list.

import_csv_attachment Live action

Bulk-import rows from an attached CSV/Excel file into leads or an audience.

create_audience

Create a new audience list.

remove_lead_from_audience

Remove a lead from an audience list (the lead record itself stays).

list_audience_leads

Page through an audience's members with full profile fields.

Automations

Workflow automations, lead forms and notifications.

list_automations

List workflow automations with live/paused status and their triggers.

pause_automation Live action

Stop a workflow automation until resumed.

resume_automation Live action

Resume a paused workflow automation.

list_lead_forms

List lead-capture forms.

list_notifications

List in-app notifications, newest first.

Campaigns

Create, inspect and manage LinkedIn and email outreach campaigns.

list_campaigns

List campaigns with status, channel and progress.

get_top_performing_campaigns

Your best past campaigns ranked by reply and open rate, with detail to inform new ones.

get_campaign_report

Full performance report for one campaign: audience funnel and email KPIs.

review_linkedin_campaign plan: linkedin campaign

Everything needed to review a LinkedIn campaign: targeting, sequence, schedule, settings.

review_email_campaign plan: email campaign

Everything needed to review an email campaign: steps, schedule, sending profiles, analytics.

find_search_filter_options plan: linkedin campaign

Resolve names to LinkedIn audience filter options (locations, companies, roles…).

search_linkedin_people plan: linkedin campaign

Run a LinkedIn people search and preview the matching audience — nobody is added yet.

create_email_campaign plan: email campaign

Create a complete, launch-ready email campaign draft — nothing is sent.

create_linkedin_campaign plan: linkedin campaign

Create a complete, launch-ready LinkedIn campaign draft — nothing is sent.

duplicate_campaign

Duplicate an existing campaign as a new draft.

start_campaign Live action

Launch a campaign now, or schedule the launch for a specific moment.

pause_campaign Live action

Pause a running campaign.

resume_campaign Live action

Resume a paused campaign — pending leads re-queue where they left off.

start_website_redesign Live action plan: website redesign

Start website redesigns for up to 5 URLs (spends credits).

test_send_email Live action

Send a real test email of a campaign draft's first step to one address.

sync_linkedin_audience Live action plan: linkedin campaign

Run the campaign's saved LinkedIn filters and attach the matched people to it.

reset_linkedin_targeting_history Live action plan: linkedin campaign

Clear the 'already contacted' history of one LinkedIn sending account.

update_campaign_settings Live action

Change a campaign's caps, action spacing, send windows, warm-ups and exclusions.

update_sequence_step Live action

Edit one step of a campaign sequence: body, subject, delay, redesign or reply handling.

add_sequence_step Live action

Append a follow-up step to a campaign sequence.

remove_sequence_step Live action

Remove a step from a campaign sequence (at least one must remain).

apply_sequence_edits Live action

Batch-edit a sequence in one action: rewrite, translate, re-tone, adjust delays, remove steps.

list_merge_tokens

Every personalization merge tag and which channel or step supports it.

Inbox

The unified LinkedIn + email inbox.

list_conversations

Search the unified inbox across LinkedIn and email.

triage_inbox

Classify recent inbound replies into 8 categories so the right conversation gets answered first.

get_conversation_thread

Fetch one conversation's recent message history, oldest to newest.

draft_reply

Propose a reply grounded in the thread and the lead's profile — nothing is sent.

reply_to_lead Live action

Send a real reply in an inbox conversation (LinkedIn message or email).

mark_conversation_read

Mark a conversation as read.

Leads (CRM)

The lead database and pipelines.

get_lead

One lead's full CRM profile: contact, company, status, engagement, campaign membership.

research_lead

Deep-research a lead: CRM profile plus live LinkedIn data for personalization.

update_lead

Update a lead's interest or lifecycle status, or append notes.

search_leads

Full-text and filtered search across the lead database.

create_lead

Create a lead record (the email must not exist yet).

set_lead_labels

Replace a lead's tags with a new list.

list_pipelines

List sales pipelines and their stages.

move_lead_stage

Attach a lead to a pipeline stage, or move them between stages.

Web research

Live web lookups the agent can ground its work in.

web_search

Search the live web for real-time information.

read_web_page

Pull the readable text of up to 3 public web pages.

find_lead_email Live action

Find a person's work email via treg (credits charged only when a verified email is found).

lookup_social_profiles Live action

Look up a person's social presence (LinkedIn, X, GitHub, Instagram, YouTube, TikTok) via treg.

Templates

Reusable copy and email designs.

list_message_templates

List saved message templates for a platform and kind.

create_message_template

Save a new reusable message template.

update_message_template

Update a message template's name, subject, body or order.

list_email_templates

List saved email design templates.

create_email_template

Save a new reusable email design template (HTML).

update_email_template

Update an email design template's name, category, subject or body.

FAQ

Does using the MCP server cost Mate credits?

No. Mate's message-based usage and its costs only apply to the in-dashboard assistant. Over MCP your agent does the reasoning and you pay your own model provider — Webalza charges nothing for the connection or the tool calls.

What does 'Live action' mean on some tools?

Those tools perform real actions — launching a campaign, sending a reply, disconnecting an account, spending credits. The MCP protocol lets your client ask you for approval before each such call; keep that on.

Why don't I see the LinkedIn campaign tools?

Tools are filtered by your plan's abilities. LinkedIn campaigns require the linkedin_campaign ability, email campaigns the email_campaign ability, and website redesigns the website_redesign ability. Upgrade or switch plans to unlock them.

How do I revoke an agent's access?

Delete its API key under Dashboard → Connect Your Agent → API Keys (instant), remove the connection under Dashboard → Connect Your Agent → Connections, or revoke the OAuth tokens from your agent's connected-apps settings.

Is my data safe?

Credentials are stored only as hashes, every tool call is scoped to your own account, and destructive operations mirror the same guards the dashboard uses. The consent screen shows exactly which client is asking before you approve.

Previous WebAlza Mate

All docs

Get started