# Simplero — how to use (mcp.ai)

Connect your Simplero account and use 19 tools for marketing automation straight from your AI agent. Connect with your own API key. All-in-one marketing software for course creators, coaches and online marketers.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_simplero?ms=1787295840000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `simplero_add_tag_to_contact`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/simplero`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/simplero/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/simplero/add/tag/to/contact` — Tool to add a tag to a contact identified by email address. Use when you need to tag a contact for segmentation or tracking purposes.
  - body: { tag: string, email: string }
- `POST https://api.mcp.ai/api/simplero/bulk/subscribe/to/list` — Tool to add multiple subscribers to a list in a single asynchronous request (max 1,000 per request). Use when you need to bulk import subscribers into a list. Returns a token to track the operation st
  - body: { list_id: integer, subscriber_data: object[] }
- `POST https://api.mcp.ai/api/simplero/create/or/update/administrator` — Tool to create a new administratorship or update an existing one with the same email. Use when you need to add a new administrator to Simplero or update their role and permissions.
  - body: { email: string, message?: string, autogenerate?: boolean, invitee_name?: string, admin_role_id: integer, inviter_email?: string, show_on_ticket?: boolean, ticket_assignee?: boolean }
- `POST https://api.mcp.ai/api/simplero/create/or/update/contact` — Tool to create a new contact or update an existing contact with the same email. Use when you need to add a new contact to Simplero or update their information.
  - body: { ref?: integer, note?: string, tags?: string, email: string, phone?: string, track?: string, override?: string, referrer?: string, last_name?: string, first_name?: string, ip_address?: string, gdpr_consent?: integer, landing_page_id?: integer, gdpr_consent_text?: string, first_activated_at?: string, auto_responder_start_at?: string }
- `POST https://api.mcp.ai/api/simplero/find/contact/by/email` — Tool to find and retrieve a contact by email address. Use when you need to look up contact details using an email address.
  - body: { email: string }
- `POST https://api.mcp.ai/api/simplero/find/subscription/by/email` — Tool to find subscriptions for a specific list by email address. Use when you need to search for subscriptions associated with an email in a particular list.
  - body: { email: string, list_id: integer }
- `POST https://api.mcp.ai/api/simplero/get/admin/roles` — Tool to retrieve all available admin roles for the account including custom roles. Use when you need to list all admin roles such as Co-Owner, Admin, Basic admin, Assistant, Support specialist, Affili
- `POST https://api.mcp.ai/api/simplero/get/administrator/by/id` — Tool to retrieve a single administratorship by internal ID. Use when you need detailed information about a specific administrator including user, account, role, and permission details.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/simplero/get/administrators` — Tool to retrieve all administratorships for the account. Use when you need to get information about account administrators, their roles, and permissions.
- `POST https://api.mcp.ai/api/simplero/get/async/request/status` — Tool to check the status of an asynchronous API request. Use when you need to monitor the progress of a previously initiated async operation using its token.
  - body: { token: string }
- `POST https://api.mcp.ai/api/simplero/get/contact/by/id` — Tool to retrieve a JSON representation of a contact by internal ID. Use when you need to fetch detailed information about a specific contact. Returns 404 if no contact exists with the provided ID.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/simplero/get/invoices` — Tool to get invoice information with optional filtering by date and invoice number. Use when you need to retrieve invoices from Simplero. Returns 20 invoices per page ordered by invoice number.
  - body: { dir?: string, page?: integer, created_at_to?: string, created_at_from?: string, invoice_number_to?: string, invoice_number_from?: string }
- `POST https://api.mcp.ai/api/simplero/get/lists` — Tool to retrieve all mailing lists configured in the account. Use when you need to view all available lists for managing subscriptions and email campaigns.
- `POST https://api.mcp.ai/api/simplero/get/products` — Tool to list all products in the account. Use when you need to retrieve information about all available products including their pricing.
- `POST https://api.mcp.ai/api/simplero/remove/administrator` — Tool to delete an administratorship by ID. Use when you need to remove an administrator relationship from the system.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/simplero/remove/tag/from/contact` — Tool to remove a tag from a contact identified by email address. Use when you need to remove a specific tag from a contact's profile.
  - body: { tag: string, email: string }
- `POST https://api.mcp.ai/api/simplero/subscribe/to/list` — Tool to add a new subscriber to a specific mailing list. Use when you need to subscribe a contact with their email address to a list.
  - body: { ref?: integer, tags?: string, email: string, phone?: string, track?: string, list_id: integer, referrer?: string, last_name?: string, first_name?: string, ip_address?: string, gdpr_consent?: boolean, landing_page_id?: integer, first_activated_at?: string, auto_responder_start_at?: string }
- `POST https://api.mcp.ai/api/simplero/unsubscribe/from/list` — Tool to unsubscribe a customer from a specific mailing list. Use when you need to remove a contact from a list by their email address.
  - body: { email: string, list_id: integer }
- `POST https://api.mcp.ai/api/simplero/update/contact/credentials` — Tool to update a contact's login credentials including email, first name, and last name. Use only with the consent of the contact. At least one identification parameter (email, id, or token) is requir
  - body: { id?: integer, email?: string, token?: string, last_name?: string, first_name?: string, update_login_email?: boolean }

## Example prompts
- "What can I do in Simplero?"
- "Show me a summary of my Simplero account"

## More
- Page: https://mcp.ai/simplero
- Agent spec (llms.txt): https://mcp.ai/simplero/llms.txt
- Postman collection: https://mcp.ai/simplero/postman.json