Twelfth
Read Twelfth workspace products, sales, inventory, suppliers, pricing, projects and actions.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http twelfth 'https://api.twelfth.ai/mcp'{
"mcpServers": {
"twelfth": {
"type": "http",
"url": "https://api.twelfth.ai/mcp"
}
}
}التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
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 tools; no key to copy |
| Access | Reads by default. Changes are opt-in: tick Allow changes when connecting and the assistant can create, complete or snooze your own actions and run your own routines, as you. None raises an order or changes a price |
| 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.
How it connects
flowchart LR
A["AI assistant<br/>Claude · ChatGPT<br/>Copilot · Cursor"] -- "1 · adds the URL" --> S["Twelfth sign-in<br/>pick workspace<br/>approve tools"]
S -- "2 · scoped token" --> A
A -- "3 · tool 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;Install
Cursor
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" }
}
}Claude Code
/plugin marketplace add twelfth-ai/twelfth-mcp
/plugin install twelfth@twelfthOr just the server: claude mcp add --transport http twelfth https://api.twelfth.ai/mcp
VS Code and GitHub Copilot
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.
GitHub Copilot CLI
copilot plugin marketplace add twelfth-ai/twelfth-mcp
copilot plugin install twelfth@twelfthThis adds the server and the twelfth-workspace skill. Copilot asks you to sign
in to Twelfth the first time a tool runs.
Gemini CLI
gemini extensions install https://github.com/twelfth-ai/twelfth-mcpThen run /mcp auth twelfth inside Gemini CLI to sign in. The extension adds
the server and the twelfth-workspace skill.
Claude, ChatGPT, Gemini and other clients
Add a custom connector with the URL https://api.twelfth.ai/mcp and complete
the Twelfth sign-in. Per-assistant guides: twelfth.ai/ai.
Servers and scripts
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>.
Security and governance
| Control | How it works |
|---|---|
| Reads by default | Every tool reads unless the person ticks Allow changes on the consent page. Write tools are offered only over OAuth, only after that opt-in, and act only on the person's own actions and routines. Workspace keys never make changes. Orders, prices and other commercial decisions are still 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 |
Skills
The plugin ships eight Agent Skills. The server also
serves them over the MCP Skills extension (skills/list), so an assistant that
supports it gets them without installing anything.
Retail analysis. These work on a spreadsheet or pasted data. No Twelfth account is needed.
| Skill | Use it to |
|---|---|
sales-decline-diagnosis | Find out why sales of a category, supplier or product fell: split the change into units, price, mix and returns, then test the causes cheapest first |
category-review | Review a category: its role, scorecard, availability, return on stock, range and promotions, and what to do next |
range-review | Decide which lines to keep, cut or add, using where a cut line's shoppers would go and stock you've already bought |
supplier-offer-review | Read a supplier's stock list or offer against your sales and cover: what to buy, how much, and what's missing |
competitor-price-check | Check price position on matched products: listing errors, pack sizes, member and promo prices, a weighted index, and whether to match |
Twelfth. These need the Twelfth connection.
| Skill | Use it to |
|---|---|
twelfth-workspace | Get started: which workspace is connected, what the tools can see, and how changes work |
twelfth-weekly-trading-brief | Write Monday's brief: actions due, suppliers waiting, cover pressure, price position and three things to do first |
twelfth-competitor-pricing | Answer pricing questions from tracked sets, competitor comparisons and price history |
Each retail-analysis skill ends with what changes when Twelfth is connected.
What's in this repo
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 the eight skills above |
.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 |
Support
- Questions and enterprise enquiries: hello@twelfth.ai
- Security reports: security.txt
- Privacy: twelfth.ai/legals/privacy
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
الأسئلة الشائعة
ما هو Twelfth؟
Read Twelfth workspace products, sales, inventory, suppliers, pricing, projects and actions.
كيف أثبّت Twelfth؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http twelfth 'https://api.twelfth.ai/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Twelfth إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل Twelfth مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Twelfth؟
ينشره twelfth-ai. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.