Connect an AI Assistant
Connect Claude, Cursor, or any MCP-aware client to Nashra's MCP server at https://app.nashra.ai/mcp so it can manage subscribers, posts, and email sends for you — OAuth sign-in, the 18 available tools, who test emails can go to, what sending requires, and how access works for team members.
What MCP is
MCP (Model Context Protocol) is an open standard that lets AI assistants call an application's functions directly, instead of you copying data back and forth by hand. Nashra runs an MCP server so a connected assistant — Claude, Cursor, or any other MCP-aware client — can read and manage your workspace on your behalf, using the same underlying actions as the Nashra dashboard.
Connecting a client
Add the server
In your MCP client, add a new server pointing at https://app.nashra.ai/mcp.
Authorize in your browser
Your client opens a browser window to sign in and approve access. Nashra's server supports OAuth discovery and dynamic client registration, so most clients complete this automatically. The consent screen shows which account you're logged in as — check it, then click Authorize.
Start using it
Once connected, ask your assistant to list subscribers, draft a post, or check a segment. It calls the matching tool automatically.
The server identifies itself as nashra, version 1.0.0. Access is secured with OAuth 2.1 with PKCE — you don't need an API key. MCP requests get the same limit as the REST API, 60 a minute — see Rate Limits.
These tools can create, edit, publish, and delete real content and subscribers — and SendPost sends an email campaign to your actual subscriber list. Before asking your assistant to send anything for real, use SendTestPost to preview it first.
Test emails can only go to your own address, a team member's address, or one of your workspace's sender addresses — the same rule as Send test in the editor. Ask for a test to anyone else and the assistant gets an error back.
What you can ask for
The assistant composes these tools on its own, so most requests translate into one or more tool calls without you needing to name them:
- "Show me subscribers tagged
vipwho joined this month" →ListSubscribers - "Draft a post about our Q3 launch and put it in the Product category" →
CreatePost - "Send a test of this post to me before it goes out" →
SendTestPost - "Schedule this for Thursday at 9am to the Newsletter segment" →
ScheduleSendPost - "Which workspace am I in — switch me to the other one" →
ListWorkspaces,SwitchWorkspace
The assistant only has the 18 tools listed below — it can't do anything in Nashra that isn't backed by one of them. Writes run through the same checks the dashboard uses: plan limits when publishing, and account health, sending quota, and payment status before a send. Sending — now or scheduled — needs a paid plan or a payment method on file, just like sending from the editor.
Access and permissions
An MCP connection acts as the Nashra account that authorized it, in the workspaces that account belongs to — use ListWorkspaces and SwitchWorkspace to move between them. There are no separate scopes to configure.
Team roles don't narrow the tool list today: anyone on your team who connects an assistant gets all 18 tools in that workspace, whether they're an owner, an admin, or an editor. Only connect accounts you'd trust with the whole workspace. When someone leaves, removing them from the team also cuts their assistant off from the workspace. See Team & Roles for how roles work in the dashboard.
Tools
Nashra's MCP server exposes 18 tools across three groups: subscribers, posts, and workspaces.
Subscribers
| Tool | What it does |
|---|---|
ListSubscribers | Lists subscribers with optional search, status filter (subscribed, unsubscribed, or unconfirmed), and pagination. Read-only. |
GetSubscriber | Looks up a single subscriber by UUID or email. Read-only. |
CreateSubscriber | Creates a subscriber with an email and optional name, tags, notes, and custom attributes. |
UpdateSubscriber | Updates an existing subscriber by UUID or email — only the fields you provide are changed. |
DeleteSubscriber | Deletes a subscriber by UUID or email. |
ListTags | Lists all tags in the current workspace. Read-only. |
ListSegments | Lists all segments in the current workspace, with subscriber counts. Read-only. |
Posts
| Tool | What it does |
|---|---|
ListPosts | Lists posts with optional search, status filter (draft, published, scheduled, or sent), category filter, and pagination. Read-only. |
GetPost | Gets a single post by UUID, including its full content and open/click rates. Read-only. |
CreatePost | Creates a new draft post, optionally setting title, content, and category. |
UpdatePost | Updates an existing post's title, content, slug, or category. Only provided fields are changed. |
PublishPost | Publishes a post to your Publishing Home at a given URL slug. Checks plan limits before publishing. |
UnpublishPost | Unpublishes a post, moving it back to draft. |
SendTestPost | Sends a test email of a post to a single address — yours, a team member's, or one of your sender addresses — to preview it before sending for real. |
SendPost | Sends a post as an email campaign to subscribers — everyone, or a specific segment — immediately. Needs a paid plan or a payment method on file. |
ScheduleSendPost | Schedules a post to send as an email campaign at a specific date and time, in the workspace's timezone. Needs a paid plan or a payment method on file. |
Workspaces
| Tool | What it does |
|---|---|
ListWorkspaces | Lists every workspace (publication) the authorizing account belongs to, and marks which one is currently active. |
SwitchWorkspace | Switches the active workspace by UUID. Fails if the account doesn't belong to that workspace. |