> ## Documentation Index
> Fetch the complete documentation index at: https://agents.concierca.ch/llms.txt
> Use this file to discover all available pages before exploring further.

# All Tools

> Every tool the Concierca AI MCP exposes — 136 in total — grouped by resource, with a one-line purpose and a link to full detail.

The MCP exposes 136 tools. Your key sees only the ones its allowlist grants (call `whoami` to see yours). Below is the full catalog grouped by resource; follow a group link for parameters and return shapes.

## Session — [full detail](/api/conventions)

Always callable, regardless of the key's allowlist.

| Tool          | What it does                                                                                          |
| ------------- | ----------------------------------------------------------------------------------------------------- |
| `whoami`      | Identity, role, tenant, departments, missions and this key's enabled tool surface. Call **first**.    |
| `get_context` | The rights-aware Operating-Manual context block (top memories + knowledge). Call once after `whoami`. |

## Agents — [full detail](/api/agents)

| Tool                        | What it does                                                                |
| --------------------------- | --------------------------------------------------------------------------- |
| `agent_list`                | List the agents visible to you (id, name, model, department, status).       |
| `agent_get`                 | One agent in full: config, model, tools, data grants, skills, schedule.     |
| `agent_create`              | Create a new agent (briefing, model, tools, data sources, skills).          |
| `agent_update`              | Merge-patch an agent's config (prompt, model, tools, `view_prefs`, skills). |
| `agent_run`                 | Run an agent once with a prompt and return its output.                      |
| `agent_versions_list`       | List an agent's version history — every edit is snapshotted.                |
| `agent_version_get`         | Read one historical agent version.                                          |
| `agent_stats_get`           | Aggregated run stats for an agent (success rate, duration, cost).           |
| `agent_run_list`            | List an agent's recent runs.                                                |
| `agent_run_get`             | One agent run in full: status, output, tokens, cost, logs.                  |
| `agent_search_runs`         | Search past agent runs — "what did I do last time".                         |
| `agent_schedule_manage`     | Create, update or disable an agent's cron schedule.                         |
| `agent_schedule_verify`     | Pre-flight check an agent's schedule config.                                |
| `composio_connection_list`  | List the user's Composio (OAuth) connections available to agents.           |
| `composio_connection_check` | Check the status of one Composio connection.                                |

## Missions — [full detail](/api/missions)

| Tool                              | What it does                                                                    |
| --------------------------------- | ------------------------------------------------------------------------------- |
| `mission_list`                    | List the missions you can see, each with your role and latest run.              |
| `mission_get`                     | One mission in full: role, passport, step summary, variables, genome, manifest. |
| `mission_status`                  | Full status: the step plan plus the latest run's per-step chain and credits.    |
| `mission_flow_get`                | The full step plan plus a safe preview of every referenced agent.               |
| `mission_members_get`             | The mission roster (owner + members) and your own role.                         |
| `mission_templates`               | List the built-in mission templates (read-only catalog).                        |
| `mission_run_trace_get`           | Deep per-step trace of one run (status, verdicts, timings, cost, tokens).       |
| `mission_artifact_get`            | Read one artifact a mission produced, with its content.                         |
| `mission_analytics_get`           | Aggregated run analytics (success rate, per-step failure/duration/cost).        |
| `mission_economics_get`           | Mission economics: cost, realized savings, net value, ROI.                      |
| `mission_incidents_get`           | Tenant-wide 24h agent-run incident signal (aggregate counts only).              |
| `mission_validate`                | Read-only pre-flight: readiness checks plus a mocked happy-path walk.           |
| `mission_compare_versions`        | Diff two mission versions (field + per-step changes).                           |
| `mission_compare_runs`            | Two runs side-by-side with a per-step `differs` flag.                           |
| `mission_create`                  | Create a mission (explicit steps, AI wizard, or template).                      |
| `mission_update`                  | Merge-patch mission fields and triggers (schedule/webhook).                     |
| `mission_steps_update`            | Edit the step plan: list/add/update/remove/reorder steps.                       |
| `mission_members_update`          | Add/update or remove a mission member.                                          |
| `mission_run`                     | Start a run of the mission's step sequence (one active run max).                |
| `mission_approve_step`            | Decide the mission's awaiting human step (approve/reject).                      |
| `mission_cancel`                  | Cancel the active run — terminal; human-gated with `confirm`.                   |
| `mission_pause`                   | Pause the active run — resumable; human-gated with `confirm`.                   |
| `mission_resume`                  | Resume a paused run from the first non-success step.                            |
| `mission_budget_increase`         | Raise the active run's credit budget (audited; human-gated).                    |
| `mission_draft_get`               | Get the mission's pending draft, or `null`.                                     |
| `mission_draft_create`            | Cut a draft from the current live config.                                       |
| `mission_draft_update`            | Merge-patch the draft (fields and/or full step list).                           |
| `mission_change_proposal_preview` | Preview what publishing the draft would change (diff + stale flag).             |
| `mission_draft_discard`           | Discard the pending draft.                                                      |
| `mission_draft_publish`           | Publish the draft onto the live config (version-captured).                      |

## Knowledge — [full detail](/api/knowledge)

| Tool                | What it does                                                      |
| ------------------- | ----------------------------------------------------------------- |
| `knowledge_search`  | Semantic recall over the knowledge base (title/intro + category). |
| `knowledge_get`     | One knowledge entry with full markdown content.                   |
| `knowledge_save`    | Create a durable knowledge entry (importance ≥ 5).                |
| `knowledge_update`  | Edit a knowledge entry in place by id (versioned).                |
| `knowledge_archive` | Soft-archive or restore a knowledge entry.                        |

## Memory — [full detail](/api/memory)

| Tool             | What it does                                                           |
| ---------------- | ---------------------------------------------------------------------- |
| `memory_search`  | Search memories (your layer + shared), currently-valid by default.     |
| `memory_get`     | One memory with full body.                                             |
| `memory_save`    | Save a memory (user layer by default; `supersedes` to replace a fact). |
| `memory_update`  | Edit a memory in place by id (versioned).                              |
| `memory_archive` | Soft-archive or restore a memory.                                      |

## Skills — [full detail](/api/skills)

| Tool            | What it does                                                 |
| --------------- | ------------------------------------------------------------ |
| `skill_list`    | List skills available in this tenant (plus platform skills). |
| `skill_get`     | One skill with docs, prompt block and tool requirements.     |
| `skill_create`  | Create a new tenant-owned skill.                             |
| `skill_save`    | Edit a tenant-owned skill (platform skills are read-only).   |
| `skill_link`    | Link one skill to an agent (additive).                       |
| `skill_archive` | Soft-archive or restore a tenant-owned skill.                |

## Inbox — [full detail](/api/inbox)

| Tool              | What it does                                     |
| ----------------- | ------------------------------------------------ |
| `inbox_list`      | List your (human) inbox items; default `unread`. |
| `inbox_get`       | One inbox item in full with its thread.          |
| `inbox_mark_read` | Mark an inbox item as read.                      |
| `inbox_reply`     | Reply to an inbox item (human-dictated only).    |

## Approvals — [full detail](/api/approvals)

| Tool               | What it does                                               |
| ------------------ | ---------------------------------------------------------- |
| `approval_list`    | List HITL approvals in this workspace; default `pending`.  |
| `approval_resolve` | Approve or reject a pending approval (human-decided only). |

## Data (generic) — [full detail](/api/data)

| Tool               | What it does                                                            |
| ------------------ | ----------------------------------------------------------------------- |
| `data_view_list`   | List the data views you may query (slugs, labels, columns). Call first. |
| `data_query`       | Query one view: filters, free-text search, count, sort, projection.     |
| `data_row_save`    | Upsert one row keyed on `external_id`.                                  |
| `data_row_create`  | Insert a new row (the database assigns the id).                         |
| `data_row_update`  | Update one row by id.                                                   |
| `data_view_create` | Create a new registry view (Company-Admin).                             |
| `data_view_update` | Update an existing registry view (Company-Admin).                       |

## Data — per-table writes — [full detail](/api/write-tools)

Each writable catalog table is gated by its own grant. See [Row Write Tools](/api/write-tools) for the full contract.

| Tool                          | What it does                                                              |
| ----------------------------- | ------------------------------------------------------------------------- |
| `insert_orders`               | Create a row in [Orders](/api/data-model/orders).                         |
| `update_orders`               | Update a row in [Orders](/api/data-model/orders).                         |
| `insert_products`             | Create a row in [Products](/api/data-model/products).                     |
| `update_products`             | Update a row in [Products](/api/data-model/products).                     |
| `insert_purchase_order_lines` | Create a row in [Purchase Order Lines](/api/data-model/purchase-orders).  |
| `update_purchase_order_lines` | Update a row in [Purchase Order Lines](/api/data-model/purchase-orders).  |
| `insert_customers`            | Create a row in [Customers](/api/data-model/customers).                   |
| `update_customers`            | Update a row in [Customers](/api/data-model/customers).                   |
| `insert_decisions`            | Create a row in [Decisions](/api/data-model/decisions).                   |
| `update_decisions`            | Update a row in [Decisions](/api/data-model/decisions).                   |
| `insert_order_line_items`     | Create a row in [Order Line Items](/api/data-model/order-line-items).     |
| `update_order_line_items`     | Update a row in [Order Line Items](/api/data-model/order-line-items).     |
| `insert_procurement_config`   | Create a row in [Procurement Config](/api/data-model/procurement-config). |
| `update_procurement_config`   | Update a row in [Procurement Config](/api/data-model/procurement-config). |
| `insert_suppliers`            | Create a row in [Suppliers](/api/data-model/suppliers).                   |
| `update_suppliers`            | Update a row in [Suppliers](/api/data-model/suppliers).                   |
| `insert_decision_log`         | Create a row in Decision Log.                                             |
| `update_decision_log`         | Update a row in Decision Log.                                             |
| `insert_agent_runs`           | Create a row in Agent Runs.                                               |
| `update_agent_runs`           | Update a row in Agent Runs.                                               |
| `insert_inbox_agents`         | Create a row in Agent Inbox.                                              |
| `update_inbox_agents`         | Update a row in Agent Inbox.                                              |
| `insert_agents`               | Create a row in Agents.                                                   |
| `update_agents`               | Update a row in Agents.                                                   |
| `insert_knowledge_base`       | Create a row in Knowledge Base.                                           |
| `update_knowledge_base`       | Update a row in Knowledge Base.                                           |
| `insert_meeting_notes`        | Create a row in [Meeting Notes](/api/data-model/meeting-notes).           |
| `update_meeting_notes`        | Update a row in [Meeting Notes](/api/data-model/meeting-notes).           |

## Administration — [full detail](/api/admin)

| Tool                    | What it does                                                        |
| ----------------------- | ------------------------------------------------------------------- |
| `department_list`       | List the tenant's departments (id, name, slug).                     |
| `category_list`         | List category options for `memory` / `knowledge` / `skill`.         |
| `grantable_list`        | The agent toolbox: every name valid in an agent's `tools_access[]`. |
| `guardrails_get`        | The always-load governance rules this caller must honor.            |
| `self_learning_enable`  | Provision or disable the Company-Brain self-learning harness.       |
| `user_create`           | Provision a new user (invite link emailed; no password returned).   |
| `credit_log_list`       | Recent credit movements for this workspace.                         |
| `failed_import_list`    | Recent failed data imports (source, type, error).                   |
| `pricing_config_get`    | Read the platform pricing config (Superadmin).                      |
| `pricing_config_update` | Update one pricing row (Superadmin).                                |
| `provider_ledger_get`   | Read the provider margin ledger (Superadmin).                       |

## Vertical — [full detail](/api/vertical)

Watch Market Intelligence — the read-only federated layer. Namespaced `vertical__*` on the main server.

| Tool                           | What it does                                                                   |
| ------------------------------ | ------------------------------------------------------------------------------ |
| `vertical__vertical_legend`    | The insight-feed legend: manifest, signal catalog, live counts. Call first.    |
| `vertical__vertical_resolve`   | Resolve a free-text entity name to its `entity_id`.                            |
| `vertical__vertical_card`      | One entity's complete insight card for a period.                               |
| `vertical__vertical_search`    | Filtered cross-entity search over the curated feed.                            |
| `vertical__vertical_compare`   | Competitive pack: lean cards for 2–6 entities.                                 |
| `vertical__vertical_benchmark` | Non-entity market benchmarks — "what is normal".                               |
| `vertical__vertical_knowhow`   | Read the vertical's editorial know-how articles.                               |
| `vertical__vertical_lookups`   | List reference/lookup vocabularies (channels, signal types, dimensions).       |
| `vertical__feed_index_list`    | Feed index/legend — legacy alias of `vertical_legend`.                         |
| `vertical__feed_search`        | Filtered feed search — legacy alias of `vertical_search`.                      |
| `vertical__feed_card`          | One entity's feed card — legacy alias of `vertical_card`.                      |
| `vertical__feed_compare`       | Side-by-side feed cards for 2–6 entities — legacy alias of `vertical_compare`. |
| `vertical__feed_brand_resolve` | Resolve a name to an entity id — legacy alias of `vertical_resolve`.           |
| `vertical__list_lookups`       | List lookup values — legacy alias of `vertical_lookups`.                       |
| `vertical__market_density`     | Market density / benchmark aggregates — legacy alias of `vertical_benchmark`.  |
| `vertical__read_know_how`      | Read know-how articles — legacy alias of `vertical_knowhow`.                   |

***

**Total: 136 tools** on a fully-granted Company-Admin key (as reported by `whoami`), spanning the twelve groups above — 2 session, 15 agents, the mission surface, 5 knowledge, 5 memory, 6 skills, 4 inbox, 2 approvals, 7 generic data + 28 per-table writes, 11 administration, and 16 vertical. Counts and availability are **per key**: your credential sees only the tools its allowlist grants (a Member OAuth connect starts with none of the per-table writes, a Company-Admin connect with all of them), so `whoami.enabled_tools` is always the authoritative list for your session.