> Skip to main content
Acenda
Log in Book a Demo
Book a Demo
Acenda MCP

Give your AI agent access to your Acenda analytics with Acenda MCP.

Claude, ChatGPT, Gemini, Grok — any MCP-capable assistant can answer questions about your store by querying your organization’s analytics directly. Read-only, scoped to your organization, signed in with your own Acenda account. No API keys.

Let your assistant connect itself

One prompt works in every assistant.

AI assistants change their settings screens constantly, so step-by-step screenshots go stale fast. Instead, copy the prompt on the right, paste it into your assistant, and it will walk you through connecting in its own current interface.

  1. Step 1Type your organization slug in the box on the right.
    The prompt fills it in for you as you type.
  2. Step 2Click Copy prompt.
    The whole message — with your slug already in place — is copied for you.
  3. Step 3Paste it into your AI assistant and send.
    The assistant walks you through adding the connector in its own current settings screens.
  4. Step 4Sign in with your Acenda credentials when asked.
    A browser window opens — use your normal Acenda login. No API keys involved.
  5. Step 5Let it run the test query.
    The prompt ends by checking total orders for the last 7 days — if that answers, you’re connected. Some assistants need a paid plan or admin approval for custom connectors; the assistant will tell you if yours does.
It’s in your Acenda admin address bar: admin.acenda.io/your_org
2. Copy your ready-made prompt
{{ slugStatus }}
Help me connect this assistant to my company’s Acenda MCP server so I can ask questions about our store’s orders, sales, products, marketplaces, and returns.

Connection details
• MCP server URL: https://api.acenda.io/v1/mcp/{{ slugShown }}
• Organization: the identifier at the end of the URL above. If it still says YOUR_ORG, ask me for my Acenda organization identifier before continuing.
• Authentication: OAuth. I sign in through the browser using my normal Acenda credentials. No API keys or manually configured client IDs are required.
• Access: Read-only analytics, limited to the organization specified in the URL.

Make setup easy to follow
Help me keep this conversation visible while I configure the connection in a second window, ideally side by side. If sign-in opens another browser window, explain how to return afterward.

Give me one short, numbered step at a time and wait for me to say “done” or describe what I see before continuing. Put any URL or value I need to copy on its own line in a code block. Keep track of our progress so I can say “resume setup” if I lose my place.

What I need you to do
1. Identify the app I’m using. If you can’t determine it, ask me.
2. Check this app’s current official instructions for adding a custom MCP server, connector, or connected app. Use the exact menu and setting names; don’t guess. If you can’t verify the current interface, say so.
3. Guide me through arranging the two windows, then adding the Acenda connection using the details above. Complete any supported setup actions yourself. Let me enter my credentials and approve OAuth access in the browser; never ask me to paste passwords or tokens into chat.
4. If setup is unavailable, explain the specific limitation and any verified plan, setting, or administrator approval required. Don’t assume an upgrade is necessary.
5. After connection, use the Acenda tools to retrieve total orders in the last 7 days. Report the result, organization, exact date range, and timezone. Confirm success only if the query actually succeeds; otherwise, explain the error and the next troubleshooting step.
3. Paste it into your assistant’s chat
Send it like a normal message.
Claude ChatGPT Gemini Grok
4. Follow the instructions within your agent
It walks you through connecting and signing in with your Acenda login. If it asks for the connection link again, enter your MCP server URL:
https://api.acenda.io/v1/mcp/{{ slugShown }}

Which assistants are tested?

The Acenda MCP server follows the open Model Context Protocol, so it should work with any MCP-capable client. Here is what we have actually tested so far.

Tested and working
Gemini
Gemini with MCP extensions enabled.
Tested
Claude
The Claude app and claude.ai, with the server added as a connector.
Tested
ChatGPT
ChatGPT with developer-mode connectors.
Tested
Grok
The Grok app and grok.com.
Tested
Not yet tested
Claude Code
Anthropic’s terminal-based coding tool. Different client from the Claude app; we have not verified it yet.
Not yet tested
Grok Bot
Grok inside X. Separate integration from the Grok app; we have not verified it yet.
Not yet tested

We haven’t had a chance to try Claude Code or Grok Bot yet, so we can’t promise they work smoothly — there may be a few rough edges. We’ll update this page as we test more clients, and we’d love to hear from you if you give one a try.

Once connected

Ask in plain English.

“What were my sales by marketplace last month?”
“Top 10 products by revenue this quarter — and how do returns compare?”
“How is average order value trending week over week?”
Troubleshooting

If something doesn’t connect.

Sign-in works but the connection is refused

Your Acenda account needs access to the organization in the URL. If you can’t open that organization in the Acenda admin, contact your Acenda representative, then reconnect.

What goes in place of the organization slug?

The short name of your organization — the part right after the domain in the Acenda admin. The URL must include it: the assistant is scoped to exactly that organization and can’t switch organizations mid-chat.

My assistant says custom connectors aren’t available

Most assistants gate custom MCP servers behind a paid plan, a developer setting, or workspace-admin approval. Paste the prompt above and the assistant will tell you exactly what to enable on your plan.

The assistant says the connection expired

Access tokens expire periodically. Open the assistant’s connector settings and reconnect — you’ll go through the same Acenda sign-in again.

Is my data safe?

Access is read-only analytics, scoped to one organization, and every query runs as you — with the same permissions your Acenda account has. Nothing can be created, changed, or deleted through this connection. Disconnect any time from the assistant’s settings.

Which assistants work?

Tested and working: Gemini, Claude, ChatGPT and Grok. Claude Code and Grok Bot are different clients from the Claude and Grok apps and have not been tested yet — they may have compatibility issues. Other MCP-capable assistants that support remote servers with OAuth may also work; see the compatibility list above.

MCP disclaimer

Use at your own risk. Acenda’s MCP server and related AI-powered functionality are provided as an assistive tool and may produce inaccurate, incomplete, outdated, or unexpected results. AI systems may “hallucinate,” misinterpret instructions, or act on incorrect information. You are responsible for reviewing and validating all MCP-generated outputs before relying on them. Acenda makes no warranties regarding the accuracy, reliability, availability, or fitness of MCP functionality and assumes no liability for errors, omissions, data loss, unintended actions, business interruption, or other damages resulting from its use. By using the Acenda MCP server, you acknowledge and accept these risks.

Acenda MCP FAQ

What is the Acenda MCP server?

An MCP (Model Context Protocol) server that lets an AI assistant query your Acenda account — sales trends, stuck orders, low stock, channel health — in plain English, using the same open protocol other tools use.

Which AI assistants work with it?

Tested and working: ChatGPT, Claude, Gemini and Grok. Claude Code and Grok Bot have not yet been tested and may have compatibility issues; we will update this page as we test more clients.

How do I connect?

Copy the setup prompt on this page into your assistant with your Acenda organization slug. The prompt walks the assistant through adding the server. If anything doesn’t connect, the troubleshooting section above covers the common causes.

Can the assistant change data in my account?

The MCP server is read-focused for queries. Review and validate any MCP-generated output before relying on it — see the disclaimer above.

Is there an extra charge for MCP access?

MCP access is included for Acenda clients. Questions about access go to your Acenda representative or contact us.

Questions about MCP access? Contact us or talk to your Acenda representative.