What Is Salesforce Headless 360? The Complete 2026 Guide

Article Written By:
Anantharaman Veeraraghavan
Created On:
Salesforce Headless 360 architecture guide showing API MCP and CLI access for AI agents

On April 15, 2026, Salesforce made the browser optional. Salesforce Headless 360 is an architectural shift announced at TrailblazerDX 2026 that exposes every platform capability — CRM data, business logic, workflows, and agent tools — as an API, MCP tool, or CLI command. AI agents and developers can now access the full Salesforce platform without ever opening a browser window.

The numbers tell the story: 60+ new MCP tools, 30+ preconfigured coding skills, native React support, and a new Experience Layer that renders agent outputs across Slack, Teams, ChatGPT, Claude, and more. This isn't a feature release. It's a fundamental rethinking of how humans and AI agents interact with Salesforce.

In this guide, we'll break down what Headless 360 actually is, how the architecture works, what it means for your team, and whether your org should make the shift.

Table of Contents

  1. What Is Salesforce Headless 360?
  2. How Salesforce Headless 360 Works — Architecture Explained
  3. Salesforce MCP Server — A Deep Dive
  4. The Agentforce Experience Layer (AXL)
  5. Developer Walkthrough — Getting Started
  6. Should You Go Headless? A Decision Framework
  7. How Headless 360 Affects Salesforce Roles
  8. Governor Limits and Security
  9. Industry Use Cases
  10. Headless 360 vs Traditional Salesforce
  11. Frequently Asked Questions

What Is Salesforce Headless 360?

Salesforce Headless 360 is Salesforce's 2026 initiative that turns the entire platform into a programmable backend. Every capability that previously required a user to log in, click through Setup menus, or navigate Lightning pages is now accessible through three surfaces: REST APIs, Model Context Protocol (MCP) tools, and sf CLI commands.

Parker Harris, Salesforce co-founder, framed it plainly from the TDX stage: the question isn't whether you can work without a browser — it's why you'd choose to work with one when agents can handle it directly.

The Three Core Innovations

Headless 360 ships with three distinct innovations that work together:

MCP Tools and Coding Skills: More than 60 new MCP tools and 30+ preconfigured coding skills give AI coding agents — like Claude Code, Cursor, Codex, and Windsurf — complete, live access to your org's data, metadata, workflows, and business logic. Your coding agent can query records, deploy Apex classes, run tests, and inspect results without you switching tabs.

Agentforce Experience Layer (AXL): A new UI service that separates what an agent does from how it appears. Agents can deliver rich interactive components — approval cards, rebooking workflows, data layouts — that render natively inside Slack, Teams, WhatsApp, or any MCP-compatible client. Build the logic once; AXL handles surface-specific rendering.

Agent Lifecycle Tools: Testing Center, Custom Scoring Evals, Agent Script, Session Tracing, and A/B Testing give you control over agent behavior before and after launch. These tools address the core challenge with AI agents: they're probabilistic, not deterministic. You need to observe, evaluate, and tune — not just deploy and hope.

How Salesforce Headless 360 Works — Architecture Explained

Understanding Headless 360 requires looking at two layers: the four programmable surfaces agents use to access the platform, and the four platform layers that give those surfaces their power.

The Four Programmable Surfaces

REST and Agentforce APIs are the foundation. Salesforce has had REST APIs since 2006, but Headless 360 adds explicit agent-accessible documentation, token-scoped access patterns, and the Agentforce REST API for invoking agent sessions from external systems.

MCP (Model Context Protocol) is the biggest net-new addition. It's an open standard that lets AI assistants connect to external tools without custom integration code. The Salesforce MCP server (@salesforce/mcp) ships with the DX toolchain and exposes 60+ tools across seven categories. We'll dig into this in the next section.

sf CLI Commands bring a scriptable, CI/CD-friendly interface. The new sf agent topic lets you generate agent specs from plain-language descriptions, deploy them, and run evaluation tests — all from the terminal.

Slack and Voice serve as the primary human-facing surfaces. Custom AI agent deployments on Slack have grown 300% since January 2026. Slack isn't just where humans chat anymore — it's where agents surface structured outputs, approvals, and workflows through the Experience Layer.

The Four Platform Layers

Salesforce positions Headless 360 as the access layer over four existing investments:

LayerProductWhat It Does
System of ContextData 360All your trusted business data — unified, real-time, ready for agents
System of WorkCustomer 360Decades of business logic and workflows across sales, service, and every function
System of AgencyAgentforceBuild, deploy, and manage agents across every channel
System of EngagementSlackWhere humans and agents come together to get work done

This is what separates a coding agent that writes code from one that understands your business. A coding agent connected to a raw database doesn't know that a customer has an open escalation, a renewal due in 30 days, and a breached SLA. That context lives in Salesforce — and now, Data 360 exposes it as an API, MCP tool, or CLI command.

Salesforce MCP Server — A Deep Dive

The Salesforce MCP server is where Headless 360 gets practical for developers. It ships as @salesforce/mcp with the Salesforce DX toolchain and connects your AI coding agent directly to your org.

The Seven Toolsets

ToolsetWhat It Does
metadataDeploy and retrieve metadata between DX projects and orgs
dataExecute SOQL queries against live orgs
testingRun Apex tests and agent evaluation tests
lwcCreate LWC components, generate Jest tests, accessibility guidance
code-analysisStatic analysis via Salesforce Code Analyzer
devopsCI/CD pipeline access through DevOps Center MCP
auraMigration blueprints, LWC transition guidance

Setup in Under a Minute

Install and configure via NPX:

npx -y @salesforce/mcp --orgs myDevOrg --toolsets metadata,data,testing

Once configured, your AI coding agent picks up the tools automatically. From that point, the agent can query your org, write an Apex class, deploy it, run tests, and inspect results — all within one conversation thread.

A practical tip: Don't enable all 60+ tools at once. That will overwhelm your LLM's context window. The --toolsets flag exists for a reason. Start with metadata and data, then add toolsets as your use case demands.

The --allow-non-ga-tools flag unlocks pre-release functionality. Keep this to development environments only.

DevOps Center MCP and Natural Language DevOps

The DevOps Center MCP brings programmatic access into your CI/CD pipeline. Natural Language DevOps means you describe what you want to deploy and your agent handles execution. The build loop that used to require context-switching across four different tools now happens inside one connected experience.

For teams already running Salesforce DevOps pipelines, this is a direct upgrade to how you ship code.

The Agentforce Experience Layer (AXL) — Build Once, Render Everywhere

Most coverage of Headless 360 glosses over AXL, but it's arguably the most forward-looking piece of the announcement.

Here's the problem AXL solves: an AI agent might complete a task perfectly — rebooking a flight, approving a discount, surfacing a renewal summary — but the output needs to look different depending on where the user sees it. A Slack message looks nothing like a WhatsApp card, which looks nothing like a ChatGPT response.

AXL separates the agent's action from its visual presentation. You define the component once — a decision tile, a data layout, a workflow card — and AXL renders it natively on whatever surface the user is working in.

Supported surfaces today: Slack, Mobile, ChatGPT, Claude, Gemini, Teams, and any client that supports MCP apps.

This matters because the conversation is becoming the interface. Work that used to pull people out of their communication channel to log into Salesforce now happens right where they already are. Approvals, decisions, rich data views — all inside the channels your team uses daily.

For enterprises building multi-channel customer experiences, AXL means you design the workflow once and let the platform handle the rendering. That's a significant reduction in front-end development effort.

Developer Walkthrough — Getting Started with Headless 360

Here's a practical end-to-end flow: generate an agent spec, deploy it, and run evaluation tests — all from the terminal, no browser required.

Step 1: Authorize Your Org

For development environments, use web-based OAuth:

sf org login web --alias myDevOrg --instance-url https://login.salesforce.com

For CI/CD pipelines (truly headless), use JWT:

sf org login jwt --client-id CONNECTED_APP_CONSUMER_KEY --jwt-key-file server.key --username deployer@mycompany.com --alias myCIOrg

JWT auth requires a Connected App configured with the JWT OAuth flow and a certificate uploaded to Salesforce. The certificate upload step is the most common failure point in headless CI setups — don't skip it.

Step 2: Generate an Agent Spec

sf agent generate agent-spec --type customer-facing --role "Handle tier-1 billing support questions and escalate unresolved cases" --company-description "B2B SaaS, Enterprise edition, 500-seat customer base" --max-topics 4 --tone professional --output-file specs/billingAgentSpec.yaml --target-org myDevOrg

This outputs a YAML specification including the agent definition and up to four subagent topics. Pass --spec specs/billingAgentSpec.yaml to iterate and refine rather than starting from scratch each time.

Step 3: Deploy and Test

sf project deploy start --source-dir force-app --target-org myDevOrg --wait 10
sf agent test run --target-org myDevOrg

Your AgentDefinition files live in force-app/main/default/botDefinitions/ — version-controlled, diffable, and code-reviewable. That's the point.

Once @salesforce/mcp is configured in your coding agent, it can do all of this autonomously. You describe the goal; the agent handles the rest. If your team needs help setting up this pipeline, working with an experienced Salesforce engineering partner can save weeks of trial and error.

Should You Go Headless? A Decision Framework

Not every org needs Headless 360 right now. Here's a practical framework for deciding.

When Headless 360 Makes Sense

  • Your org is API-heavy. You already run significant integration traffic and your daily API consumption is well-managed. Adding agent-driven API calls fits naturally.
  • You're building multi-channel experiences. If your users interact through Slack, mobile apps, WhatsApp, or partner portals — and you're tired of rebuilding the UI for each surface — AXL and headless APIs solve that problem.
  • You have agentic workflows planned. If your roadmap includes AI agents that query data, trigger workflows, and deploy metadata, Headless 360 gives those agents a native path into the platform.
  • Your development team is comfortable with CLI and CI/CD. The sf CLI and MCP server assume developers who work in terminals, not Setup menus.

When to Stay with Traditional UI

  • Your team is admin-heavy with limited developer capacity. Headless 360 is a developer-first paradigm. If your org runs primarily on declarative tools — Flow Builder, Process Builder, point-and-click Setup — the ROI of going headless is lower right now.
  • Your API consumption is already near limits. Enterprise Edition orgs start at 100,000 REST API calls per rolling 24-hour window. Agentic workflows calling Salesforce every few seconds can drain that fast. Do the math before flipping the switch.
  • You're a small org with straightforward needs. If five reps use Salesforce for basic contact and opportunity management, headless architecture adds complexity without proportional value.

The smart play for most organizations is a phased approach: start headless for developer tooling and CI/CD, expand to agentic workflows in a sandbox, and roll out to production after you've built solid evaluation test suites.

How Headless 360 Affects Salesforce Roles

This is the question nobody's answering directly, but everyone on Salesforce community forums is asking: what does this mean for my job?

For Developers

This is the biggest productivity shift in years. Switching between Setup, Developer Console, VS Code, and three browser tabs to make one change is ending. A coding agent that can query your org, write code, deploy it, and validate it — all within one conversation thread — changes how you spend your day.

The tradeoff: you're trusting an AI to write and deploy code. Build solid evaluation test suites before letting an agent near staging, let alone production.

For Admins

You won't need to log in as often. That's good news — fewer context switches, less clicking through nested Setup menus. But your work shifts toward configuration governance: making sure OAuth scopes are tight, reviewing Session Traces when something goes wrong, and understanding what an agent actually did.

Loose field-level security and sharing rules don't get worse with Headless 360, but the consequences become more visible faster. An agent hitting the API 500 times a minute doesn't pause to question whether a field should be readable.

For Architects

The interesting question: where does your integration layer live now? When any MCP-compatible AI agent can reach your org directly, the API gateway conversation becomes more important, not less. Named credentials, connected app scopes, IP allowlisting, and per-agent rate limits matter more than ever.

For Consulting Partners

Headless 360 opens new service models. Salesforce consulting partners that already offer DevOps automation, org re-engineering, and integration services are well-positioned. The shift creates demand for MCP server configuration, agentic workflow design, API governance strategy, and agent evaluation frameworks — services that didn't exist a year ago.

Governor Limits and Security in Headless 360

Agents don't get special treatment from governor limits. Every API call from an MCP tool or sf CLI command counts against your daily allocation.

Key Limits to Watch

ResourceEnterprise Edition DefaultNotes
Daily API calls (rolling 24h)100,000Pooled across REST, SOAP, Bulk, and Connect
Connect REST rate limitPer-app, per-user, per-hourReturns 503 when exceeded
SOQL queries per transaction100Applies to synchronous Apex in agent tools
DML statements per transaction150Governor limits don't bend for agents
Heap size (sync / async)6 MB / 12 MBApex called by agent tools is subject to this

OAuth Best Practices

Use JWT OAuth flow for headless agent authentication — no browser redirect, certificate-based auth. Scope your Connected App to only the OAuth scopes your agent actually needs:

  • api — access to REST/SOAP APIs
  • refresh_token — keep sessions alive
  • Omit web — not needed for headless; removing it reduces attack surface

Use Named Credentials to manage org credentials for agent-to-org connections. They keep auth details out of your code and out of your agent's context.

Einstein Trust Layer

The Einstein Trust Layer applies to every Agentforce session, browser or not. It enforces data masking of PII fields before they reach external LLMs, zero-data-retention agreements with LLM providers, dynamic grounding against your org's actual data, and field-level security compliance. Agents respect FLS and sharing rules — the same guardrails your IT team already approved.

Industry Use Cases for Salesforce Headless 360

Headless 360's impact varies by industry. Here are three scenarios where the architecture delivers the most value.

Manufacturing and Automotive

In manufacturing, dealer management systems often run on a mix of SAP, Salesforce, and custom portals. Headless 360 lets AI agents pull real-time inventory, trigger quote generation, and update dealer incentive records through APIs — without anyone logging into Salesforce. For organizations running complex Salesforce integrations with ERP systems, this removes a layer of manual handoff.

In our experience working with automotive clients, the biggest friction point is the handoff between systems. An agent that can reach both SAP and Salesforce through MCP tools eliminates that context switch entirely.

Banking and Financial Services

Loan origination workflows — from application to approval to disbursement — involve multiple approval chains, credit checks, and compliance validations. These processes already run in Salesforce, but they required human navigation through each step. With Headless 360, an AI agent can trigger the full workflow through APIs, surface approval cards in Slack, and log every action for audit trails.

The Einstein Trust Layer is especially relevant here. PII masking and zero-data-retention policies address the compliance requirements that make BFSI orgs cautious about AI adoption.

Healthcare and Life Sciences

Patient engagement workflows — appointment scheduling, care plan updates, prescription follow-ups — are high-volume, repetitive, and time-sensitive. Headless 360 lets these workflows run through APIs while surfacing only the decisions that need a human in Slack or a mobile app.

The key here is that HIPAA-compliant sharing rules carry through to headless interactions. The Trust Layer doesn't change because the surface changes.

Headless 360 vs Traditional Salesforce — Complete Comparison

CriteriaTraditional SalesforceSalesforce Headless 360
Primary interfaceLightning Experience (browser)APIs, MCP tools, CLI, Slack
Who interactsHumans click through UIHumans and AI agents call APIs
Development modelDeclarative + code in browser/IDEAPI-first, terminal-driven, agent-assisted
DeploymentChange sets, Metadata API via IDEsf CLI, DevOps Center MCP, Natural Language DevOps
Multi-channel outputRequires custom builds per channelAXL renders once, displays everywhere
Speed of executionLimited by UI navigation speedLimited by API rate limits and agent reasoning
Best forAdmin-heavy orgs, simple workflowsDeveloper-driven orgs, agentic workflows, multi-channel
Learning curveFamiliar to all Salesforce usersRequires CLI, OAuth, and MCP knowledge
Trust and securityStandard FLS, sharing rulesSame FLS and sharing + Einstein Trust Layer for AI

Neither approach replaces the other. Traditional Lightning Experience isn't going away — millions of users depend on it daily. Headless 360 adds a parallel access path optimized for agents and developers. The two will coexist for years, and smart Salesforce strategy means knowing when to use each one.

Frequently Asked Questions

What is Salesforce Headless 360?

Salesforce Headless 360 is a platform initiative announced at TrailblazerDX 2026 that exposes every Salesforce capability — CRM, Agentforce, Data Cloud, Slack — as APIs, MCP tools, and sf CLI commands. AI agents and developers can access data, trigger workflows, and deploy code without opening a browser.

Is Salesforce Headless 360 generally available?

The core package — including @salesforce/mcp and sf agent commands — shipped in April 2026. Some toolsets remain in Beta or Developer Preview. The --allow-non-ga-tools flag unlocks pre-release tools for development environments. Check the Salesforce CLI Release Notes for current GA status.

Do MCP tool calls count against API limits?

Yes. Every API call from an MCP tool or sf CLI command counts against your daily API limit — 100,000 for Enterprise Edition by default. Agentic workflows that run many queries or deployments in sequence can drain your quota faster than traditional integrations. Monitor usage via Setup and set API usage alerts.

Can I use Headless 360 with non-Salesforce AI agents?

Yes. Any MCP-compatible AI agent can connect to the Salesforce MCP server. The Connect REST API and Agentforce REST API are standard HTTP/OAuth surfaces accessible from any programming language or framework. The sf CLI is Node.js-based and runs in any CI/CD environment.

How does the Einstein Trust Layer work in headless mode?

The Einstein Trust Layer enforces data masking, dynamic grounding, field-level security, and zero-data-retention agreements with LLM providers for every Agentforce session — whether triggered from a browser or an API call. Agents running as a Salesforce user respect that user's sharing rules and FLS settings.

Will Headless 360 replace the Salesforce Lightning UI?

No. Lightning Experience isn't going away. Millions of users rely on it daily for tasks where a visual interface is the right tool. Headless 360 adds a parallel access path optimized for AI agents and developers. Both will coexist — Salesforce is expanding how you can interact with the platform, not limiting it.

What happens to Salesforce admins?

Admin roles evolve, not disappear. Day-to-day work shifts from clicking through Setup menus toward governance: managing OAuth scopes, reviewing agent Session Traces, configuring Named Credentials, and monitoring API consumption. The skills change, but the need for someone who understands the org's configuration stays.

Do I need MCP knowledge to use Headless 360?

For the CLI and API surfaces, no — standard REST API and CLI knowledge is enough. For the MCP tools specifically, you'll need to understand how to configure the MCP server and scope toolsets for your AI coding agent. The setup process itself takes minutes, but understanding which toolsets to enable for your use case requires some planning.

Ready to Prepare Your Org for Headless 360?

Salesforce Headless 360 isn't something you flip on overnight. It requires strategic planning — auditing your current API consumption, scoping OAuth permissions, building evaluation test suites, and deciding which workflows benefit from going headless first.

At Minuscule Technologies, we've been helping enterprises re-engineer their Salesforce orgs for over a decade. Our team of 160+ Salesforce experts has delivered 75+ projects globally, from legacy system modernization to AI-powered DevOps pipelines. Whether you're starting from scratch with Headless 360 or migrating an existing org toward an API-first architecture, we can help you get there without the trial-and-error.

Book a free consultation to discuss your Headless 360 readiness.

Contact Us for Free Consultation
Thank you! We will get back in touch with you within 48 hours.
Oops! Something went wrong while submitting the form.

Recent Blogs

Ready to Architect Your Salesforce Success?

You've seen what's possible. Now, let's make it happen for your business. Whether you need an end-to-end Salesforce solution, a complex integration, or ongoing managed services, our team is ready to deliver.

Schedule a Free Strategic Call