Read Twelfth workspace products, sales, inventory, suppliers, pricing, projects and actions.
One address for any MCP client. You sign in at api.twelfth.ai once, after adding it.

At most: only reads or looks up information.
Odel charges nothing per call. The publisher may charge for its own service.
Odel could not list its tools without signing in.
Connect the AI assistants your team already uses to its Twelfth workspace.
Claude · ChatGPT · GitHub Copilot · Gemini · Cursor · Claude Code · any MCP client
Twelfth is a commercial workspace for retail and category teams. Its hosted MCP server lets an assistant read the products, suppliers, sales, inventory, pricing, projects and open actions that the signed-in person can already see, so questions are answered from your Twelfth workspace rather than from a pasted spreadsheet.
| Endpoint | https://api.twelfth.ai/mcp (Streamable HTTP) |
| Sign-in | OAuth 2.1 with your Twelfth account. Choose the workspace and approve the read tools; no key to copy |
| Access | Read-only. Assistants cannot create, change or commit anything |
| Scope | One workspace, as the person who connected: their role, remits and categories. Owners and admins see and can end every connection |
| Registry | ai.twelfth/workspace, published from the twelfth.ai domain |
| Docs | twelfth.ai/ai · MCP guide |
You need a Twelfth workspace to connect. Book a demo if your team doesn't have one yet.
flowchart LR
A["AI assistant<br/>Claude · ChatGPT<br/>Copilot · Cursor"] -- "1 · adds the URL" --> S["Twelfth sign-in<br/>pick workspace<br/>approve read tools"]
S -- "2 · scoped token" --> A
A -- "3 · read-only calls" --> M["Twelfth MCP<br/>api.twelfth.ai/mcp"]
M -- "4 · as the member" --> W[("Your<br/>workspace")]
ADM["Owner / admin"] -. "sees · ends any connection" .-> M
classDef ink fill:#1e3b2c,stroke:#14291f,color:#f6efdd;
classDef paper fill:#f6efdd,stroke:#1e3b2c,color:#1e3b2c;
classDef gilt fill:#c8a24b,stroke:#1e3b2c,color:#1e3b2c;
class A,ADM paper;
class S,M ink;
class W gilt;
Add Twelfth to .cursor/mcp.json. Cursor sends you to Twelfth to sign in on first use:
{
"mcpServers": {
"twelfth": { "url": "https://api.twelfth.ai/mcp" }
}
}
/plugin marketplace add twelfth-ai/twelfth-mcp
/plugin install twelfth@twelfth
Or just the server: claude mcp add --transport http twelfth https://api.twelfth.ai/mcp
Or add it to .vscode/mcp.json (or your user mcp.json):
{
"servers": {
"twelfth": { "type": "http", "url": "https://api.twelfth.ai/mcp" }
}
}
Start the server, sign in to Twelfth when VS Code asks, then use the tools from Copilot Chat in agent mode.
copilot plugin marketplace add twelfth-ai/twelfth-mcp
copilot plugin install twelfth@twelfth
This adds the server and the twelfth-workspace skill. Copilot asks you to sign
in to Twelfth the first time a tool runs.
gemini extensions install https://github.com/twelfth-ai/twelfth-mcp
Then run /mcp auth twelfth inside Gemini CLI to sign in. The extension adds
the server and the twelfth-workspace skill.
Add a custom connector with the URL https://api.twelfth.ai/mcp and complete
the Twelfth sign-in. Per-assistant guides: twelfth.ai/ai.
A workspace owner or admin can create a labelled, tool-limited key under
Settings → AI & agents → Create an API key and send it as
Authorization: Bearer <key>.
| Control | How it works |
|---|---|
| Read-only by design | Every tool reads. Decisions are reviewed and committed by people inside Twelfth |
| Least privilege | An OAuth connection inherits the member's role and remits and stops working when they leave the workspace. Tools are chosen at consent |
| Admin visibility | Owners and admins see every connection, the client and version that connected, and can end any of them. An ended connection is refused on its next request |
| Keys | Created only by owners and admins, labelled by environment, limited to selected tools, stored hashed and shown once |
| Audit | Each call is logged with tool, outcome, time and duration. Tool results are never stored or sent to analytics; only their size is recorded |
| Compliance | Controls, sub-processors and our SOC 2 / ISO 27001 programme: trust.twelfth.ai |
This repository holds client configuration only; the server is hosted and operated by Twelfth AI Pty Ltd.
| Path | What |
|---|---|
plugins/twelfth/ | The plugin: MCP config for Cursor (mcp.json) and Claude Code (.mcp.json), and a twelfth-workspace skill that helps the assistant use the tools well |
.cursor-plugin/, .claude-plugin/ | Marketplace manifests for Cursor and Claude Code |
gemini-extension.json, skills/ | The Gemini CLI extension. skills/ is a copy of the plugin's skills; node scripts/validate-template.mjs fails if they drift |
Twelfth AI Pty Ltd · ACN 695 769 138 · Australia
The contents of this repository are MIT licensed. The Twelfth service is governed by its terms.
smithery-verification=0c586824f907c08ca5140641c9ddc0c07e5e1574fd305497c14360c7f4ded531