Genie MCP Server: programmatic workspace access

The Genie MCP Server lets external AI clients — Claude Desktop, Cursor, custom agents — connect to your Genie workspace and manage it programmatically. Once connected, the AI can create projects from prompts, send follow-up instructions, browse build history, manage members, query credit usage, and more, all through the same tools the Genie web app uses.

The Genie MCP Server is available on all paid Genie plans. Each connection is scoped to a single workspace via OAuth 2.0. Only the tools allowed by your role within that workspace are accessible.

Connect your client

Endpoint

https://www.genie-app.de/api/mcp

The server uses the Streamable HTTP MCP transport (POST, GET, and DELETE on the same URL).

Authentication

The Genie MCP Server uses OAuth 2.0 with PKCE. Each authorisation is scoped to a single workspace — you choose which workspace to authorise during the OAuth flow, and every tool call is restricted to that workspace. Most MCP clients (Claude Desktop, Cursor) handle the OAuth flow automatically when you paste the endpoint URL into their settings and start a conversation. The client receives a short-lived token that Genie refreshes automatically.

Example: Claude Desktop

Add the following entry to your claude_desktop_config.json:

{
  "mcpServers": {
    "genie": {
      "url": "https://www.genie-app.de/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Restart Claude Desktop and open any conversation. Claude will prompt you to authorise the Genie connection the first time a Genie tool is invoked.

Available tools

The Genie MCP Server provides tools across thirty-three categories.

Workspace management

Read and update your workspace, members, invitations, settings, and billing.

Tool	What it does
`get_workspace_info`	Name, member count, icon, accent color, settings, and creation date
`list_workspace_members`	Members with roles and join dates — a member can hold more than one role, so `roles` lists the full set and `role` the strongest one
`list_workspace_invites`	Pending invite links with expiry and remaining uses
`invite_workspace_member`	Create a shareable invite link for a given role
`revoke_workspace_invite`	Cancel a pending invite
`update_workspace_member_role`	Change a member’s role
`remove_workspace_member`	Remove a member immediately
`update_workspace`	Rename the workspace, update its description, or set its icon and accent color
`update_workspace_settings`	Toggle activity log, project access control, or automatic knowledge-base reading (entity/relation extraction — see Knowledge model)
`get_workspace_billing`	Subscription plan, status, and billing period
`get_workspace_credits`	Current credit balance
`get_credit_usage`	Credit consumption, optionally broken down by project, member, or day, and sortable by spend or date
`get_recent_workspace_activity`	Activity log with filters and pagination
`get_workspace_activity_stats`	Aggregated trend KPIs — events and active members per day, and the busiest actions — the same figures the Activity page’s insights panel charts
`list_workspaces`	All workspaces the authenticated user belongs to
`list_user_workspaces`	Same list, with the currently-connected workspace marked
`create_workspace`	Create a new workspace, owned by you. Independent of the currently connected workspace — it appears in your workspace list right away
`invite_workspace_member_by_email`	Send a single-use invite directly to an email address. The invitee doesn’t need an existing Genie account — they become a member once they accept

Workspace roles and permissions

Everything the Roles & permissions settings page can do — the four built-in roles (owner/admin/member/editor) and any custom role or group the workspace defines. Every write requires the roles.manage permission.

Tool	What it does
`list_workspace_roles`	Every role in the workspace — the four built-ins with their current permissions, and every custom role or group, each with a role id, base role, granted permissions, and member count
`list_workspace_permissions`	The full permission catalog: what each one covers, and whether it’s flagged sensitive (money, data, or the workspace itself)
`create_workspace_role`	Create a custom role that narrows a built-in role — a permission the base role lacks is dropped, never granted — or a group with no permissions of its own, just a target for granting knowledge access areas
`set_workspace_role_permissions`	Replace a role’s whole permission set — send the complete list it should end up with, not just what changed
`update_workspace_role`	Rename a custom role, change its description, or move it to a different base role
`reset_builtin_workspace_role`	Drop a workspace’s customisation of a built-in role, restoring the shipped defaults
`delete_workspace_role`	Delete a custom role — everyone holding it falls back to the built-in role it inherited from

Workspace API keys

Manage the bearer-token keys that let your own code call Genie AI over HTTP — see Workspace API keys. Owner or admin only.

Tool	What it does
`list_workspace_api_keys`	List the workspace’s keys with a masked prefix and recent usage (requests, tokens, credits). Secrets are never returned
`create_workspace_api_key`	Mint a new key and return its plaintext secret — shown exactly once, the same as the settings dialog
`set_workspace_api_key`	Rename a key, pause or resume it, or change its rate limit
`revoke_workspace_api_key`	Permanently revoke a key. Irreversible

Projects

Browse projects, create new ones from prompts, and manage the full project lifecycle.

Tool	What it does
`list_latest_projects`	10 most recently updated projects
`search_projects`	Full-text search with sort options (`recentlyEdited`, `bestMatch`, etc.); pass `favorites_only` to search just your favorites, or `unlisted_only` to list your own projects that are in no workspace
`set_project_favorite`	Star or unstar a project as one of your personal favorites
`get_project`	Full details: name, description, visibility, deployment URL, credit usage
`create_project`	Create a project from a natural-language prompt and start the first build
`send_followup_prompt`	Send a follow-up instruction to an existing project
`get_project_status`	Lightweight check: is a build currently running?
`get_project_build_status`	The richest live-status call — phase, countdown ETA, progress, active agents, preview link, changed pages, closing summary, and suggested follow-ups, matching the web app’s build-status card
`list_connected_project_activity`	What a project (or every project connected to a given workspace chat) is doing right now — building, running autofix, or has prompts waiting in its queue — the same snapshot the status badge on every workspace-chat surface shows. Pass a `conversation_id` and/or a `project_slug`
`list_project_viewers`	Who else has a project open right now — the same presence snapshot as the viewers badge on the project page. Never lists the caller themselves; an empty list means they’re the only one there
`get_project_deployment_status`	Full phase-by-phase build breakdown
`get_project_deployment_plan`	Files the AI planned to create or modify
`get_project_messages`	Build history and chat turns
`show_preview`	Deployment URL and per-page screenshots
`get_project_screenshots`	Fetch actual screenshot images of a project — not just a URL — attached directly to the tool result: the deployed app’s default view, and, when available, exactly what the connected user had open in their own live preview
`search_project_console_logs`	Search a deployed project’s live runtime telemetry — console output, errors, unhandled crashes, clicks, and page views — filtered by keyword, severity, or event type, over a configurable time window
`suggest_project_prompts`	AI-generated next-step ideas based on build history
`abort_project_build`	Cancel the currently running build
`archive_project` / `unarchive_project`	Hide or restore a project
`list_archived_projects`	All archived projects in the workspace
`delete_project`	Permanently delete a project
`update_project`	Rename, update description, change visibility, or toggle remixing
`list_project_members`	Members explicitly granted access (when project access control is on)
`add_project_member` / `remove_project_member`	Grant or revoke a member’s access to a specific project
`rename_project`	Rename a project (a focused alternative to `update_project`)
`add_project_to_workspace`	Move one of your personal projects into the connected workspace
`remove_project_from_workspace`	Remove a project from the workspace without deleting it — it becomes a personal project again
`get_project_deletion_status`	Check whether a project has a deletion in progress from the web app’s Danger Zone, and whether it’s still inside the cancellable grace window
`cancel_project_deletion`	Cancel an in-progress project deletion started from the web app, while still inside the grace window
`get_auto_mode_state`	Check whether Auto mode is running for a project: enabled flag, prompts used so far, and session limits
`set_auto_mode`	Turn Auto mode on or off for a project
`list_project_deployment_versions`	List a project’s past deployed versions, newest first, so you can pick one to restore
`rollback_project_deployment`	Restore a project to a previous version’s code and trigger a fresh deploy. Overwrites the project’s current code — requires `confirm_rollback: true`
`get_project_seo_settings`	Read a project’s current page title, meta description, canonical URL, Open Graph image, and noindex flag
`update_project_seo_settings`	Update a project’s page title and/or meta description. Canonical URL, Open Graph image, and noindex stay read-only via MCP for now — set those from the web app’s SEO settings tab

Project code graph

Ask questions about a project’s own code — useful for an external AI client that needs to understand a project before changing it or answering questions about it.

Tool	What it does
`query_project_code_graph`	Ask a natural-language question about a project’s code — callers/callees, imports, symbol history, recent changes, or a free-text search — and get back file paths and exact line numbers

Project Files

The manual counterpart to query_project_code_graph: the graph answers “which file”, these answer “show me the rest of it” for a path you already know.

Tool	What it does
`list_project_files`	List the file paths in a project’s current code branch — its file tree. Filter with `query` (substring) or `prefix` (folder).
`read_project_file`	Read a specific file from a project’s current code branch, up to 300 lines at a time — page further in with `start_line`. A wrong path comes back with suggested near-matches instead of content. Refuses to read `.env` and other files that hold secrets or platform config.

Project Design Guidelines

A project’s own style guide (branding.md) — brand colors, typography, component specs, and dos and don’ts — read by the build agent before it writes any frontend code. Distinct from Genie’s own global design principles, which are read-only and not project-specific.

Tool	What it does
`get_project_design_guidelines`	Read a project’s design guidelines. When the project has none yet, the result says so and includes the reference format to write one in.
`update_project_design_guidelines`	Replace a project’s design guidelines with the full markdown supplied, creating the file if the project has none yet. A write that would blank the document, exceed 20,000 characters, or shrink an existing document to under 40% of its length is rejected unless `confirm_shrink` is set — so a partial edit can’t silently delete a style guide. Doesn’t restyle the live app by itself — send a follow-up prompt to apply it.

Project feature tree

Genie tracks every feature, area, and capability it builds into a project as a tree — visible in the project’s Brain tab in the web app. These tools let an external AI client read and maintain that tree. Reading is available to anyone who can view the project; adding or editing a goal requires project ownership.

Tool	What it does
`list_project_goals`	List the full feature tree — every tracked feature area, feature, and task, with its status (`todo`, `in_progress`, `implemented`, `failed`, `blocked`, `abandoned`)
`get_project_goal_details`	Deep-dive one feature: its status-change history, the code files that implement it, and (for a feature area) how much of it is done
`create_project_goal`	Add a feature to the tree to track it — this only records intent, it does not start a build
`update_project_goal`	Rename a feature, change its acceptance criteria, or update its status
`suggest_next_prompts`	Get ready-to-send prompt suggestions for what to build next, based on the project’s open features

Bug tracking

Genie de-duplicates bugs across your projects: when the same class of bug shows up again, it reuses the fix that worked last time instead of investigating from scratch. These tools let an external AI client read and file into that system. Reading is available to anyone who can view the project; filing a bug requires project ownership.

Tool	What it does
`get_known_issues`	List a project’s tracked bug sightings — each one’s source, status, a summary, and the cross-project bug pattern it was matched to (if any)
`report_known_issue`	File a bug into the knowledge base so it’s de-duplicated against known patterns and its eventual fix can be reused across projects. Advisory tracking only — it never starts a build. Only the project owner can call this
`find_bug_solutions`	Search the shared bug-knowledge base for a proven fix by describing the symptom in natural language — across all Genie projects, not just this workspace’s. Read-only, and not scoped to any project or workspace, since results are generalized and scrubbed of project-specific details

User memory

Genie’s workspace AI remembers things you’ve mentioned about yourself in chat — your preferences, tools, team, goals — and brings that context into later conversations automatically. These tools let an external AI client search or delete that memory. Scoped to the connected user across all their workspaces, not to the currently connected workspace, since memory is a per-user concept.

Tool	What it does
`search_user_memory`	Search everything Genie remembers about the connected user, ranked by relevance to a query, or list the most recently reinforced memories when no query is given. Read-only
`forget_user_memory`	Permanently delete one specific remembered fact about the connected user by id (obtained from `search_user_memory`)

Project memory

Genie’s workspace AI also keeps notes that belong to a project itself — a standing requirement, or a confirmed detail about a third-party service the project integrates with — shared with everyone who has access to that project. These tools let an external AI client read and write that same shared memory. Requires access to the project; writing requires project ownership or workspace-admin/member access.

Tool	What it does
`save_project_memory`	Save or update a project note. A new note that closely matches an existing one of the same kind updates it in place instead of creating a duplicate
`search_project_memory`	Search a project’s notes, ranked by relevance to a query, or list the most recent ones when no query is given. Read-only
`forget_project_memory`	Permanently delete one specific project note by id (obtained from `search_project_memory`)

Workspace knowledge documents

Material a team wants every build to respect — brand guidelines, tone of voice, an API schema, a data dictionary — filed against the whole workspace or one project. See Knowledge base. Like project memory above, these tools run as the connected user rather than impersonating the project owner, so a project’s own access rules decide who can read or change its documents.

Tool	What it does
`list_workspace_documents`	List knowledge documents, paginated and filterable by title/description/filename. `scope`: `workspace`, `project`, `effective` (workspace + one project — what actually applies when building it), or `all` (default)
`search_workspace_documents`	Search inside documents’ text (hybrid semantic + keyword) and get back matching passages
`read_workspace_document`	Read one document’s full text in bounded, pageable slices
`add_workspace_documents`	File one or more documents (up to 10 per call) for the workspace or a project
`update_workspace_document`	Retitle, re-describe, move a document between scopes, move it between folders via `folder`, or rewrite its full text in place via `text` (re-indexed immediately; refused on a document mirrored in from a connected cloud drive — edit it at the source instead)
`delete_workspace_document`	Permanently delete a document and its search index
`reindex_workspace_document`	Repair a document stuck at keyword-only or failed search indexing, or bring it onto the current embedding spec. Safe to call on any document — never changes its text
`get_knowledge_index_status`	The workspace’s indexing status at a glance — how many documents are fully searchable, still indexing, keyword-only, or stalled, and how many still need their date read — plus a list of the documents most needing attention
`get_document_cover_image`	Read a document’s cover picture — whether one exists, is being drawn right now, or the last attempt’s outcome
`regenerate_document_cover_image`	Draw a new cover picture for a document, replacing whatever is there. Runs in the background
`list_workspace_document_folders`	The workspace’s filing folders, each with how many documents it holds and how much room is left before the 200-per-folder cap
`create_workspace_document_folder`	Create a folder. Names are unique per workspace, case-insensitively
`update_workspace_document_folder`	Rename a folder. The documents in it are untouched
`delete_workspace_document_folder`	Delete a folder. The documents in it are not deleted — they become unfiled and stay searchable; the result says how many
`list_knowledge_sources`	Where the calling member’s connected cloud drives (Google Drive, OneDrive) stand: not available on this deployment, not connected, or connected and browsable
`browse_knowledge_source`	Browse a connected cloud drive’s folders and files, paginated, to find the id of a file to import
`import_knowledge_source_file`	Import a file from a connected cloud drive as a knowledge document, at a chosen scope and folder

Like the tools above, the three cloud-drive tools run as the connected member and only ever reach that member’s own drive connection — never anyone else’s. Folders are orthogonal to scope. Scope decides which projects may use a document; a folder only decides where a human finds it, and no retrieval path reads it — filing a document, or deleting the folder it’s in, never changes what a search returns. list_workspace_documents, add_workspace_documents, and update_workspace_document each accept a folder (a name, an id, or unfiled), addressable by name since that’s what a client actually sees. A folder holds at most 200 documents, enforced the same way for MCP, the in-app agent, and the browser.

Knowledge access areas

Manage access areas — which folders are fenced off, and who reaches each one. Every write requires the workspace’s knowledge-access-management permission.

Tool	What it does
`list_data_compartments`	Every access area: its default access (open to all members, or grantees only), who it’s granted to, and which folders are in it
`save_data_compartment`	Create an access area, or edit one by id
`delete_data_compartment`	Delete an access area and its grants. Refused while any folder or document is still filed in it
`grant_data_access`	Give a role, a group, or one member read or write access to an area
`revoke_data_access`	Remove a grantee’s access to an area
`set_folder_compartment`	Put a folder into an access area, or take it out

Workspace knowledge model (read-only)

Read what the knowledge model knows, as the connected user. Everything runs under the same access rules as in the app, so you only ever read what that member may see. These tools never change the model; reviewing, editing and extracting stay with people in the app and with Genie AI. Answers quote documents, so treat them as untrusted document text.

Tool	What it does
`list_workspace_ontology`	The schema: classes with their properties and entity counts, relationship types, layers and how far reading has got
`search_workspace_ontology`	Search classes, stages, relationship types, layers and entities by name, plus the entities cited in the passages closest in meaning to your query
`search_workspace_entities`	Find entities by name, alias, code or searchable value, optionally within one class
`list_workspace_entities`	One class’s entities as rows with their values, paged, optionally as of a date
`read_workspace_entity`	One entity in full: values with their sources, names, links, conditions and history
`read_my_person_entity`	Your own Person entity, once you’ve linked it in the app; otherwise cards that may be yours as suggestions
`read_ontology_graph`	The most connected entities and the links among them, or one entity’s surroundings
`find_ontology_paths`	The shortest chains of links between one entity and others
`check_ontology_combination`	Which of an entity’s links hold in a given situation, according to their conditions

Reads are rate limited per member and workspace, so a client can’t use up the limit of your own pages.

Excel workbooks

Create, read, search, and edit real .xlsx files — the same tools available to Genie AI in chat. A workbook is a knowledge document, so renaming, moving, and deleting one uses the knowledge-document tools above.

Tool	What it does
`list_workbooks`	List the workspace’s Excel workbooks, newest first
`create_workbook`	Create a new workbook — sheets, data, and formulas in one call, calculated immediately
`read_workbook`	An overview of every sheet, or one window of a sheet as a grid, paged for a large one
`find_in_workbook`	Find cells whose value or formula matches, with the matching rows
`edit_workbook`	Apply a batch of edits — set cells, insert/delete rows or columns, sort, merge, format, and more — saved together or not at all
`evaluate_workbook_formula`	Calculate one or more formulas against the workbook’s current values, without saving

PowerPoint presentations

List, create, read, and edit real .pptx decks — the same tools available to Genie AI in chat. A presentation is a knowledge document, so renaming, moving, and deleting one uses the knowledge-document tools above.

Tool	What it does
`list_workspace_presentations`	List the workspace’s PowerPoint decks, newest first
`create_workspace_presentation`	Build a deck — titles, bullets, tables, and speaker notes, up to 40 slides — in one call
`read_workspace_presentation`	An overview of every slide, a range of slides in full, or a text search
`edit_workspace_presentation`	Apply a batch of slide, text, notes, and table edits in the deck’s own design — saved together or not at all

Chat templates

List and manage the guided starting points behind Chat templates. Global templates are read-only here.

Tool	What it does
`list_chat_templates`	The global templates plus the workspace’s own
`read_chat_template`	One template in full
`create_chat_template`	Add a template to the workspace’s own library
`update_chat_template`	Change one of the workspace’s own templates

Imported traces

Read and sync the traces imported from LiteLLM and Langdock. Reading needs the tracing permission; changing anything also needs the integrations permission. Imported content is treated as untrusted.

Tool	What it does
`list_imported_traces`	Imported traces, newest first, filtered by source, status, model, or user
`get_imported_trace`	One imported trace in full
`get_tracing_integrations`	The LiteLLM connection’s state (never its key) and how the Langdock import works
`sync_litellm_traces`	Run one LiteLLM sync now
`set_litellm_tracing_enabled`	Pause or resume the LiteLLM connection
`import_trace_log`	Import a small pasted log as Langdock traces

Connecting LiteLLM (URL and API key) is not available here, so a credential never passes through a model — do it on Tracing → Integrations.

Genie Cloud backend management

Manage a project’s connected Genie Cloud backend: end-user roles, sign-in providers, and access settings. Only the project owner can use these tools.

Tool	What it does
`get_project_cloud_settings`	Backend status, region, registered end-users, roles and role assignments, enabled sign-in providers, and access settings
`add_project_role` / `delete_project_role`	Add or remove a custom end-user role
`assign_project_role` / `remove_project_role_from_user`	Assign or remove a role for a specific end-user
`toggle_project_auth_provider`	Enable or disable a social sign-in provider (currently Google) for the project’s end-users
`update_project_access_settings`	Update private mode, the default role for new users, and the auto-approved email list
`approve_project_user`	Approve an end-user waiting for access while private mode is on
`invite_project_users`	Pre-approve a list of emails so they skip the pending-approval state

Genie Cloud database

Browse the tables in a project’s connected Genie Cloud database. Read-only. Only the project owner can use these tools, since table data may include the project’s own end-users’ data.

Tool	What it does
`list_project_database_tables`	List a project’s database tables and views, with column and approximate row counts
`get_project_database_table_preview`	Column definitions and up to 25 sample rows for one table
`list_project_cloud_migrations`	List the tracked database migrations for a project — one entry per deployment, newest first, with how many statements it holds, how many a rollback could undo, and its status (applied / reverted / partly reverted). Also flags changes already applied in Supabase but not yet shipped with a deployment. Doesn’t return SQL text, only the shape of the history — to undo a change, use `rollback_project_deployment`

Workspace secrets

See what secrets your workspace holds. Only the tool to list names exists here on purpose — a secret’s value must never pass through an AI, so adding, replacing, deleting, and sharing stay on the Secrets settings page.

Tool	What it does
`list_secrets`	List the names of workspace, Genie Agent, and Genie Tool secrets with their scope and whether they’re shared with apps — limited to the scopes your role can view. Values are never returned

Project secrets

Manage the secrets available to a project’s Genie Cloud Edge Functions. Only the project owner can use these tools.

Tool	What it does
`list_project_secrets`	List secret names configured for a project (values are never returned)
`set_project_secret`	Create or update a named secret
`delete_project_secret`	Delete one or more named secrets

Project storage

Browse and manage the files in a project’s Genie Cloud storage buckets. Only the project owner can use these tools.

Tool	What it does
`list_project_storage_files`	List the files and folders in a storage bucket, optionally scoped to a subfolder
`create_project_storage_folder`	Create a folder in a storage bucket
`delete_project_storage_items`	Permanently delete one or more files or folders (deleting a folder deletes everything inside it) — requires `confirm_delete: true`
`move_project_storage_item`	Move or rename a single file — overwrites any file already at the destination, so it requires `confirm_move: true`

Uploading new file content isn’t available via MCP — an MCP tool call only carries JSON, not file bytes. Upload images and videos from the project’s storage tab in the web app, or ask the Genie workspace AI to do it for you.

Genie Cloud scheduled jobs

Manage recurring schedules for a project’s deployed edge functions. See Scheduled jobs for a full guide. Only the project owner can use these tools.

Tool	What it does
`list_project_cloud_functions`	List a project’s deployed edge functions, with status and last-updated time — useful to find a function’s slug before scheduling it
`list_scheduled_jobs`	List a project’s scheduled jobs, including schedule, last run time, and the real outcome of that run
`schedule_job`	Schedule a deployed edge function to run on a timer, or update an existing schedule (idempotent by job name)
`unschedule_job`	Remove a scheduled job from a project
`run_scheduled_job_now`	Fire a scheduled job’s function immediately to verify it, without changing the schedule

Project Prompt Queue

When a follow-up prompt arrives for a project that’s already building, Genie queues it instead of refusing it — see Genie AI queues a busy project’s prompt. These tools let an external AI client inspect and manage that queue directly.

Tool	What it does
`list_prompt_queue`	Show a project’s prompt queue: active/paused state (and why), pending items, when the next one goes out, and recent history
`pause_prompt_queue`	Pause the queue — nothing new is sent until resumed. Never stops a build already running
`resume_prompt_queue`	Resume a paused queue. Restarts the cooldown from now, so resuming never fires a burst
`remove_prompt_queue_item`	Cancel one still-waiting queued prompt
`reorder_prompt_queue_item`	Move a waiting prompt to a different position in the queue
`clear_prompt_queue`	Cancel every still-waiting prompt in a project’s queue — requires `confirm_clear: true`
`set_prompt_queue_delay`	Change the cooldown between a run completing and the next queued prompt going out
`send_next_queued_prompt_now`	Skip the remaining wait and send the next queued prompt as soon as the project is free. Also resumes a paused queue

Workspace Auto

Read and control your Auto in the connected workspace, the same actions Genie AI has. Approving a suggestion isn’t available here; it stays a confirmation you press in Genie.

Tool	What it does
`read_workspace_auto`	Your Auto in this workspace: switches, next check, waiting and decided suggestions, recent runs
`update_workspace_auto`	Switch Auto and its push notifications on or off (personal, covers every workspace)
`start_workspace_auto_run`	Run Auto now: `shallow` (free check) or `full` (a model run, charged like a chat turn; refused when busy, rate-limited or out of credits)
`dismiss_workspace_auto_output`	Dismiss one waiting suggestion

Notifications

Read and manage your own notification inbox in the connected workspace. Every tool acts only on your own messages. Text written by colleagues is returned as information to read, never as instructions to follow. Writing to colleagues isn’t available here; that stays a confirmation you press in Genie.

Tool	What it does
`list_my_workspace_notifications`	Your inbox in this workspace, newest first, optionally only unread
`mark_my_workspace_notifications_read`	Mark chosen messages, or all of them, as read
`send_me_a_workspace_notification`	Send yourself a notification, for example a reminder
`get_my_workspace_notification_settings`	Whether this workspace’s notifications also reach you by push and by email
`set_my_workspace_notification_settings`	Switch push and email delivery for this workspace on or off

Workspace chat

Send questions to the Genie workspace AI and browse past conversations. Every tool here acts on any chat in the connected workspace, including one a teammate started, not just the caller’s own — list_workspace_chats/search_workspace_chats default to the caller’s own conversations, but accept a scope: "workspace" to include everyone’s.

Tool	What it does
`send_workspace_chat`	Ask a question about your workspace and get an AI response
`create_workspace_chat`	Start or continue a persistent chat thread (saved to chat history)
`list_workspace_chats`	Recent conversations with title and preview. Own conversations by default; pass `scope: "workspace"` to include teammates’
`get_workspace_chat`	Read a conversation’s transcript by id, including a teammate’s — windowed to the most recent 30 turns by default (up to 100), each turn capped at 2,000 characters. Check `truncated`/`totalMessages` before assuming you have the whole thing
`search_workspace_chats`	Search across past messages. Own conversations by default; pass `scope: "workspace"` to include teammates’
`search_agent_run_traces`	Fulltext-search the execution trace behind the connected user’s own Genie AI conversations — the reasoning, every tool call, and the final answer, not just the visible chat text. Useful for questions like “why did that fail earlier” or “which turn called the deploy tool”
`rename_workspace_chat`	Rename any conversation in the workspace, including one a teammate started
`pin_workspace_chat`	Pin or unpin a conversation to the top of the chat history sidebar, ahead of the usual date groups
`delete_workspace_chat`	Permanently delete a conversation in the workspace — your own, or one a teammate started and shared, and all its messages. Irreversible — check the conversation’s `startedByUser` field first if you didn’t start it yourself. Deleting a teammate’s chat needs the permission to delete chats (owners and admins have it by default); a teammate’s private chat can’t be reached
`get_project_chat_connection`	Show which workspace chat is a project’s main conversation — the one where all the work on that project happens — how that was resolved, and which other projects share it
`list_projects_sharing_chat`	List every project that uses a given workspace chat as its main conversation
`connect_project_chat`	Make a workspace chat a project’s main conversation. Keeps an existing connection by default — pass `replace: true` to switch it

Workspace MCP integrations

Manage the MCP server integrations (Linear, GitHub, Notion, Stripe, etc.) that power your workspace’s connected tools. Only workspace owners and admins can use these tools.

Tool	What it does
`list_workspace_mcp_servers`	All configured integrations — name, URL, status, auth type, and whether its credentials are shared or per-member (no credentials returned)
`add_workspace_mcp_server`	Add a new MCP server integration
`update_workspace_mcp_server`	Edit name, URL, transport, rotate a bearer token, or switch it between shared and per-member credentials
`toggle_workspace_mcp_server`	Enable or disable a server without removing it
`delete_workspace_mcp_server`	Permanently remove a server and its stored credentials
`test_workspace_mcp_server_connection`	Open a test connection and list the tools it exposes

Your connections

Check where you personally stand with each of the workspace’s integrations — separate from whether the workspace has the integration configured at all. See shared vs. personal connections. Read-only, scoped to the calling user.

Tool	What it does
`list_my_connections`	Every workspace integration, and whether you’ve personally connected your own account to it
`get_connection_status`	Detailed status for one integration — connected or not, and whether it’s shared or per-member

Workspace chat channels

Manage Genie on WhatsApp, Slack, and Teams — connecting the workspace’s own accounts, linking your personal one, and sending messages through either.

Tool	What it does
`list_chat_channels`	The workspace’s own connected chat accounts — platform, who answers, sender allowlist, and setup info
`list_chat_channel_threads`	Who has written in on a channel, with message counts and the workspace chat each maps to
`create_chat_channel`	Connect a channel to the workspace (a WhatsApp number, a Slack install, a Teams tenant). Only owners and admins
`set_chat_channel`	Rename a channel, change who answers it, edit its sender allowlist, or pause/resume it. Only owners and admins
`remove_chat_channel`	Disconnect a channel and delete its stored credentials. Only owners and admins
`send_chat_channel_message`	Send a message from a workspace channel to a real person outside the workspace
`create_chat_link_code`	Mint a one-time code to link your own WhatsApp, Slack, or Teams account. Valid 15 minutes, shown once
`list_chat_identity_links`	Chat accounts linked to the workspace — your own by default, or everyone’s for an owner or admin
`set_chat_identity_link`	Anchor a linked chat account to one project, or clear the anchor
`unlink_chat_identity`	Disconnect a linked chat account

PII rules

Inspect and manage the workspace PII detection rules. Only workspace owners and admins can make changes. See Workspace PII rules for a full guide.

Tool	What it does
`list_workspace_pii_rules`	Built-in detectors and custom regex rules
`list_workspace_pii_detections`	Recent censored detection log entries. Filter by source with `surface`: `all` (default), chats and Genie Agents, or the knowledge model’s document reading
`set_workspace_pii_rule`	Change a rule’s action (`log`, `block`, `ignore`) or toggle it on/off
`create_workspace_pii_rule`	Add a custom regex rule
`update_workspace_pii_rule`	Edit an existing custom rule’s label, pattern, confidence, or action
`delete_workspace_pii_rule`	Remove a custom rule
`reset_workspace_pii_rules`	Reset all built-in detectors to their defaults

Workspace Governance

Project reviews, shared-asset oversight, and natural-language compliance rules. See Governance for a full guide. Access follows the same rule as the Governance page rather than the RBAC permission catalog: owners and admins can read and manage; a member or editor granted “View governance” can read but not manage.

Tool	What it does
`list_governance_projects`	Governance overview of the workspace’s projects: owner, visibility, latest version, review verdict, compliance state, and integration-risk signals. Filter with `only_failing` / `only_unreviewed`
`get_project_compliance`	One project’s governance detail: current verdict plus the newest result of every compliance rule (with reasoning) and a bounded recent history
`review_project`	Record a verdict — `approved`, `flagged`, or `disabled` (blocks new builds from everyone but the owner) — or `clear` to remove it
`list_compliance_rules`	List the workspace’s compliance rules plus the built-in template library a new rule can start from
`create_compliance_rule`	Create a rule (name, severity, a natural-language failure condition), optionally from a template, with an option to check existing projects immediately. Owner/admin only
`update_compliance_rule`	Change a rule’s name, description, severity, failure condition, and/or enabled state. Owner/admin only
`delete_compliance_rule`	Permanently delete a rule and its check history. Requires `confirm_delete: true`. Owner/admin only
`run_compliance_checks`	Run enabled rules now, on one project or across the workspace

Workspace Guardrails

Configure guardrails on the workspace chat agent, for paid workspaces. See Guardrails for a full guide. Requires the security.guardrails.view / security.guardrails.manage permissions — the same ones the settings page enforces.

Tool	What it does
`get_guardrails`	Read whether guardrails are enabled, the per-category content-filter strength, denied topics, profanity filter, blocked words, custom blocked message, and the attachment-scanning switches
`list_guardrail_events`	List recent messages a guardrail blocked — who, where, which category or topic fired. Never the message text
`update_guardrails`	Partial update to the guardrail configuration, applied live — including whether to scan attached images and whether to block attachments guardrails can’t check at all. Omitted fields keep their current value; topic and word lists replace the whole list. At least one protection must stay active
`set_guardrails_enabled`	Turn guardrail enforcement on or off. Enabling with no saved configuration starts from the protective defaults

Security alerts

Summarize recent PII and Guardrails blocks, and manage your own email alert subscription — the tools behind the Activity page’s Security alerts panel. See Activity log for the panel itself.

Tool	What it does
`get_workspace_security_alerts`	Summary of recent PII and Guardrails blocks. Each source (PII, Guardrails) is included only if you can already see its underlying log
`get_my_security_alert_subscription`	Whether you’re currently subscribed to get emailed when a new block happens
`set_my_security_alert_subscription`	Turn your own email alert subscription on or off — you can only manage your own subscription, never another member’s

Workspace Tracing

Workspace-wide observability over every member’s Genie AI turns — the admin counterpart to search_agent_run_traces above, which is scoped to the caller’s own turns. See Tracing for a full guide. Requires the security.tracing.view permission (owner/admin by default; a custom role can be granted it) on every call.

Tool	What it does
`list_workspace_traces`	List run traces across all workspace members: status, surface, model, tokens, billed credits, duration, tool names, and short excerpts. Optional fulltext `query`; newest first
`get_workspace_trace`	Read one run trace in full: timings, the user message, reasoning, every tool call (bounded input/output preview), the answer, any error, resolved member/project names, and the trace’s flaggings (see Tracing)

Pricing

Tool	What it does
`get_genie_pricing`	Current, Stripe-sourced pricing for all Genie plans, seats, credit top-ups, and add-ons

Status

Tool	What it does
`get_status_page`	The same read the public status page uses: overall state (operational, degraded, down, or maintenance), each component’s current state and uptime, and any active incidents

Design

Tool	What it does
`get_design_principles`	Genie’s current house design direction — the look-and-feel guidance the project build agent follows. Call it before writing a design brief for `create_project` or `send_followup_prompt` so your instructions stay consistent with how Genie actually builds

Design mock-ups

Mirrors Genie AI’s design mock-up feature: repaint a real screenshot of a project with a requested design change, iterate on feedback, and turn an approved mock-up into a build brief. Images are returned as native MCP image content, the same way get_project_screenshots returns them. No credit/billing dimension — metered only by per-session and per-day round caps.

Tool	What it does
`generate_design_mock`	Generate a design mock-up round: screenshot (or reuse a previous mock-up/round), repaint it with the requested change plus a required layout and color direction, and return both images
`list_design_mocks`	List a project’s mock-up sessions, to pick a conversation back up
`get_design_mock_round`	Re-fetch an earlier round’s images
`record_design_mock_feedback`	Store what the user said about a round, for the next round and later chats
`brief_design_mock_for_build`	Turn an approved mock-up’s change list into a ready-to-paste design section for `send_followup_prompt` or `create_project`

Quick examples

Create a project and follow up

Tool: create_project
{ "prompt": "A SaaS dashboard with auth, dark mode, and a billing page" }

→ Returns: deploymentUrl, slug, runId

Tool: send_followup_prompt
{ "project_slug": "my-app-abc123", "prompt": "Add a CSV export button to the reports page" }

→ Returns: ok, runId

The create_project call starts the build immediately and returns the deployment URL. Use get_project_build_status to poll for everything at once — phase, ETA, progress, and the closing summary once it’s done — or get_project_status for a lightweight running/not-running check. Pass the returned runId as get_project_build_status’s run_id to pin the answer to that exact turn instead of the project’s newest one — useful if you fire off more than one prompt in a row. It’s optional; omit it and you get the newest turn, same as before.

Roll back to a previous version

Tool: list_project_deployment_versions
{ "project_slug": "my-app-abc123" }

→ Returns: version ids, newest first

Tool: rollback_project_deployment
{ "project_slug": "my-app-abc123", "version": "42", "confirm_rollback": true }

Omit version to roll back to the most recent previous version. The rollback runs in the background — poll get_project_deployment_status for progress.

Check credit usage this month

Tool: get_credit_usage
{ "range": "30d", "group_by": "project" }

→ Returns: { totalCredits: 142, byProject: [...] }

Admins can pass scope: "workspace" to see total consumption across all members. Members can only query their own usage. Add "sort": "credits_desc" (or credits_asc) to sort the breakdown by spend, highest first — or date_desc/date_asc when grouping by day.

Ask a question about a project’s code

Tool: query_project_code_graph
{ "project_slug": "my-app-abc123", "question": "who calls createCheckoutSession" }

→ Returns: matching symbols with file paths and exact line spans

Invite a new team member

Tool: invite_workspace_member
{ "role": "member", "max_uses": 1, "expires_in_days": 7 }

→ Returns: { inviteUrl: "https://www.genie-app.de/workspace/invite/abc123", role: "member" }

Permissions

Role-based access is enforced on every tool call.

Action	Required role
Read workspace info, members, projects, chat	Any member
Read workspace-wide credit usage	Owner or admin
Invite or remove members, change roles	Owner or admin
Update workspace name or settings	Owner or admin
Manage MCP integrations	Owner or admin
Check your own connection status for an integration	Any member
Manage custom roles and permissions	Owner, admin, or a role granted `roles.manage`
Create, edit, or revoke a workspace API key	Owner or admin
Manage PII rules	Owner or admin
Create, update, rename, archive, or delete projects	Any member
Move a project in or out of the workspace	Owner, admin, or member (not editor)
Check or cancel a scheduled project deletion	Project owner
Send follow-up prompts and trigger builds	Any member
Turn Auto mode on or off for a project	Any member
Query a project’s code graph	Any member
List or read a project’s files	Any member
Read or update a project’s design guidelines	Any member
Read a project’s feature tree	Any member (who can view the project)
Add or edit a feature in the tree	Project owner
Read a project’s known issues	Any member (who can view the project)
Report a known issue	Project owner
Search the shared bug-solution knowledge base	Any connected user
Search or forget the connected user’s memory	Any connected user
Read or write a workspace-wide knowledge document	Any member
Read or write a project-scoped knowledge document	Anyone with edit access to that project — tighter than plain view access, since a public project must never expose its team’s internal material
Create, rename, or delete a knowledge-document folder	Any member
Browse or import a file from a connected cloud drive as a knowledge document	Any member, using their own drive connection
View or redraw a knowledge document’s cover picture, or repair its search index	Any member (who can read the document)
Manage knowledge access areas — create, edit, grant, or revoke	Owner, admin, or a role granted knowledge-access management
Search the connected user’s own Genie AI run traces	Any connected user
View a project’s screenshots or search its live console logs	Any member (who can view the project)
Read or set a project’s main workspace chat	Any member
Read, rename or pin a workspace chat (own or a teammate’s), or delete your own	Any member
Delete a chat a teammate started	Members with the permission to delete chats (owners and admins)
Check what a project is doing right now (build, autofix, queue)	Any member (who can view the project)
See who else has a project open right now	Any member (who can view the project)
View or manage a project’s prompt queue	Any member
Generate, view, or give feedback on a project’s design mock-ups	Any member
Roll back a project or view its version history	Project owner
Read or update a project’s SEO settings	Project owner
Browse a project’s Genie Cloud database tables	Project owner
List a project’s deployed edge functions	Project owner
Manage a project’s scheduled jobs	Project owner
Manage a project’s Genie Cloud roles, sign-in providers, and access settings	Project owner
View workspace secret names (never values)	Members who can view the relevant integrations, agents, or tools
Manage a project’s secrets	Project owner
Manage a project’s storage files	Project owner
Read Genie pricing	Any member
Read Genie’s status page	Any connected user
View Governance (project reviews, compliance results)	Owner, admin, or a member granted “View governance”
Manage compliance rules and run checks	Owner or admin
Read guardrail configuration and blocked-message log	Owner, admin, or a role granted `security.guardrails.view`
Change guardrail configuration	Owner, admin, or a role granted `security.guardrails.manage`
Read workspace-wide Genie AI traces	Owner, admin, or a role granted `security.tracing.view`
Connect, edit, or remove a workspace chat channel	Owner or admin
Create a link code, or view/manage your own linked chat account	Any member
Send a message through a workspace chat channel	Any member

Connect MCP integrations to your workspace
Genie on WhatsApp, Slack, and Teams
Workspace PII rules
Workspace guardrails
Governance
Tracing
Scheduled jobs
Workspace members and roles
Workspace API keys — a simpler bearer-token HTTP API for talking to Genie AI itself, rather than the much broader tool surface here

​Connect your client

​Endpoint

​Authentication

​Example: Claude Desktop

​Available tools

​Workspace management

​Workspace roles and permissions

​Workspace API keys

​Projects

​Project code graph

​Project Files

​Project Design Guidelines

​Project feature tree

​Bug tracking

​User memory

​Project memory

​Workspace knowledge documents

​Knowledge access areas

​Workspace knowledge model (read-only)

​Excel workbooks

​PowerPoint presentations

​Chat templates

​Imported traces

​Genie Cloud backend management

​Genie Cloud database

​Workspace secrets

​Project secrets

​Project storage

​Genie Cloud scheduled jobs

​Project Prompt Queue

​Workspace Auto

​Notifications

​Workspace chat

​Workspace MCP integrations

​Your connections

​Workspace chat channels

​PII rules

​Workspace Governance

​Workspace Guardrails

​Security alerts

​Workspace Tracing

​Pricing

​Status

​Design

​Design mock-ups

​Quick examples

​Create a project and follow up

​Roll back to a previous version

​Check credit usage this month

​Ask a question about a project’s code

​Invite a new team member

​Permissions

​Related pages

Connect your client

Endpoint

Authentication

Example: Claude Desktop

Available tools

Workspace management

Workspace roles and permissions

Workspace API keys

Projects

Project code graph

Project Files

Project Design Guidelines

Project feature tree

Bug tracking

User memory

Project memory

Workspace knowledge documents

Knowledge access areas

Workspace knowledge model (read-only)

Excel workbooks

PowerPoint presentations

Chat templates

Imported traces

Genie Cloud backend management

Genie Cloud database

Workspace secrets

Project secrets

Project storage

Genie Cloud scheduled jobs

Project Prompt Queue

Workspace Auto

Notifications

Workspace chat

Workspace MCP integrations

Your connections

Workspace chat channels

PII rules

Workspace Governance

Workspace Guardrails

Security alerts

Workspace Tracing

Pricing

Status

Design

Design mock-ups

Quick examples

Create a project and follow up

Roll back to a previous version

Check credit usage this month

Ask a question about a project’s code

Invite a new team member

Permissions

Related pages