Integration · Marketing

Connect Claude & ChatGPT to magnews

Ask your AI how your last newsletter performed, to find a contact, or to subscribe someone to a database in magnews. It can read newsletters, transactional messages, workflows and audiences with their statistics, look up and update contacts, and run MQL queries. It can also create and send communications, send a single email and pause or resume a delivery.

Connect magnews free

Free plan, no credit card. Takes about a minute.

Try asking

“How did our last newsletter do?”
The AI lists your newsletters and reads the statistics for the latest one: sent, opens, clicks and similar.
“Find all contacts with an email address at acme.com.”
It runs a read query in magnews Query Language (MQL) and returns the matching contacts.
“Subscribe [email protected] to our main newsletter database.”
It lists your databases, picks the right one and subscribes the contact, creating her if needed.

What your AI can do

Contacts and databases

Look up, count, create, update, subscribe, unsubscribe and delete contacts, and read database fields and web tracking.

Newsletters and deliveries

Create and send or schedule communications, send a single email, and check, pause or resume a delivery.

Statistics and audiences

Read stats for newsletters, transactional messages and workflows, list audiences, and check your sending credit.

“Pause delivery 4521, we found a typo.”
It pauses the delivery while it is sending. You can resume it later.
“How much email credit do we have left?”
It reads the remaining sending credit for the email channel.
“Which pages on our site has contact 10233 visited?”
It reads the contact's web tracking activity with the pages visited.

62 tools for magnews

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

count_contactsVisible to othersCount contacts in a database (`iddatabase`), optionally matching a `filter`.
create_batchdeleteChanges dataCreate a new batchdelete. API summary: Batch delete contacts.
create_batchmergeChanges dataCreate a new batchmerge. API summary: Batch merge contacts.
create_bulkdownloadChanges dataCreate a new bulkdownload. API summary: Bulk download (post).
create_communicationChanges dataCreate a communication (a message to send) with `name`, `channel`, `subject`, `from_name`, `from_email`, `template` and `target`. It is not sent until you send it.
create_communication_sectionChanges dataCreate a new section for a communication. API summary: Write communication sections.
create_createChanges dataCreate a new create. API summary: Create transactional message.
create_createfromqueryChanges dataCreate a new createfromquery. API summary: Create dynamic audience from query.
create_entity_batchdatumChanges dataCreate a new batchdatum for a entity. API summary: Batch merge entity.
create_entity_dataChanges dataCreate a new data for a entity. API summary: Merge entity.
create_mergebysecondarykeyChanges dataCreate a new mergebysecondarykey. API summary: Merge contact by secondary key.
create_message_postChanges dataCreate a new message. API summary: Batch Send simple messages.
create_mimemessageChanges dataCreate a new mimemessage. Required: body. API summary: Send MIME message.
create_newsletter_updateChanges dataCreate a new update for a newsletter. API summary: Update newsletter basic information.
create_shipment_stopChanges dataCreate a new stop for a shipment. API summary: Stop delivery.
create_static_audienceChanges dataCreate a new create. API summary: Create static audience.
create_updateChanges dataCreate a new update. API summary: Execute MQL update/insert/delete.
create_webhookDeletesCreate a new create. Destructive action; may require approval. API summary: Create webhook.
delete_audienceDeletesPermanently delete a audience by idaudience. Destructive action; may require approval. API summary: Delete static audience.
delete_contactDeletesPermanently delete a contact by `idcontact`.
delete_webhookDeletesPermanently delete a delete by delete id. Destructive action; may require approval. API summary: Delete webhook.
get_audienceGet one audience (segment) by `idaudience`.
get_contactGet one contact by `idcontact` with all field values.
get_contact_web_trackingGet the web tracking activity (pages visited) of a contact by `idcontact`.
get_database_schemaGet the fields of a contact database by `iddatabase`.
get_delivery_statusGet the status of a delivery (a sending in progress) by `iddelivery`.
get_messagebyexternalidGet one messagebyexternalid by external id. API summary: Get simple message status by external id.
get_newsletterGet the details of one newsletter by `newsletter_id` (name, subject, sender).
get_newsletter_statsGet statistics for one newsletter by `idnewsletter` (sent, opens, clicks and similar).
get_residual_creditGet the remaining sending credit for a `channel`.
get_scheduledworkGet one scheduledwork by idoperation. API summary: Find scheduled work by id.
get_simple_messageGet a single message sent with send_simple_message by `idmessage`, including its delivery status.
get_transactional_statsGet statistics for one transactional message by `idnewsletter`.
get_user_infoGet details of the connected magnews user and account.
get_webhookGet one webhook by webhook id. API summary: Get webhook.
get_workflow_statsGet statistics for one workflow by `idworkflow`.
list_audiencesList audiences with their statistics.
list_bulkdownloadsList bulkdownloads. API summary: Bulk download (get).
list_contactsList contacts. API summary: Query web tracking contacts.
list_databasesList your contact databases. Use a database ID in `iddatabase` for contact tools.
list_entity_dataList data for a entity. API summary: Find entity.
list_message_infosList infos for a message. API summary: Get simple message info.
list_newslettersList newsletters with their sending statistics.
list_scheduledwork_triggersList triggers for a scheduledwork. API summary: Trigger scheduled work.
list_template_qcatalogsList qcatalogs for a template. API summary: Get template Q catalog.
list_transactionalsList transactional messages with their statistics.
list_webhooksList lists. API summary: List webhooks.
list_workflow_infosList infos for a workflow. API summary: Get workflow info.
list_workflowsList automation workflows with their statistics.
pause_deliveryChanges dataPause a delivery that is sending, by `iddelivery`.
resume_deliveryChanges dataResume a paused delivery by `iddelivery`.
run_mql_queryChanges dataRun a read query written in magnews Query Language (MQL) in `query`, with optional `parameters` and a result limit in `options.max`. Use this to find contacts.
search_audiencesSearch audiences. Use this to find existing audiences before creating a new audience. API summary: Query audiences.
search_contactsSearch contacts. Use this to find existing contacts before creating a new contact. API summary: Query contacts.
search_shipmentsSearch shipments. Use this to find existing shipments before creating a new shipment. API summary: Query deliveries.
send_communicationVisible to othersSend or schedule a communication by `communication_id` to its target, with optional `target` IDs and `schedule`. This sends real messages to contacts.
send_simple_messageVisible to othersSend a single email right away, with `values.to`, `subject`, `htmlbody`, `fromemail` and `fromname`. This sends a real email.
subscribe_contactChanges dataSubscribe a contact with field `values` (e.g. email, name) to a database in `options.iddatabase`, creating them if needed.
unsubscribe_contactChanges dataUnsubscribe a contact by `values.email` from a database in `options.iddatabase`, so they stop receiving communications.
update_contactChanges dataUpdate a contact by `idcontact` with new field `values`.
update_webhookDeletesCreate a new update. Destructive action; may require approval. API summary: Update webhook.
upsert_contactVisible to othersCreate a contact or update the one with the same primary key, with field `values` (e.g. email, name) and `options.iddatabase`.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose magnews from the app list.
2
Paste your key
Fill in two fields: your magnews REST API base URL and an access token. In magnews go to Settings > API e integrazioni > Accessi tecnici, click Crea accesso tecnico, tick 'API magnews' and copy the access token from the summary. Tokens are also listed under Gestione token.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in magnews?

The AI can read contacts, databases, audiences, newsletters, transactional messages, workflows, deliveries, statistics, web tracking and your sending credit, and run MQL read queries. It can create, update, subscribe, unsubscribe and delete contacts, create and send communications, send a single email and pause or resume a delivery.

Does the AI see my magnews credentials?

No. Your magnews credentials are encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start by only reading stats and contacts. Sending a communication or a single email reaches real people, and deleting a contact is permanent, so these can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own magnews account.

Which REST API base URL should I use?

It depends on your magnews instance. The magnews Postman collection shows https://ws-mn1.mag-news.it/ws/rest/api as an example, but the host can be different for your account. Check the magnews REST API guide or ask magnews if you are unsure.