# Concierca AI

> Concierca AI documentation — user guide and MCP API reference. Configure AI agents on your company's data: missions, knowledge, memory, skills and integrations.

## Docs

- [Your First 10 Minutes](https://agents.concierca.ch/guide/first-run.md): The welcome wizard: company profile, departments, your AI provider key, and your first agent — from empty workspace to first agent run.
- [Introduction](https://agents.concierca.ch/index.md): Welcome to your project
- [Overview & Navigation](https://agents.concierca.ch/guide/introduction.md): What Concierca AI is, the app shell, sidebar, search, departments, roles, and credits.
- [Quickstart](https://agents.concierca.ch/quickstart.md): Begin with a guide on the fastest path to a successful outcome
- [Chat](https://agents.concierca.ch/guide/chat.md): Talking to your company assistant: conversations, context, slash commands, and the Data Assistant.
- [Inbox](https://agents.concierca.ch/guide/inbox.md): Your company inbox: messages, questions, and escalations from agents — and how to answer them.
- [Company Hub](https://agents.concierca.ch/guide/company-hub.md): Strategy, SOP, and Decisions views, and the admin-only Brain page.
- [Agents](https://agents.concierca.ch/guide/agents.md): Creating and configuring agents: briefing, skills, tools, data access, triggers, and the hierarchy.
- [Hierarchy](https://agents.concierca.ch/guide/agent-hierarchy.md): The agent org chart and the delegation protocol: reports-to chains, handoffs, and delegated runs.
- [Runs](https://agents.concierca.ch/guide/agent-runs.md): The live table of every agent execution, plus per-run detail.
- [Agent Decision Log](https://agents.concierca.ch/guide/agent-decision-log.md): The audit trail of agent decisions, tool calls, escalations, and self-heal events.
- [Agent Inbox](https://agents.concierca.ch/guide/agent-inbox.md): The agent-to-agent message log: handoffs, delegated tasks, and reports up the chain.
- [Analytics](https://agents.concierca.ch/guide/agent-analytics.md): A dashboard of agent cost, performance, and reliability.
- [Cost](https://agents.concierca.ch/guide/agent-cost.md): The Agent Cost Dashboard: budget, spend by agent, and the most expensive runs.
- [Missions](https://agents.concierca.ch/guide/missions.md): Multi-step agent workflows: blueprints, runs, artifacts, approvals, and budgets.
- [Knowledge](https://agents.concierca.ch/guide/knowledge.md): The company knowledge base: entries, categories, importance, and visibility.
- [Memories](https://agents.concierca.ch/guide/memories.md): What agents remember: saving, editing, and scoping memories.
- [Skills & Skills Review](https://agents.concierca.ch/guide/skills-sops.md): Reusable how-to instructions for agents, and the admin Skills Review queue.
- [Templates & Marketplace](https://agents.concierca.ch/guide/templates.md): Knowledge templates and the agent template marketplace (admin).
- [How Your Workspace Learns](https://agents.concierca.ch/guide/learning.md): The nightly curator: how repeated successes and failures become proposed skills and knowledge — always with your approval.
- [Your Data](https://agents.concierca.ch/guide/data.md): A plain-language map of every data domain in your workspace — what each one holds and where to find its details.
- [Data Views](https://agents.concierca.ch/guide/data-views.md): Table views over your business data: filtering, columns, editing, and the visibility picker.
- [Purchasing & Procurement](https://agents.concierca.ch/guide/procurement.md): How the procurement system turns sales history into one clear buying decision per SKU: the Procurement Queue, Purchase Orders, Suppliers, and the supporting analytics views.
- [Automate with AI (MCP)](https://agents.concierca.ch/guide/automate-with-ai.md): Your entire workspace is operable by AI: connect Claude, ChatGPT, or any MCP client and give it 136 governed tools across agents, missions, data, knowledge, and market intelligence.
- [Connect via MCP](https://agents.concierca.ch/guide/mcp-connect.md): The human setup guide: what MCP is, your workspace endpoint, connecting Claude and ChatGPT, getting a key, and your first calls.
- [Every MCP Tool](https://agents.concierca.ch/guide/mcp-tools.md): The full catalog of all 136 tools your workspace exposes over MCP, grouped by resource with a one-line purpose each.
- [CLI](https://agents.concierca.ch/guide/mcp-cli.md): The concierca terminal client: install-free invocation, MCP key setup, environment variables, and the full command set.
- [Connections](https://agents.concierca.ch/guide/connections.md): Connecting external tools: OAuth integrations, per-tool controls, and MCP access.
- [Approvals](https://agents.concierca.ch/guide/approvals.md): Reviewing and resolving actions that agents need your sign-off for.
- [Settings](https://agents.concierca.ch/guide/settings.md): Personal and company settings: account, preferences, users, departments, branding, billing, and monitoring.
- [FAQ & Troubleshooting](https://agents.concierca.ch/guide/faq.md): Frequently asked questions, fixes for typical problems, and how to get help.
- [Operating Contract](https://agents.concierca.ch/api/ai/operating-contract.md): The session-start contract every MCP client should follow: ground, discover, then act.
- [What are you trying to do?](https://agents.concierca.ch/api/ai/routing.md): Use-case-first routing: map an intent to the exact tool sequence.
- [Writes, dry-run & readable≠writable](https://agents.concierca.ch/api/ai/writes-and-safety.md): How to write safely: dry-run first, replacement vs additive fields, and the human gate.
- [Mission Recipes](https://agents.concierca.ch/api/ai/mission-recipes.md): Operating recipes for missions: explain, start safely, diagnose, control, edit, and compare.
- [Vertical Playbook](https://agents.concierca.ch/api/ai/vertical-playbook.md): How an AI uses the market-intelligence layer: start with the legend, route by question, ground every answer.
- [Introduction](https://agents.concierca.ch/api/introduction.md): What the MCP server is, endpoints, supported clients, and versioning.
- [All Tools](https://agents.concierca.ch/api/tools.md): Every tool the Concierca AI MCP exposes — 136 in total — grouped by resource, with a one-line purpose and a link to full detail.
- [Authentication](https://agents.concierca.ch/api/authentication.md): OAuth connect flow, API keys, per-tool scopes, admin vs. member surface, and reconnect behavior.
- [Conventions](https://agents.concierca.ch/api/conventions.md): Tool naming, session bootstrap, common parameters, errors, limits, dry-run, and router mode.
- [Connect via MCP](https://agents.concierca.ch/api/mcp.md): Connect the Concierca AI MCP server from Claude, ChatGPT, or any MCP client — endpoint, authentication, and client setup.
- [Ingest API](https://agents.concierca.ch/api/ingest.md): Push external data into your workspace: API keys, endpoint pattern, idempotent upserts, errors, and Make.com templates.
- [CLI](https://agents.concierca.ch/api/cli.md): The concierca terminal client: install-free invocation, MCP key setup, and the v1 command set.
- [Decisions](https://agents.concierca.ch/api/data-model/decisions.md): Process decisions and bottleneck interviews — one row per question, from the situation through the human response and the rule it becomes. Ingest-enabled.
- [Strategy](https://agents.concierca.ch/api/data-model/strategy.md): Company strategy documents — the knowledge base filtered to category=strategy.
- [SOP](https://agents.concierca.ch/api/data-model/sop.md): Standard operating procedures — the knowledge base filtered to category=sop.
- [Data](https://agents.concierca.ch/api/data.md): The registry-driven view/table model, data_view_list, data_query, row writes, and view management.
- [Row Write Tools](https://agents.concierca.ch/api/write-tools.md): The per-table insert_<table> / update_<table> grants — the granular write surface behind data_row_create / data_row_update.
- [Agents](https://agents.concierca.ch/api/agents.md): Agent CRUD, runs, schedules, version history, stats, and connection checks.
- [Missions](https://agents.concierca.ch/api/missions.md): Mission CRUD, runs, steps, drafts, diagnostics, runtime control, and roster.
- [Knowledge](https://agents.concierca.ch/api/knowledge.md): Knowledge base search, read, save, edit, and archive.
- [Memory](https://agents.concierca.ch/api/memory.md): Memory search, read, save, edit, and archive.
- [Skills](https://agents.concierca.ch/api/skills.md): Skill list, read, create, edit, link, and archive.
- [Inbox](https://agents.concierca.ch/api/inbox.md): User inbox list, read, mark read, and reply.
- [Approvals](https://agents.concierca.ch/api/approvals.md): Human-in-the-loop approval list and resolve.
- [Administration](https://agents.concierca.ch/api/admin.md): Users, departments, categories, grantable tools, guardrails, self-learning, credits, pricing, and provider ledger.
- [Vertical (market intelligence)](https://agents.concierca.ch/api/vertical.md): Watch Market Intelligence: the federated vertical layer. All 16 tools — live market feed, brand/model cards, search, compare, benchmarks, market density, know-how and lookups.
- [Orders](https://agents.concierca.ch/api/data-model/orders.md): E-commerce orders with status tracking — Shopify-sourced, ingest-enabled.
- [Order Line Items](https://agents.concierca.ch/api/data-model/order-line-items.md): Per-position line items of orders (Shopify). Read-only; linked to orders via order_external_id.
- [Customers](https://agents.concierca.ch/api/data-model/customers.md): Customer/contact records with lifecycle status, synced from your shop system.
- [Products](https://agents.concierca.ch/api/data-model/products.md): Product master data: stock, prices, lead times, lifecycle, and family/model attributes.
- [Meeting Notes](https://agents.concierca.ch/api/data-model/meeting-notes.md): Meeting notes and action items pushed in from external transcription tools.
- [Product Demand](https://agents.concierca.ch/api/data-model/product-demand.md): How fast each variant sells and how long the stock lasts — the demand engine's per-variant output.
- [Procurement Queue](https://agents.concierca.ch/api/data-model/procurement-queue.md): One row = one procurement decision per tracked SKU. Filter action_required=true for the order list.
- [Purchase Orders](https://agents.concierca.ch/api/data-model/purchase-orders.md): Purchase order lines (header + line combined, Katana-compatible). Ingest: POST /api/ingest/purchase_order_lines.
- [Suppliers](https://agents.concierca.ch/api/data-model/suppliers.md): Supplier master data: name, currency, lead times, and target stock defaults.
- [Procurement Config](https://agents.concierca.ch/api/data-model/procurement-config.md): Per-tenant procurement configuration: demand weights, cutoffs, seasonality. Edit via agent or admin.
- [Weekly Sales](https://agents.concierca.ch/api/data-model/weekly-sales.md): Units sold per product and calendar week — newest week first, strongest sellers within each week.
- [Family Trend](https://agents.concierca.ch/api/data-model/family-trend.md): Which model families are picking up and which are falling off, seasonally adjusted.
- [Seasonality](https://agents.concierca.ch/api/data-model/seasonality.md): The seasonal factor per month and where it comes from — measured, overridden, or profile-based.
- [Customer Reorder Due](https://agents.concierca.ch/api/data-model/customer-reorder-due.md): Repeat customers who are due for their next purchase, benchmarked against typical reorder gaps.
- [LinkedIn Leads](https://agents.concierca.ch/api/data-model/linkedin-leads.md): The LinkedIn lead/CRM record — identity, pipeline scoring, outreach timing, and agent handoff. Agent-maintained.
- [LinkedIn Messages](https://agents.concierca.ch/api/data-model/linkedin-messages.md): Per-message log of the LinkedIn conversations behind each lead — direction, type, sender, and body. Agent-maintained.
- [LinkedIn Activity Limits](https://agents.concierca.ch/api/data-model/linkedin-activity.md): The daily guardrail that keeps automated LinkedIn activity within safe limits — counters, budget, and warnings. Agent-maintained.
- [Email Campaigns](https://agents.concierca.ch/api/data-model/email-campaigns.md): One row per email campaign send — subject, audience size, opens, clicks, and attributed revenue. Agent-maintained.
- [Meta Ads](https://agents.concierca.ch/api/data-model/meta-ads.md): Daily Meta (Facebook/Instagram) ad performance — spend, impressions, clicks, conversions, and derived CTR/CPC. Agent-maintained.
- [Web Events](https://agents.concierca.ch/api/data-model/web-events.md): Raw website behaviour events — page views and actions with session, source, and device context. Agent-maintained.
- [YouTube Watch](https://agents.concierca.ch/api/data-model/youtube.md): The market-intelligence content pipeline — watched channels and the videos pulled, transcribed, and AI-enriched from them. Agent-maintained.
- [Support Tickets](https://agents.concierca.ch/api/data-model/support-tickets.md): Customer support tickets — subject, customer, status, priority, channel, and resolution times. Agent-maintained.
- [Customer Outreach](https://agents.concierca.ch/api/data-model/customer-outreach.md): The reorder-outreach tracker — one row per customer per purchase cycle, with status and channel. Agent-maintained.