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.

29 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_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.
delete_contactDeletesPermanently delete a contact by `idcontact`.
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_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_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_workflow_statsGet statistics for one workflow by `idworkflow`.
list_audiencesList audiences with their statistics.
list_databasesList your contact databases. Use a database ID in `iddatabase` for contact tools.
list_newslettersList newsletters with their sending statistics.
list_transactionalsList transactional messages with their statistics.
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.
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`.
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 PipMCP 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 PipMCP 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?

PipMCP 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.