Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

Odoo Surface MCP

von solutionsunityVersion 0.6.1i★ 2iLäuft auf deinem Computer
Name in der Registryio.github.solutionsunity/odoo-surface-mcp

So installierst du es

What it does

Full Odoo access for AI agents via MCP: CRUD, website, translations, attachments, workflows.

  • Connects Läuft auf deinem Computer
  • Account or key Needs ODOO_PASSWORD · 3 settings to fill in (ODOO_URL, ODOO_DB, ODOO_USERNAME)
  • Category Web & Browser

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 13. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Odoo Surface MCP (auf der Seite des Anbieters erstellen) · 3 Einstellung(en) auszufüllen (ODOO_URL, ODOO_DB, ODOO_USERNAME) · Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

  1. Node.js installieren

    Nur einmal; gilt für alle Server, die Node.js brauchen

    Download-Seite von Node.js öffnen ↗

  2. Bei Odoo Surface MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  3. 3 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • ODOO_URL Odoo instance URL (e.g. https://myodoo.com)
    • ODOO_DB Odoo-Datenbankname
      Englisches Original anzeigenOdoo database name
    • ODOO_USERNAME Odoo login username

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  4. Einstellungsdatei der Claude-Desktop-App öffnen

    SettingsDeveloperEdit Config

  5. Diese Einstellungen einfügen und speichern

    {
      "mcpServers": {
        "odoo-surface": {
          "command": "npx",
          "args": [
            "-y",
            "@suco/odoo-surface-mcp"
          ],
          "env": {
            "ODOO_URL": "your-value",
            "ODOO_DB": "your-value",
            "ODOO_USERNAME": "your-value",
            "ODOO_PASSWORD": "your-value"
          }
        }
      }
    }

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  6. Claude beenden und neu öffnen

  7. Ausprobieren

    Nutze Odoo Surface MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Odoo Surface MCP nutzt, oder ein Werkzeug von Odoo Surface MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann Odoo Surface MCP noch nicht verbinden

Odoo Surface MCP läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen

Das kannst du stattdessen tun

A · Eine App nutzen, die Odoo Surface MCP verbinden kann

  • Du brauchst einen Schlüssel von Odoo Surface MCP (auf der Seite des Anbieters erstellen) · 3 Einstellung(en) auszufüllen (ODOO_URL, ODOO_DB, ODOO_USERNAME) · Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
  • Du brauchst einen Schlüssel von Odoo Surface MCP (auf der Seite des Anbieters erstellen) · 3 Einstellung(en) auszufüllen (ODOO_URL, ODOO_DB, ODOO_USERNAME) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
  • Du brauchst einen Schlüssel von Odoo Surface MCP (auf der Seite des Anbieters erstellen) · 3 Einstellung(en) auszufüllen (ODOO_URL, ODOO_DB, ODOO_USERNAME) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
  • Du brauchst einen Schlüssel von Odoo Surface MCP (auf der Seite des Anbieters erstellen) · 3 Einstellung(en) auszufüllen (ODOO_URL, ODOO_DB, ODOO_USERNAME) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

B · Andere in Web & Browser, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Odoo Surface MCP (auf der Seite des Anbieters erstellen) · 3 Einstellung(en) auszufüllen (ODOO_URL, ODOO_DB, ODOO_USERNAME) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

  1. Node.js installieren

    Nur einmal; gilt für alle Server, die Node.js brauchen

    Download-Seite von Node.js öffnen ↗

  2. Bei Odoo Surface MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  3. 3 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • ODOO_URL Odoo instance URL (e.g. https://myodoo.com)
    • ODOO_DB Odoo-Datenbankname
      Englisches Original anzeigenOdoo database name
    • ODOO_USERNAME Odoo login username

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  4. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  5. Diesen Befehl einfügen und Enter drücken

    claude mcp add --scope user odoo-surface --env ODOO_URL=your-value --env ODOO_DB=your-value --env ODOO_USERNAME=your-value --env ODOO_PASSWORD=your-value -- npx -y @suco/odoo-surface-mcp

    Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  6. /mcp in Claude Code eingeben

    Odoo Surface MCP sollte in der Liste als verbunden erscheinen

  7. Ausprobieren

    Nutze Odoo Surface MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Odoo Surface MCP nutzt, oder ein Werkzeug von Odoo Surface MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Odoo Surface MCP (auf der Seite des Anbieters erstellen) · 3 Einstellung(en) auszufüllen (ODOO_URL, ODOO_DB, ODOO_USERNAME) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

  1. Node.js installieren

    Nur einmal; gilt für alle Server, die Node.js brauchen

    Download-Seite von Node.js öffnen ↗

  2. Bei Odoo Surface MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  3. 3 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • ODOO_URL Odoo instance URL (e.g. https://myodoo.com)
    • ODOO_DB Odoo-Datenbankname
      Englisches Original anzeigenOdoo database name
    • ODOO_USERNAME Odoo login username

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  4. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  5. Schlüssel eintragen

    In den Einstellungen von Odoo Surface MCP ist ODOO_PASSWORD, ODOO_URL, ODOO_DB, ODOO_USERNAME leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  6. KI-Chat in Cursor im Agent-Modus öffnen

  7. Ausprobieren

    Nutze Odoo Surface MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Odoo Surface MCP nutzt, oder ein Werkzeug von Odoo Surface MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Odoo Surface MCP (auf der Seite des Anbieters erstellen) · 3 Einstellung(en) auszufüllen (ODOO_URL, ODOO_DB, ODOO_USERNAME) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

  1. Node.js installieren

    Nur einmal; gilt für alle Server, die Node.js brauchen

    Download-Seite von Node.js öffnen ↗

  2. Bei Odoo Surface MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  3. 3 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • ODOO_URL Odoo instance URL (e.g. https://myodoo.com)
    • ODOO_DB Odoo-Datenbankname
      Englisches Original anzeigenOdoo database name
    • ODOO_USERNAME Odoo login username

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  4. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  5. Schlüssel eintragen

    In den Einstellungen von Odoo Surface MCP ist ODOO_PASSWORD, ODOO_URL, ODOO_DB, ODOO_USERNAME leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  6. KI-Chat in VS Code im Agent-Modus öffnen

  7. Ausprobieren

    Nutze Odoo Surface MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Odoo Surface MCP nutzt, oder ein Werkzeug von Odoo Surface MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Odoo Surface MCP nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user odoo-surface --env ODOO_URL=your-value --env ODOO_DB=your-value --env ODOO_USERNAME=your-value --env ODOO_PASSWORD=your-value -- npx -y @suco/odoo-surface-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "odoo-surface": {
      "command": "npx",
      "args": [
        "-y",
        "@suco/odoo-surface-mcp"
      ],
      "env": {
        "ODOO_URL": "your-value",
        "ODOO_DB": "your-value",
        "ODOO_USERNAME": "your-value",
        "ODOO_PASSWORD": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "odoo-surface": {
      "command": "npx",
      "args": [
        "-y",
        "@suco/odoo-surface-mcp"
      ],
      "env": {
        "ODOO_URL": "your-value",
        "ODOO_DB": "your-value",
        "ODOO_USERNAME": "your-value",
        "ODOO_PASSWORD": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "odoo-surface": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@suco/odoo-surface-mcp"
      ],
      "env": {
        "ODOO_URL": "your-value",
        "ODOO_DB": "your-value",
        "ODOO_USERNAME": "your-value",
        "ODOO_PASSWORD": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • ODOO_URL erforderlich env
    Odoo instance URL (e.g. https://myodoo.com)
  • ODOO_DB erforderlich env
    Odoo-Datenbankname
    Englisches Original anzeigenOdoo database name
  • ODOO_USERNAME erforderlich env
    Odoo login username
  • ODOO_PASSWORD geheim erforderlich env
    Odoo login password

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
71/Wo.
Lizenzi
Apache-2.0
Verbindung
Läuft auf deinem Computer
Neueste Versioni
0.6.1
In der Registry veröffentlichti
4. Okt. 2026
Code zuletzt geänderti
4. Okt. 2026
Entwickler
solutionsunity
Pakete
npm: @suco/odoo-surface-mcp
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 14. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto solutionsunity bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 41 Tagen

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt Apache-2.0

  • – Nicht zutreffend

    Endpunkt antwortet

    Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Mit Google anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Mit Google anmelden, um zu bewerten

Im Vergleich mit anderen in Web & Browseri

  • Mehr Sterne als 84 % der anderen 1510 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 42 % der anderen 1510 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 100 % der anderen 1510 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Odoo Surface MCP sicher?

Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: ODOO_PASSWORD

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 41 Tagen geändert, und die neueste Version (0.6.1) kam vor 41 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Browser Use, Scrapling MCP Server, Chrome DevTools MCP

Andere in derselben Kategorie

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Browser Use

Browser agents and stealth cloud browsers for AI: run web tasks, fill forms, extract data.

von browser-useWeit verbreitet↓ 1,7 Mio./Wo.★ 120.939Aktualisiert vor 24 Tagen

Computer oder Cloud✓ vom Dienst · browser-use.com

Scrapling MCP Server

Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.

von D4VinciWeit verbreitet↓ 396.928/Wo.★ 102.474Aktualisiert vor 9 Tagen

Läuft auf deinem Computer

Chrome DevTools MCP

MCP server for Chrome DevTools

von ChromeDevToolsWeit verbreitet↓ 1,9 Mio./Wo.★ 55.362Aktualisiert vor 3 Tagen

Läuft auf deinem Computer

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

OdooSurface MCP

User-equivalent Odoo access for AI agents — what the authenticated user can do in their browser, nothing more.

Prerequisites

  • Node.js 18+ (ships with npx — no extra install needed)
  • A running Odoo instance (15.0+, CE or EE) — per-version behaviour of every call: docs/compatibility.md
  • An MCP-compatible client (VS Code, Claude Desktop, Claude Code, Cursor, …)

Configure your MCP client

Add this to your MCP client config (e.g. Claude Desktop claude_desktop_config.json):

{

"mcpServers": { "odoo-surface": { "command": "npx", "args": ["-y", "@suco/odoo-surface-mcp@latest"], "env": { "ODOO_URL": "http://localhost:8069", "ODOO_DB": "your_database", "ODOO_USER": "admin", "ODOO_PASSWORD": "admin" } } } }

Restart your MCP client after saving. npx downloads and runs the package automatically — no further install steps.

Authentication

Option A — .env file (keep credentials out of MCP config)

Instead of putting credentials in your MCP client JSON, create a .env file in the directory where you run the MCP:

ODOO_URL=http://localhost:8069

ODOO_DB=your_database ODOO_USER=admin ODOO_PASSWORD=your_password

Remove the env block from the MCP client config — the .env file is loaded automatically.

Option B — API Key (recommended, no password stored)

Since Odoo 14+, users can generate personal API keys that act as a password replacement. Each user generates their own key from their own account — there is no admin-side menu for this.

  1. Log in as the user the MCP will authenticate as
  2. Click the user avatar (top-right) → Preferences
  3. Go to the Account Security tab
  4. Under API Keys → click New API Key
  5. Enter your password when prompted, give the key a name, copy the generated key
  6. Use it as ODOO_PASSWORD — the actual account password is never stored
ODOO_URL=http://localhost:8069

ODOO_DB=your_database ODOO_USER=admin ODOO_PASSWORD=your_api_key_here

API keys can be revoked individually from the same screen without changing the account password.

Advanced Configuration

Multiple Odoo instances

Technical users commonly work with more than one Odoo instance (local dev, staging, production). Each instance gets its own named entry in the MCP config — they run as independent processes with fully isolated credentials. The AI client exposes them as separate tool namespaces.

{

"mcpServers": { "odoo-local": { "command": "npx", "args": ["-y", "@suco/odoo-surface-mcp@latest"], "env": { "ODOO_URL": "http://localhost:8069", "ODOO_DB": "dev", "ODOO_USER": "admin", "ODOO_PASSWORD": "dev_api_key" } }, "odoo-production": { "command": "npx", "args": ["-y", "@suco/odoo-surface-mcp@latest"], "env": { "ODOO_URL": "https://mycompany.odoo.com", "ODOO_DB": "prod", "ODOO_USER": "admin", "ODOO_PASSWORD": "prod_api_key" } } } }

Note: The .env file approach (Option A) does not work for multi-instance setups — both

processes share the same working directory and would load the same file. Use the env block

per entry instead.

Debug mode

Registers additional tools: ping, echo, inspect_view, inspect_action, inspect_fields, dump_cache, clear_cache, restart_mcp.

"args": ["-y", "@suco/odoo-surface-mcp@latest", "--debug"]

Tools

LayerTools
Guidancelist_skills, get_skills, find_skill, list_workflows, get_workflows
Discoveryget_models, get_model_actions, get_model_interface
Planningget_available_actions
Supportinglist_records, get_record, search_records, read_group, get_fields, get_defaults, get_filters, list_pages, get_page_arch, list_snippets, get_snippet, list_attachments, download_binary, fetch_and_upload, translation_get, translation_update, translation_audit
Intentcreate, update, execute_action, archive, post_message, schedule_activity, create_page, set_page_arch, set_page_visibility, upload_binary

Architecture

Core Contract

The agent may only do what the authenticated user can do in their browser. Scope is bounded by the user's menus, views, and ACL — nothing more. Tool verbs express functional intent (publish, confirm) rather than raw ORM operations. Discovery is lazy: the agent resolves only what the current prompt requires.

Layered Tool Surface
LayerRoleWhen invoked
0 — GuidanceCanonical recipes (skills, workflows) the agent consults before any multi-step operation. Pure documentation, no side effects.Before planning
1 — DiscoveryEstablishes the bounded universe of models and reachable relations for the current user.At intent resolution
2 — Planning BridgeAnswers "what is live on this specific record right now" — record-state-aware actions.Once a record is identified
3 — SupportingRead-only data fetchers used silently to fill gaps in the agent's plan.Throughout planning
4 — IntentMutating actions that fulfill the user's request — bounded by the user's UI permissions.Final execution
Planning Loop
User prompt

├── Discovery — what models/relations does this user have? ├── (optional) — locate the specific record ├── Planning Bridge — what is live on that record right now? ├── Guidance — consult skills/workflows for multi-step recipes └── Intent — execute the mutation(s)

Skills and workflows are authored in skills/ and workflows/ as markdown with YAML frontmatter; they are exposed as Layer 0 tools at runtime.