Note: This page describes the full version of Fuel AI, which is an add-on to your Emplifi package. If you have Fuel AI Lite, which every customer has by default, you can ask how-to questions and summarize Unified Analytics widgets and boards, but not carry out the tasks on this page. To find out about adding Fuel AI, contact your account manager. See Fuel AI Lite.
If your team already works in an AI tool such as Claude, ChatGPT, Cursor, Codex, or Microsoft Copilot Studio, you can connect it to your Emplifi account through the Emplifi Actions MCP. Once connected, your AI tool can look up your Emplifi data and carry out Emplifi actions on your behalf, from inside the tool you already use. Your AI tool does the thinking; Emplifi provides the hands.
Note: Three things to know before you start
-
The Actions MCP only does what Fuel AI can do. It gives your AI tool the same list of Emplifi actions that Fuel AI uses inside Emplifi. Nothing more. If something isn’t on the list in What you can ask Fuel AI to do, your AI tool can’t do it through the Actions MCP either.
-
The Actions MCP is not the Emplifi API. They are two different things. The Emplifi API is for developers who build integrations with code. The Actions MCP is for AI tools. The Actions MCP doesn’t give you everything the API can do, and the API doesn’t give you what the Actions MCP does. Don’t use one to judge the other.
-
You need the Emplifi API add-on, not Fuel AI. The Actions MCP comes with the API add-on. You don’t need Fuel AI to use it, and it doesn’t use Fuel AI credits. Your AI tool’s own usage applies, as it does for anything else you do in that tool.
If your organization doesn’t have the API add-on, or you’re not sure, contact your account manager.
What is MCP?
MCP stands for Model Context Protocol. It's an open standard that gives AI tools a safe, agreed way to connect to other software, in the same way that a USB port gives any device an agreed way to plug into a computer. An AI tool that supports MCP can connect to any service that offers an MCP server, and most AI tools now do.
Emplifi provides an MCP server, which appears in your AI tool’s connector list as Emplifi Fuel. Emplifi hosts and manages it, so there’s nothing for you to install on a server.
Actions MCP and Fuel Agent MCP
Emplifi offers two ways for an AI tool to work with your account. This page covers the first.
|
|
Actions MCP |
Fuel Agent MCP |
|---|---|---|
|
What it is |
Gives your own AI tool direct access to Emplifi actions: the same reads, searches, creates, and updates that Fuel AI uses inside Emplifi. Your AI tool decides what to do and in what order. |
Lets your own AI tool talk to Fuel AI itself. Fuel AI does the reasoning on Emplifi’s side, using its knowledge of your account, your brand context, and its memory of what has worked before, and then carries out the work. |
|
Who does the thinking |
Your AI tool, using its own usage allowance |
Fuel AI |
|
What you need |
The Emplifi API add-on |
The Fuel AI add-on |
|
Uses Fuel AI credits |
No |
Yes |
|
Available |
Now |
Planned for early 2027 |
What the Actions MCP can do
The Actions MCP gives your AI tool the same actions Fuel AI has, and only those. Today that means your AI tool can list your profiles, search content, pull metrics, create boards, labels, Listening topics, and drafts, and manage Care and Community settings. The full, current list is on What you can ask Fuel AI to do. The list grows as Fuel AI grows.
It works within your Emplifi permissions, so your AI tool can’t do anything you couldn’t do yourself in Emplifi.
What the Actions MCP can’t do
-
It can’t do anything that isn’t on the Fuel AI action list. For example, products that Fuel AI doesn’t cover yet, such as Influencers, Ratings & Reviews, and UGC, aren’t available through the Actions MCP either.
-
It can’t do what the Emplifi API does. If you need bulk data exports, custom integrations, or anything else the API is built for, use the API. The Actions MCP is not a shortcut to the API.
-
It can’t think like Fuel AI. Your AI tool decides which actions to call and in what order, using its own knowledge. It doesn’t have Fuel AI’s understanding of your account, your brand context, or its memory of what has worked before. That is what the Fuel AI MCP will add in early 2027.
Warning: The Actions MCP and the Emplifi API are two different things. Both come with the API add-on, but they don’t do the same job and they don’t have the same coverage. If a task isn’t on the Fuel AI action list, the Actions MCP can’t do it, even if the API can.
Before you begin
Make sure you have the following:
-
The Emplifi API add-on on your Emplifi account, and MCP access switched on for you, via your account manager. If you’re not sure whether you have the API add-on, ask your account manager. See Manage who can use Fuel AI for the user switch.
-
An AI tool that supports MCP. Claude, ChatGPT, Cursor, Codex, Microsoft Copilot and Claude Code all do, and most other MCP-compatible tools should work too.
-
Permission to add connectors in your AI tool. On Claude Team and Enterprise plans, an organization owner needs to add the connector first. See the Claude section below.
There's nothing to install. You connect by giving your AI tool the Emplifi Fuel server address and signing in.
Connection details
Whichever AI tool you use, these are the details you'll need:
|
Setting |
Value |
|
Server name |
Emplifi Fuel |
|
Server address |
|
|
Connection type |
Streamable HTTP |
Note: There is no one-click install from the Claude or ChatGPT marketplaces yet. For now you connect by pasting the server address. A marketplace connector is planned for a later release.
Connect your AI tool
Claude (web or desktop)
How you add the connector depends on your Claude plan.
Team and Enterprise plans
An organization owner adds the connector once for everyone:
-
Go to Organization settings → Connectors.
-
Click Add, hover over Custom, and select Web.
-
Enter https://api.emplifi.io/3/mcp and click Add.
Each member then connects:
-
Go to Customize → Connectors.
-
Find Emplifi Fuel in the list and click Connect.
-
Sign in when prompted. See Sign in to Emplifi below.
Pro and Max plans
-
Go to Customize → Connectors.
-
Click + and select Add custom connector.
-
Enter https://api.emplifi.io/3/mcp and click Add.
-
Sign in when prompted. See Sign in to Emplifi below.
Tip: After adding the connector, turn it on in a chat by clicking + in the message box and selecting it under Connectors.
Cursor
-
Go to Preferences → Cursor Settings → Tools & MCPs.
-
Click + New MCP Server to open the configuration file (mcp.json).
-
Add the following and save the file:
|
{
|
-
Sign in when prompted. See Sign in to Emplifi below.
Codex
-
Go to Settings → Plugins → MCPs.
-
Click + Add Server and select Streamable HTTP.
-
Enter the name Emplifi Fuel and the URL https://api.emplifi.io/3/mcp.
-
Click Save, then sign in when prompted. See Sign in to Emplifi below.
Microsoft Copilot
Microsoft uses the name Copilot for several products, and only one of them connects to MCP servers:
|
Product |
Can it connect to Fuel AI? |
|---|---|
|
Microsoft Copilot Studio |
Yes. This is where you build agents for your organization, and it supports MCP servers. Connect Fuel AI here. |
|
Microsoft 365 Copilot (the Copilot in Teams, Word, and Outlook) |
Not directly. Build an agent in Copilot Studio with Fuel AI connected, then publish that agent to Microsoft 365 Copilot. |
|
The Copilot app (consumer Copilot on the web or your phone) |
No. It doesn’t support custom MCP servers. |
You’ll need a Copilot Studio license and the right to create agents and tools in your environment. Your Microsoft administrator controls both.
To connect Fuel AI to a Copilot Studio agent:
-
Open your agent in Copilot Studio and go to the Tools page.
-
Select Add a tool, then New tool, then Model Context Protocol.
-
Enter the server details:
-
Server name:
Emplifi Fuel -
Server description: a short description, for example “Works with Emplifi social media data, analytics, Listening, Care, and Community, and carries out Emplifi actions.” The agent uses this description to decide when to call Fuel AI, so make it clear.
-
Server URL:
https://api.emplifi.io/3/mcp
-
-
For the authentication type, select OAuth 2.0, then Dynamic discovery. Emplifi Fuel registers itself with Copilot Studio automatically, so you don’t need to enter any client IDs, secrets, or URLs.
-
Select Create, then Next.
-
On Add tool, select Create a new connection and sign in with your Emplifi account. See Sign in to Emplifi below.
-
Select Add to agent.
Each person who uses the agent signs in to Emplifi with their own account the first time the agent calls Fuel AI, so the agent always acts with that person’s Emplifi permissions.
Note: Copilot Studio reaches MCP servers through Power Platform connectors. If your organization has a data policy that restricts custom connectors, your Microsoft administrator needs to allow the Emplifi Fuel connector before it will work.
Claude Code (command line)
Run the following command in your terminal, then complete the sign-in when prompted:
|
claude mcp add Emplifi_Fuel --scope user --transport http https://api.emplifi.io/3/mcp |
Other AI tools
Point your tool at the Streamable HTTP address https://api.emplifi.io/3/mcp and sign in. Any MCP-compatible tool should connect.
Sign in to Emplifi
You sign in once in your browser. There are no API keys to create or store.
-
A browser window opens, or your AI tool shows you a sign-in link.
-
If your login has access to more than one Emplifi account, choose the account you want to connect.
-
Review the consent screen. It shows exactly which Emplifi account and user the connection applies to.
-
Click Approve. Your AI tool is now connected and stays connected until you remove it.
Security and access
-
No API keys. Sign-in uses OAuth 2.0 in your browser, the same standard used for Emplifi's public API. The only thing your AI tool stores is the public server address.
-
Limited permission. The connection lets your AI tool act as you, and nothing more. There is no standing credential that can be used without you.
-
Account-scoped and visible. You choose which Emplifi account to connect, and the consent screen names the exact account and user before you approve.
-
Recorded. Every action your AI tool takes through Emplifi is recorded against your user.
-
Nothing sensitive on your computer. Any settings your AI tool keeps hold only the public server address. Your sign-in is managed by your AI tool, and removing the connector removes it.
Troubleshooting
|
Problem |
What to do |
|
Add custom connector is greyed out, or you see "Ask an organization owner to add this for your team" |
You're on a Claude Team or Enterprise plan, where only an owner can add a connector. Ask your Claude owner to add Emplifi Fuel in Organization settings → Connectors. It then appears under Customize → Connectors for you to connect. |
|
Your organization doesn't allow custom connectors at all |
Your AI tool's administrator controls this setting. Ask them to allow the Emplifi Fuel connector, or contact your Emplifi account team to discuss options. |
|
You don't see Emplifi to sign in to, or access is denied |
Your Emplifi account may not have the API add-on, your user may not have MCP access enabled, or you picked the wrong account. Ask your Emplifi administrator to check, and choose the right account on the selection screen. |
|
Sign-in, registration, or discovery errors |
Check the address is exactly https://api.emplifi.io/3/mcp with no trailing slash. Remove the connector, add it again, and sign in again. |
|
The connection dropped or stopped responding |
Disconnect and reconnect the server from your AI tool's MCP settings. This is a routine reset and doesn't affect your Emplifi data or your sign-in. |
|
You need to sign in as a different Emplifi user or account |
Remove the Emplifi Fuel connector from your AI tool, add it again, and choose the right account when you sign in. |
|
Copilot Studio won’t let you add the server, or the connection is blocked |
Your organization’s Power Platform data policy may restrict custom connectors. Ask your Microsoft administrator to allow the Emplifi Fuel connector, or check that your environment permits new tools. |
Get help
If you're still stuck, contact your Emplifi account team or Emplifi Support. Tell them which AI tool you're using, which step you reached, and the exact text of any error message.
Learn more
-
What you can ask Fuel AI to do (the Actions MCP uses the same actions)