Ask what headless means and you will collect at least three answers, each delivered with complete confidence. Some mean a storefront that pulls content from a back end through an API. Some mean a platform with its own pop-ups and templates plus a set of APIs for anyone who wants to render things elsewhere. The newest group means AI assistants that log into nothing and click nothing, because they call the platform's functions directly through the Model Context Protocol (MCP) or APIs
None of them is wrong, and that is what makes the word so hard to buy with. The first meaning is about the shop window your customers look through. The newest one is about the stockroom door your own team uses every morning, and that door has changed more in the past year than the window has in a decade. We'll follow one running-gear shop through both, look at what each version costs and what it pays back, and finish with how we have approached it in Manago AI.
Three things people mean by headless
Front-end headless, the original meaning. The platform keeps the data and the business logic. Your own front end (or multiple frontends e.g for multi-languages) fetches what it needs through an API and renders it in your design, whether that front end is a storefront built on a separate framework, a mobile app or a screen in a physical store.
Hybrid. The platform keeps its ready-made components, such as forms, pop-ups and email templates, and also offers APIs for teams that want to render content elsewhere. Most mature marketing platforms work this way, and for plenty of teams it is the sensible choice.
Agentic headless. An AI assistant or a custom agent calls the platform's functions through MCP and APIs, so nobody has to log in and click through screens to finish a task. The interface is still there, now as one entrance among several.
The MACH Alliance, the industry body behind composable architecture, files these ideas in separate drawers. Its 2026 principles put headless under "composable" and place API-first design and MCP connectivity under "connected". Worth remembering the next time a demo blurs them: an MCP server doesn't make a platform headless in the classic sense, and a classic headless platform won't necessarily talk to an AI agent.
Headless in plain English: data, decisions and display
Every marketing platform looks after three things: your customer data, the decisions (which product, which offer, which message) and the display (the pop-up, the product recommendations, the form). A headless platform keeps the first two and hands them over through an API. You, your agency or an AI agent decide where and how they appear.
For a customer engagement platform, that comes down to three flows:
Data in: events, profiles, orders and the product catalogue arrive through APIs, SDKs and webhooks, ideally in real time.
Decisions out: the platform answers a question such as "what should this shopper see?" with data that your storefront or app renders in its own design.
Actions from anywhere: another system, or an agent, can create a segment or trigger a campaign without anyone opening the interface.
Let's see how it looks in practice, let's say, in the sports shop. Its storefront runs on a headless framework, and a shopper spends a few minutes looking at trail shoes. The browse event goes into the platform. The storefront asks the recommendations API for three products and shows them in the shop's own layout. Two hours later the same profile triggers an abandoned-browse email with the same three pairs. That request and response, repeated wherever the shopper turns up, is the headless part.
The shop belongs to a small club. A September 2026 analysis of 3.9 million ecommerce homepages in the HTTP Archive found a recognisable headless storefront framework on roughly one in a thousand. The study tracked only eight frameworks, so custom builds slip through the count, but the order of magnitude tells you how much work a decoupled front end really takes.
What headless buys you, and what the invoice says
Headless separates the value of a platform from one particular way of using it, and most of the benefits follow from that.
Customer experiences without template limits: the same logic can power a website, an app, a marketplace listing or an in-store screen, each designed for its own context.
Faster change at the front: you can redesign a storefront or add a channel without replacing the system that holds your customer data.
Logic built once: one recommendation engine and one customer profile serve every surface.
A suitable interface for each task: analysts work through the API, marketers in the platform's interface and, more and more often, agents through MCP.
component doesn't mean rebuilding the stack.
The part the demo tends to skip
Flexibility moves responsibility onto your team. Someone has to build the front end that renders what the API returns, retest it whenever the API changes and fix it when it breaks in the middle of peak season. Integrations keep costing money long after launch too. In Paragon's 2026 survey of 600 B2B SaaS leaders, 68% said their engineers spend at least a quarter of their time maintaining existing integrations before they can build anything new.
Add latency between services, more systems to monitor and a bigger attack surface, and the full price of classic headless comes into view. It is the licence plus the developer time to build and look after everything the platform no longer renders for you.
Headless through MCP: your AI assistant becomes the front end
MCP in two paragraphs
Anthropic introduced MCP in November 2024 as an open standard for connecting AI applications to external data and tools. In December 2025 the protocol moved to the Agentic AI Foundation at the Linux Foundation, which now governs it as a vendor-neutral project.
The architecture has three parts. The host is the AI application, such as Claude or ChatGPT. Inside it, an MCP client keeps a connection to each MCP server. The server exposes a business system's capabilities in three forms: tools (actions the AI can call), resources (data it can read) and prompts (reusable templates for common tasks).
Same functions, a different caller
An API and MCP both let one application call functions in another. What differs is who decides which call to make. In a classic integration a developer writes the sequence in advance: when this happens, call that endpoint with these parameters. With MCP the AI application receives a description of every available tool, with its parameters and schema, and the model picks the tools that fit the task the user has described. Existing tools can then cover some new scenarios with no new code. The price is predictability, since behaviour now depends on the model and its context and varies more than a coded workflow does.
A front end nobody has to build
Classic headless decoupled the front end your customers see. MCP does the same for the front end your team uses.
Go back to the sports shop on any morning. Its CRM manager wants to know why repeat purchases dipped last month, which customers drove the drop and what a win-back message to them might say. Usually that means three tabs, an export and a spreadsheet. With MCP they ask the AI assistant they already have open, and it calls the platform's tools for the numbers, the segment and a first draft. Nobody had to build that interface or keep it running, which removes the oldest objection to headless, at least for internal work: a new way into the platform no longer needs front-end developers.
The assistant in that example is only as useful as what the platform hands it. A language model knows a lot about marketing in general and nothing about this shop: who bought twice and went quiet, who opted out of SMS, which campaign went out the week the numbers fell. That context lives in the platform’s profiles, events, consents and campaign history, and without it the model still answers, confidently, from averages that belong to someone else’s business.
Graphical interfaces haven't gone anywhere either. The MCP Apps extension, released in January 2026, lets a server show charts, forms, dashboards and approval screens inside the AI application. Headless in this sense keeps the interface and lets it turn up wherever the work is.
What MCP leaves on your plate
MCP standardises how an AI application talks to a system. Planning the task, reading the answers and making the business call still fall to the model and to you, and no protocol cleans up the data underneath. Five limits are worth knowing before you hand a platform to an agent.
Reliability: agents still choose the wrong tool or the wrong order, especially in multi-step tasks across several servers. Benchmarks published in 2026, including ETOM and MCPAgentBench, found clear weaknesses even in leading models, particularly in complex multi-step calls. Pulling campaign statistics carries far less risk than building a segment, checking exclusions and launching a campaign in one go.
Security: the model reads every tool description, which opens the door to tool poisoning (malicious instructions hidden in tool metadata) and to prompt injection through the data an agent reads. In the MCPTox study (AAAI 2026), such attacks succeeded in up to 72.8% of cases in one test setting. OWASP recommends narrow permissions, review of tool definitions and human confirmation for any action with an external effect.
Data flow: an MCP server returns results to the AI application, and those results enter the model's context. Where they are processed next depends on the AI tool, its settings and your organisation's policies, so check what a query returns before you ask for customer-level detail.
Compatibility: implementations support different protocol versions and optional extensions, so "supports MCP" doesn't guarantee that every feature works in every AI tool.
Cost and latency: each step an agent takes adds model calls. For a recommendation that has to appear while the shopper is still on the page, a direct API call is faster and more predictable.
The people signing off budgets see the same risks. In the Paragon survey, integration reliability (52%) was the most common barrier to shipping AI agents, ahead of defining what agents are allowed to do (47%). KPMG's Global AI Pulse for Q1 2026, which surveyed 2,110 executives in 20 countries, put data privacy and cybersecurity at the top of the barriers to scaling AI, each named by 42%.
| Area | Area Classic headless | Agent access through MCP |
|---|---|---|
| Development | Front ends and their upkeep | Tools, permissions and controls on the platform side |
| Reliability | API and service errors | Also the agent's choice and order of tools |
| Security | API access and vulnerabilities | Also prompt injection, tool poisoning and over-broad permissions |
| Governance | User and application permissions | Control over actions an agent starts |
| Cost | Hosting and development | Also model calls, orchestration and monitoring |
A practical way to keep control is to treat three kinds of operation differently. Reading data and reports can run freely within the user's permissions. Preparing drafts, segments and configurations should leave everything editable. Anything with an external effect, such as sending a campaign, should wait for a person to approve it. In the running-gear shop, that means the CRM manager can ask for numbers as often as she likes, while the win-back SMS waits for her click.
Six questions to answer before the first demo
The answers differ for the two meanings of headless, so it pays to ask both sets at once.
Do you have front-end developers who will own this after launch? The test is who fixes it on a Saturday morning. For classic headless this is the deciding question. For MCP access it matters far less, because the front end is an AI tool your team already uses.
Is your storefront already headless? If you run a decoupled storefront or a custom app, your engagement platform must answer through an API. That one is non-negotiable.
Is the front end really what's hurting? "A campaign takes a week to get out" and "the data in the email doesn't match the website" are data and execution problems, and a new architecture won't fix them.
How many surfaces do you serve? Website, email and SMS run perfectly well on native components. An app, in-store screens and a marketplace all reading one profile is where headless starts earning its keep.
Where does your team already work? If analysts and marketers spend their day in an AI assistant, agent access shortens the distance between a question and an answer. If they don't, the platform's interface remains the quicker route.
What happens on your busiest day? Rate limits, uptime and support response times matter more in November than any architecture diagram.
| Task | Better approach | Why |
|---|---|---|
| Product recommendations on the shop page | API or a ready-made component | Low latency and stable behaviour |
| Analysing campaigns, anomalies and drops | Agent with MCP tools | Flexible follow-up questions across data |
| Preparing a segment and a campaign | Agent with platform functions and human approval | Several actions, with a person signing off |
Where Manago AI fits
Manago AI covers all three flows from the start of this article and adds a door built for AI agents.
Data in. Plug-in integrations for Shopify, Magento, PrestaShop and WooCommerce sync customers, orders and products, and webhooks push events such as new orders and basket updates as they happen. For custom and headless builds there is a two-way API, mobile SDKs for Android, iOS and Flutter, and a Frontend SDK. Everything lands in one customer profile.
Decisions out. The Recommendations add-on includes API access, so the recommendations behind our on-site and email components can also be rendered in your own front end.
Actions from anywhere. Through the API, external systems can add a contact to a workflow, manage consents or send a message in a single channel. For people and their AI tools, there is the Manago AI MCP server.
The MCP server connects Claude, ChatGPT (where MCP is supported), Cursor and other MCP-compatible tools to Manago AI through more than 30 tools. Setup is a one-time step: add the server address as a custom connector, sign in to Manago AI and approve the permissions the AI tool requests. From then on, your team can:
Get answers about live contact, campaign and behavioural data as charts, tables and summaries, without SQL or exports, and ask follow-up questions about what changed and why.
Build audiences from a plain-language description and refine them over several prompts.
Draft email campaigns and email and SMS sequences with follow-up logic, exclusions and timing, and generate test variants with audience splits from a hypothesis.
Prepare SMS and web push messages, with character counts, consent checks and time zones handled for SMS.
Control is part of the flow. Every campaign goes through an explicit approval step before it is sent. Analysis runs in a sandbox connected to live data inside Manago AI, and the AI workspace receives the results. The infrastructure is hosted in the EU, access is authenticated and auditable, and Manago AI remains the system of record.
Teams that prefer to stay in the platform get the same kind of help from Agentic AI in the Manago AI interface, including agent routines that run scheduled, read-only analyses and report back. For a first month with MCP, we would start with analysis and reporting, move on to drafts once the team trusts the answers, and keep every send behind the approval step that is already there.
Back to the shop window and the stockroom
Headless began as a way to separate the shop window from the stockroom, and for brands with decoupled storefronts and the developers to run them it remains a real requirement. For most mid-market ecommerce teams, the window can wait until there is a genuine reason to rebuild it. The stockroom door is a different matter. MCP gives the people who run the platform a new way in through the AI assistant they already use, with no development project, as long as permissions, approvals and data flows stay under control. We expect most of the next stage of headless to happen on that side: the interface stays, and the capabilities behind it become available wherever people and AI agents work.
Questions teams ask before they connect an agent
What's the difference between headless and composable?
Headless separates the front end from the back end so that they talk through APIs. Composable goes further: you assemble the whole stack (commerce, content, search, engagement) from separate services that you can replace independently. Every composable stack is headless, while a headless platform doesn't have to sit in a composable stack.
Is MCP the same as an API?
No. MCP usually sits on top of a platform's API. An API is called by code that a developer has written for a fixed purpose. MCP describes a system's tools to an AI application in a standard way, so the model can choose which ones to use for a task the user describes.
Does an MCP server make a platform headless?
Only in the agent sense. MCP gives AI applications access to a platform's functions without its interface. Rendering content in your own storefront still needs content and decisions available through an API.
Do I need developers?
For classic headless, yes: someone has to build and maintain the front end. For MCP access, usually not. Connecting Manago AI to an AI assistant is a one-time configuration, and the work afterwards happens in plain language.
Does customer data leave the platform when I use an AI assistant?
The results of what you ask for go to the AI tool and enter its context. In Manago AI, analysis runs in a sandbox inside the platform, customer data isn't exported to a third-party model for processing, and the AI workspace receives the results. Check your AI tool's data settings, and ask for aggregated answers where customer-level detail isn't needed.
Latest posts
SMS marketing for ecommerce: what works once the novelty wears off
Your first year of SMS marketing probably looked brilliant. Click rates the email team could only envy, abandoned carts coming back fast, a revenue line that justified the budget on its own. Then, somewhere in year two, the numbers stopped making you smile. Opt-outs crept up. Revenue per send slid. The offer that worked last spring now gets a shrug and a STOP.
Read moreCustomer Engagement Platforms, decoded: What they actually do and do you even need one
If you’ve ever come across the term "customer engagement platform", understood all three words clearly, but failed to get what they all mean combined together, don’t worry, you’re not exactly alone. Honestly it gets bandied around too much and we’ve seen it mean a bunch of different ideas. Three familiar words, one confusing product, and nobody seems in a h...
Read moreThe ecommerce merchandising strategy nobody writes down (until it’s too late)
Most merchandising trouble shows up in the week before peak. Three people have edited the same category page in a fortnight, a range pinned for a supplier deal in August is still sitting in the top row, and when someone finally asks what the page is supposed to do, nobody can answer, because the answer was never written anywhere.
Read more