Model Context Protocol

The Notifiva MCP Server

Your transactional email, one prompt away.

Connect Claude, Claude Code, Cursor or any MCP-compatible assistant to your Notifiva account. Send email, debug bounces and manage templates, domains, webhooks and suppressions — by asking in plain language.

Server URL https://api.notifiva.com/mcp

Connect your assistant Setup guide

31 toolsOAuth or API keyStreamable HTTPEvery plan

ai assistant — example

notifiva

Why didn’t [email protected] get her password reset yesterday?

✓ search_messages0.4s

q: "[email protected]", range: "24h"

1 result · bounced · 550 5.1.1 mailbox unavailable

✓ get_suppression0.2s

address: "[email protected]"

suppressed · hard-bounce · since 14:02

The reset was sent at 14:02 but hard-bounced — the receiving server says the mailbox doesn’t exist, so the address is now suppressed. Once Anna confirms the right address, I can lift the block and resend.

Works with any client that speaks MCP.

Claude

Claude Code

Cursor

VS Code

Windsurf Custom agents

01 — How it works

You ask. The assistant picks a tool. Notifiva does the work.

MCP is an open standard that lets an AI assistant call real tools on your behalf. Notifiva’s MCP server turns your account into a set of well-described tools, so the assistant can read your activity and act on it — inside the permissions you approved.

AI assistant

MCP server api.notifiva.com/mcp

Your account tools · 31

You ask

Describe the outcome in your own words — “find the bounce”, “add the domain”, “send a test”.

It chooses tools

The assistant reads the tool descriptions and decides which of the 31 to call, and with which arguments.

Notifiva acts

Calls run against your account with your verified domains, limits and suppressions — then the result comes back to the chat.

02 — Capabilities

Everything you’d open the dashboard for.

31 tools across seven areas of your account. Read-only tools answer questions; write tools make changes you asked for.

Read

Write

Irreversible

2 tools

Sending

Send a one-off message or render a published template with your variables — always from a verified domain.

send_email send_template_email

Try “Send the welcome template to [email protected] with name = Deniz.”

7 tools

Templates

Draft, edit, duplicate and publish templates without opening the editor. Ask for a new language version or a sharper subject line.

list_templates get_template create_template update_template duplicate_template publish_template delete_template

Try “Duplicate order-confirmation as a Turkish version and publish it.”

5 tools

Domains

Add a sending domain, get the exact SPF, DKIM, Return-Path, DMARC and tracking records, then re-check verification.

list_domains get_domain add_domain verify_domain delete_domain

Try “Add mail.acme.io and list the DNS records I need to create.”

4 tools

Message activity

Search sent mail by recipient, subject, status, template, sender or date range. Open any message’s events and rendered content.

search_messages get_message get_message_content get_message_attachment_link

Try “Show every bounced password reset from the last 7 days.”

7 tools

Webhooks

Create endpoints, scope them, pause or resume delivery and fire a test event — then read the most recent deliveries.

list_webhooks get_webhook add_webhook set_webhook_enabled set_webhook_scope send_test_webhook delete_webhook

Try “Point delivery events to https://acme.io/hooks and send a test.”

5 tools

Suppressions

See who is suppressed and why — hard bounce, spam complaint, unsubscribe or manual — and add or lift a block.

get_suppression_summary search_suppressions get_suppression add_suppression delete_suppression

Try “Is [email protected] suppressed? If it was manual, remove it.”

1 tool

Plan & usage

Check your plan, its limits and how much of the current period you’ve used — before a large send, not after.

get_usage

Try “How many emails can we still send this month?”

Stays in the dashboard

Some things are deliberately out of an assistant’s reach.

API key management
Billing and plan changes
Account and team settings

03 — Connect

Connected in under a minute.

Add one URL to your client and approve it in Notifiva. No SDK, no local process to run, nothing to keep updated — the server is hosted for you.

Step 1

Add the server

Paste https://api.notifiva.com/mcp into your AI client as a remote MCP server.
Step 2

Approve in Notifiva

A browser window opens. Sign in and approve — the app gets only the access you grant.
Step 3

Ask in plain language

Start a chat. The assistant now sees Notifiva’s tools and uses them when they help.

Open Settings → Connectors and choose Add custom connector.
Name it Notifiva and paste the server URL below, then press Continue.
Notifiva opens in your browser — sign in and approve the connection.
Back in a chat, enable Notifiva from the tools menu and ask away.

Remote MCP server URL

https://api.notifiva.com/mcp

Run the command below in your terminal.
Start Claude Code and type /mcp to authenticate Notifiva.
Approve the connection in the browser window that opens.
Ask Claude Code to check a domain or send a test from your project.

Shell

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

Open Cursor Settings → MCP and add a new global server, or edit ~/.cursor/mcp.json.
Paste the configuration below and save.
Click Connect next to notifiva and approve it in your browser.
Use Agent mode to call Notifiva tools while you code.

mcp.json

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

Create .vscode/mcp.json in your workspace (or run MCP: Add Server).
Paste the configuration below.
Start the server from the file and approve the connection in your browser.
Pick Notifiva’s tools in Copilot Chat agent mode.

.vscode/mcp.json

{
  "servers": {
    "notifiva": {
      "type": "http",
      "url": "https://api.notifiva.com/mcp"
    }
  }
}

Open Windsurf Settings → Cascade → MCP Servers and choose View raw config, or edit ~/.codeium/windsurf/mcp_config.json.
Paste the configuration below and save.
Refresh the MCP server list and approve Notifiva in your browser when asked.
Ask Cascade to use Notifiva’s tools.

mcp_config.json

{
  "mcpServers": {
    "notifiva": {
      "serverUrl": "https://api.notifiva.com/mcp"
    }
  }
}

For clients that can’t open a browser — CI jobs, servers, custom agents.
Create an API key in the Notifiva dashboard. Use a test key to record messages without delivering them.
Send it as a bearer token in the Authorization header.
Keep the key in a secret store, never in source control.

Any MCP client · HTTP headers

{
  "mcpServers": {
    "notifiva": {
      "url": "https://api.notifiva.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_NOTIFIVA_API_KEY"
      }
    }
  }
}

app.notifiva.com/settings/connected-apps

MCP Connector

AI assistants and tools you let work in your account. Each one only has the permissions you approved.

Connect an app

https://api.notifiva.com/mcp

Prefer a key? Apps that can’t open a browser can use an API key as a bearer token.

Connected

Claude

Connected today

Revoke

Cursor

Connected 3 days ago

Revoke

See and revoke every connected assistant under Settings → Connected apps. Panel shown with example data.

04 — In practice

Prompts that replace ten clicks.

The assistant chains tools on its own. Here is what a few everyday requests turn into.

Debug

“Why didn’t [email protected] get her password reset yesterday?”

search_messages get_message get_suppression

Finds the message, reads the bounce reason and checks whether the address is now suppressed.

Onboard

“Add mail.acme.io as a sending domain and tell me which DNS records to create.”

add_domain

Returns SPF, DKIM, Return-Path, DMARC and tracking records, ready to paste into your DNS.

Verify

“I published the records — is the domain verified now?”

verify_domain get_domain

Re-checks DNS and tells you which record, if any, is still pending.

Localise

“Make a Turkish copy of the order confirmation template and publish it.”

duplicate_template update_template publish_template

Copies the template, translates subject and body, then publishes it.

Integrate

“Send bounce and complaint events to https://acme.io/hooks/notifiva and test it.”

add_webhook send_test_webhook

Creates the endpoint and confirms it answers before real traffic arrives.

Report

“Summarise this week: how much did we send and how many bounced?”

get_usage search_messages get_suppression_summary

Pulls usage, bounced messages and suppression totals into one answer.

05 — Security & control

Powerful, not unsupervised.

An assistant connected to Notifiva works inside the same guardrails as your API — and you can see, scope and revoke it at any time.

You approve every app: Connections are authorised in your browser with your Notifiva login. Nothing connects silently.
Revoke in one click: Every connected assistant is listed under Settings → Connected apps. Remove it and its access ends.
Verified domains only: Mail can only be sent from domains whose DNS you have verified — an assistant can’t spoof a sender.
Confirmation before the irreversible: Deleting a domain, template, webhook or suppression can’t be undone, so the server instructs assistants to confirm with you first.
Safe test mode: Connect with a test API key and every send is recorded with full content, but never delivered.
Your limits still apply: MCP sends count toward the same daily and monthly limits as API and SMTP sends; suppressions are always honoured.

Claude wants to connect to Notifiva

Signed in as [email protected]

Send email from your verified domains
Read message activity and usage
Manage templates, domains and webhooks
View and edit suppressions

Deny Approve

Approval screen — illustrative

06 — Tool reference

All 31 tools.

The exact names your assistant sees. Filter by area; colour shows whether a tool reads, writes or makes a change that can’t be undone.

ToolWhat it doesType

send_emailSending Send a single email (HTML and/or text, attachments) from a verified sending domain. Write

send_template_emailSending Send a published template by alias, filling in its variables. Write

list_templatesTemplates List templates (without HTML), optionally for one sending domain. Read

get_templateTemplates Read one template, including subject, HTML and status. Read

create_templateTemplates Create a new draft template on a sending domain. Write

update_templateTemplates Change a template’s name, subject, HTML or text. Write

duplicate_templateTemplates Copy a template — useful for language or A/B versions. Write

publish_templateTemplates Publish a draft so it can be used for sending. Write

delete_templateTemplates Delete a template. Cannot be undone. Irreversible

list_domainsDomains Every sending domain with its DNS records and verification status. Read

get_domainDomains One domain’s records and per-record status. Read

add_domainDomains Add a sending domain and return the DNS records to publish. Write

verify_domainDomains Re-check the domain’s DNS records now. Write

delete_domainDomains Remove a sending domain. Cannot be undone. Irreversible

search_messagesMessage activity Find sent messages by recipient, subject, ID, status, template, domain, sender or date range. Read

get_messageMessage activity A message’s details and full event history. Read

get_message_contentMessage activity The rendered HTML and text of a sent message. Read

get_message_attachment_linkMessage activity A download link for one of a message’s attachments. Read

list_webhooksWebhooks Every webhook with its events, scope and most recent deliveries. Read

get_webhookWebhooks One webhook’s configuration and delivery log. Read

add_webhookWebhooks Create a webhook endpoint for the events you choose. Write

set_webhook_enabledWebhooks Pause or resume deliveries to an endpoint. Write

set_webhook_scopeWebhooks Limit a webhook to the whole account or specific domains. Write

send_test_webhookWebhooks Fire a test event at an endpoint to check it responds. Write

delete_webhookWebhooks Delete a webhook. Cannot be undone. Irreversible

get_suppression_summarySuppressions Total suppressed addresses, split by bounce and complaint. Read

search_suppressionsSuppressions Find suppressed addresses by text, reason or stream. Read

get_suppressionSuppressions Why and since when one address is suppressed. Read

add_suppressionSuppressions Block an address from receiving mail. Write

delete_suppressionSuppressions Lift a suppression so the address can receive mail again. Irreversible

get_usagePlan & usage Plan, limits and current-period usage (sends, domains, webhooks, templates). Read

07 — FAQ

Questions, answered.

Something missing? The API reference covers every parameter, and our team reads every message.

Read the docs

What is the Notifiva MCP server?

It is a Model Context Protocol (MCP) endpoint at https://api.notifiva.com/mcp that lets AI assistants such as Claude, Claude Code and Cursor work inside your Notifiva account. It exposes 31 tools for sending, templates, domains, message activity, webhooks, suppressions and usage.

Which AI clients can connect?

Any client that supports remote MCP servers over HTTP — including Claude on the web and desktop, Claude Code, Cursor, VS Code and Windsurf, as well as custom agents built with an MCP SDK. Clients that cannot open a browser can authenticate with an API key as a bearer token.

How do I connect?

Add https://api.notifiva.com/mcp as an MCP server in your client. It opens Notifiva in your browser, where you sign in and approve the connection. In Claude Code, run: claude mcp add --transport http notifiva https://api.notifiva.com/mcp.

Can the assistant send email without asking me?

An assistant can only use the tools your client allows, and Notifiva only sends from domains you have verified. Most clients ask for confirmation before a tool that sends or changes something runs. Deleting a domain, template, webhook or suppression cannot be undone, so the server instructs assistants to confirm with you first.

Do messages sent through MCP count toward my plan?

Yes. Messages sent through MCP count toward your monthly and daily limits exactly like API and SMTP sends. Messages sent with a test API key are recorded but not delivered, and are not counted.

How do I disconnect an assistant?

Open Settings → Connected apps in the Notifiva dashboard and revoke the app. It loses access to your account; you can reconnect at any time.

What can’t be done through MCP?

API key management, billing and plan changes stay in the Notifiva dashboard on purpose, so an assistant can never create credentials or change what you pay.

Is there a safe way to test?

Yes. Connect with a test API key: every send is recorded in your activity log with its full content, but nothing is delivered to a real inbox.

Give your assistant an outbox.

Connect Notifiva to Claude, Cursor or your own agent and run transactional email from the conversation.

Connect your assistant Create a free account

Available on every plan · No credit card to start