How to integrate Laposta MCP with Atomic Agent

Connect Atomic Agent to Laposta MCP. Add subscriber to laposta list by email, send campaign to "monthly updates" group, and more using natural language, with authentication handled for you.

Laposta logoLaposta
Api Key

Laposta is a Dutch newsletter platform for creating and sending professional newsletters. It makes email marketing simple and efficient for teams and businesses.

25 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Laposta.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Laposta account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Laposta with

How Atomic Agent connects to Laposta

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Laposta to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Laposta. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Laposta account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Laposta MCP server, and what's possible with it?

The Laposta MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Laposta account. It provides structured and secure access to your mailing lists, subscribers, campaigns, custom fields, and webhooks, so your agent can manage lists, update subscribers, review campaigns, configure fields, and maintain webhooks on your behalf.

  • Mailing list management: Have your agent create mailing lists, review or update their details, list all available lists, and delete lists you no longer need.
  • Subscriber management: Let the agent add subscribers to a list, find and review members, update their details or status, and remove them when needed.
  • Custom subscriber fields: Direct your agent to create, review, and update custom fields that store the subscriber information your campaigns need.
  • Campaign overview: Instruct your agent to retrieve your Laposta email campaigns so you can quickly review what is available in your account.
  • Webhook configuration: Have your agent create webhooks for mailing list events, inspect existing webhook details, and update their destination, event type, or blocked status.

Use Laposta from Atomic Agent

With your account connected, ask Atomic Agent to work with Laposta in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Laposta action and event your agent gets out of the box.

Get All Campaigns

Retrieve all email campaigns from your Laposta account.

Create Custom Field

Tool to create a custom field for a mailing list to define subscriber attributes.

Delete Field

Tool to permanently remove a custom field from a mailing list.

Get Field Details

Tool to retrieve specific field details by field_id.

Get All Fields

Retrieve all field definitions for a specific Laposta list.

Update Field

Tool to modify field configuration in a Laposta list.

Get Segment Details

Retrieve a segment from a mailing list by segment ID, including its name, definition criteria, and creation and modification timestamps.

Clear All Members From List

Tool to clear all active members from a list.

Create Mailing List

Tool to create a new mailing list in Laposta to manage email subscribers.

Delete List

Permanently deletes a Laposta mailing list and its configuration.

Get List Details

Tool to retrieve specific list details by list_id.

Get All Lists

Retrieve mailing lists from the Laposta account, including list details and member counts.

Update Mailing List

Tool to modify list properties such as name, remarks, or notification emails.

Create Member

Tool to add a new subscriber relationship to a list with custom fields and tracking info.

Delete Member

Tool to permanently remove a member from a list.

Get Member

Tool to retrieve specific member details by member_id or email.

Get All Members

Tool to retrieve all members from a specified Laposta mailing list.

Update Member

Tool to modify member data, status, or custom fields in a Laposta list.

Get All Campaign Reports

Tool to retrieve performance metrics for all campaigns.

Get All Segments

Tool to retrieve all segments from a mailing list.

Create Webhook

Register a webhook for subscriber subscriptions, modifications, or deactivations on a Laposta list.

Delete Webhook

Permanently delete a webhook from a list.

Get Webhook Details

Tool to retrieve specific webhook details by webhook_id.

Get All Webhooks

Tool to retrieve all webhooks for a specific list.

Update Webhook

Tool to modify webhook configuration including URL, event type, or blocked status.

FAQ

Frequently asked questions

Start with Laposta.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Laposta tool your agent needs.Free to start.

Start building