Documentation

Run AstroSend your way

Write, edit and send email newsletters via MCP, grow your audience with our website builder, connect custom domains, and generate revenue from sponsorships, products, and courses without leaving AstroSend.

At a glance

Why AstroSend?

Start here

What is AstroSend?

AstroSend is an AI-native email platform that helps creators and businesses research, write, publish, grow, and monetize newsletters from a single platform.

It turns your company updates, blog posts, social content, and industry news into a polished newsletter every week, then helps you grow your audience and monetize through sponsorships, paid subscriptions, digital products, and more.

You can drive the whole thing three ways:

From the dashboard

The classic web app at /dashboard for writing, sending, and managing everything by hand.

From your editor (MCP)

Connect Claude Code, Cursor, or any MCP editor and work in plain English.

From your own code (API)

A REST API under /api/public/v1 authenticated with a single API key.

New here?

Create a free account, confirm your email, then head to Settings to add your business details. That context is what the AI uses to write good drafts.

Editors & AI

Connect your AI agent

Connect Claude, ChatGPT, Cursor, or any MCP-compatible client to manage newsletters, publish content, and access your AstroSend workspace. It runs on AstroSend's official MCP (Model Context Protocol) server, published on npm as astrosend-mcp.

1. Generate an API key

In the dashboard go to Profile → MCP (/dashboard/profile/mcp), name a key, and copy it. You will only see the full key once.

2. Add it to your editor config

Replace YOUR_API_KEY with the key from step 1, then restart your editor.

json
{
  "mcpServers": {
    "astrosend": {
      "command": "npx",
      "args": ["-y", "astrosend-mcp"],
      "env": { "ASTROSEND_API_KEY": "YOUR_API_KEY" }
    }
  }
}
  • Claude Code: .mcp.json in your project, or run the command below.
  • Cursor: ~/.cursor/mcp.json
  • Other editors: any client that supports stdio MCP servers works with the same three fields (command, args, env).

Prefer the CLI? In Claude Code:

bash
claude mcp add astrosend \
  --env ASTROSEND_API_KEY=YOUR_API_KEY \
  -- npx -y astrosend-mcp

3. Start prompting

Once connected, just ask. For example:

  • “Draft a newsletter about our June updates and save it.”
  • “Add jane@example.com to my subscribers.”
  • “How many people will my latest draft reach? If it looks right, send it.”
  • “Show me open and click rates for my recent newsletters.”

Sending is always two steps

Before anything goes out, the server reports how many people a send will reach and waits for your explicit confirmation. Nothing is sent silently.

Authentication

API keys

A single API key authenticates both the MCP server and the public API. Manage keys under Profile → MCP. Keys are shown in full only at creation, stored hashed, and can be revoked at any time.

Bearer token

Send the key as Authorization: Bearer YOUR_API_KEY on every request.

Scoped to your account

A key acts as you. Anyone with it can manage your newsletters, so keep it secret.

Revocable

Delete a key from the MCP page and it stops working immediately.

Last-used tracking

Each key shows when it was last used so you can spot stale keys.

Treat keys like passwords

Do not commit keys to git or paste them into shared chats. Use one key per tool so you can revoke individually.

Build on AstroSend

Public API

Build custom workflows with AstroSend's REST API. Anything you can do in the dashboard, you can automate in your own code, for example:

Create newsletters

Draft issues programmatically, or generate them with AI from your business context.

Publish issues

Preview the recipient count, then send or schedule when you are ready.

Manage subscribers

Add, update, import, export and segment your audience from your own systems.

Automate campaigns

Wire AstroSend into your stack so newsletters go out as part of your workflows.

Full endpoint reference

The REST API lives under https://astrosend.com/api/public/v1. Authenticate with your API key as a Bearer token. The MCP server is a thin wrapper over these same endpoints, so anything your AI agent can do, your own code can do too.

bash
curl https://astrosend.com/api/public/v1/stats \
  -H "Authorization: Bearer YOUR_API_KEY"
MethodEndpoint
GET/api/public/v1/newsletters
POST/api/public/v1/newsletters
GET/api/public/v1/newsletters/{id}
PATCH/api/public/v1/newsletters/{id}
DELETE/api/public/v1/newsletters/{id}
POST/api/public/v1/newsletters/generate
POST/api/public/v1/newsletters/{id}/prepare-send
POST/api/public/v1/newsletters/{id}/test
POST/api/public/v1/newsletters/{id}/send
GET/api/public/v1/newsletters/sent
GET/api/public/v1/newsletters/sent/{id}
GET/api/public/v1/newsletters/scheduled
DELETE/api/public/v1/newsletters/scheduled
GET/api/public/v1/subscribers
POST/api/public/v1/subscribers
PATCH/api/public/v1/subscribers/{id}
DELETE/api/public/v1/subscribers/{id}
POST/api/public/v1/subscribers/import
GET/api/public/v1/subscribers/export
GET/api/public/v1/audience-count
GET/api/public/v1/stats
GET/api/public/v1/settings
PATCH/api/public/v1/settings
POST/api/public/v1/ai/write-intro
POST/api/public/v1/ai/community-news

Grow

Launch a newsletter website in minutes

Every AstroSend publication includes a fast, SEO-friendly website designed to convert visitors into subscribers.

It is hosted for you and live at astrosend.com/your-handle (or your own domain). Build it under Grow → Website with no code.

Templates

Choose a layout. "Image on the side" (split) is the default and looks great out of the box.

Brand colors

Pick accent and background colors with the built-in color picker.

Sign-up form

A double opt-in form that confirms each subscriber by email before they join your list.

Posts page

Optionally publish your sent newsletters as a public archive. Toggle it on or off.

Products & sponsors

Surface your digital products and sponsor slots right on the page.

Privacy text

Customizable privacy copy under the form, with a sensible default.

Connect

Connecting domains

There are two kinds of domains in AstroSend, and they are set up separately.

Landing-page domain

Serve your subscriber website from your own domain, for example news.yourbrand.com. Add the domain in the dashboard and you will get the exact DNS record to create:

  • Subdomain (recommended, e.g. news.yourbrand.com): add a CNAME record pointing to the target we show you.
  • Root domain (yourbrand.com): add the A record we show you.

DNS changes can take a little while to propagate. We verify automatically and issue an SSL certificate for you once the record is live.

Sending (email) domain

To send newsletters from your own address, verify your domain under Profile → Sending Domains. Enter your domain and From details, and AstroSend generates the exact DNS records to publish. Add them at your DNS provider, click Validate, and you are ready to send with proper email authentication.

Set up email authentication before you send

SPF, DKIM and DMARC tell inbox providers your mail is really from you. Without them, newsletters land in spam or get rejected outright. Treat all three as required setup for every new account, before your first send. AstroSend generates every record for you; you just publish them in DNS.

The records AstroSend gives you cover all three:

SPF

A TXT record that authorizes AstroSend's mail servers to send for your domain. Published on your MAIL FROM subdomain.

DKIM

Three CNAME records that cryptographically sign every email, proving it was not altered in transit. Required to send.

DMARC

A TXT record at _dmarc.yourdomain.com that ties SPF and DKIM together and tells inboxes how to handle anything that fails.

MAIL FROM

An MX record on your MAIL FROM subdomain so bounces and complaints route correctly, which protects your sender reputation.

DNS changes can take a few minutes to a few hours to propagate. AstroSend re-checks each record and marks the domain verified once they are live. Until your sending domain is verified, newsletters go out from AstroSend's shared address.

Two domains, two purposes

The landing-page domain controls where your website lives. The sending domain controls the From address on your emails and its authentication. Set up whichever you need, but verify the sending domain before you send.

Monetize

Monetize with sponsorships

Sell ad placements in your newsletter and let sponsors book and pay themselves. Manage it under Monetize → Sponsorships.

Inventory & slots

Define the placements you sell and set pricing and availability.

Self-serve booking

Sponsors visit your public booking page, pick a slot, upload a logo or image and a link URL, and pay.

Approve or reject

Every booking waits for your approval before it runs, so you stay in control of what appears.

Stripe

Payments go straight to your connected Stripe account.

Requires Stripe

Connect a Stripe account once to enable sponsorships, paid newsletters, products and courses. It is the same connection for all monetization features.

Monetize

Sell digital products

Sell downloadable files, ebooks, templates, presets, anything, directly to your audience. Manage them under Monetize → Products.

Upload & price

Upload your file, set a price and currency, and publish a product.

Stripe checkout

Buyers pay through a hosted checkout; funds go to your connected account.

Secure downloads

After purchase, buyers get a protected download link at /d/{id} so files are not publicly shareable.

Buyers as audience

Customers are tagged as buyers, a segment you can send to alongside your free and paid lists.

Monetize

Sell online courses

Package your knowledge into a paid course. Build it under Monetize → Courses from sections and content blocks, set a price and currency, and sell it through Stripe.

Sections & blocks

Structure lessons into sections, each made of content blocks you arrange in order.

Stripe payments

Learners pay through checkout; revenue lands in your connected Stripe account.

Gated access

Course content unlocks for buyers after purchase.

Audience

Subscribers & segments

Your list lives under Grow → Subscribers. Add people manually, import in bulk, or let them sign up through your website. Every subscriber is tracked with the source they came from.

Segments

Send to your general list, paid subscribers, product buyers, or a combination.

Double opt-in

Website sign-ups confirm by email before joining, keeping your list clean.

Import & export

Bring an existing list in, or export yours any time, via the dashboard or API.

Source tracking

See where each subscriber came from to understand what is working.

The magic

AI newsletters

The core of AstroSend: instead of staring at a blank page each week, you get a ready-to-edit draft built from your business context and fresh, relevant news.

Weekly drafts

On your chosen day, AstroSend assembles a draft and emails you that it is ready to review.

Industry news

The AI pulls in current, relevant news for your space so each issue feels timely.

Write the intro

Generate a polished intro in your tone from a one-line idea.

Your context

Drafts are grounded in the business details you set in Settings; keep them current for best results.

Help

We're here to help

Chat with our team directly from your dashboard at any time. Every plan includes live chat support, just open Profile → Support to start a conversation with a real human on our team. Not signed in yet? Use the contact page instead. For account and billing, see Profile → Account.

Ready to automate your newsletter?

Connect your editor over MCP and write your first draft in minutes.