Back to MCP docs

Tools reference

Every tool the Drento MCP server exposes. Generated from the live tool manifest.

These are the tools any connected AI client can call. Each tool lists its required OAuth scope, annotations, and JSON Schema.

  • drento_list_projects

    List Projects

    • Read-only
    • Idempotent

    List the user's Drento projects (id, name, idea, platform, updatedAt). Supports cursor pagination — pass the returned nextCursor to fetch the next page. Use this when the user asks 'what projects do I have', 'show my projects', or wants to pick a project to work on.

    Required scope:projects:read

  • drento_get_project

    Get Project

    • Read-only
    • Idempotent

    Fetch the full state of a single Drento project by its UUID. Use this when the user asks 'show me project X', 'what's the idea for this project', or wants to inspect a project's blueprint, design system, or generated artifacts.

    Required scope:projects:read

  • drento_create_project

    Create Project

    • Idempotent

    Create a new Drento project with an idea and target platform (website or mobile). Use this when the user says 'start a new project for X', 'create an app idea about Y', or 'I want to build Z'. Returns the new project's id and a resource_link to its state.

    Required scope:projects:write

  • drento_delete_project

    Delete Project

    • Destructive
    • Idempotent

    Permanently delete a Drento project and all of its generated artifacts (blueprint, wireframes, designs, logos). Destructive — cannot be undone. Use this only when the user explicitly says 'delete project X' or 'remove this project'.

    Required scope:projects:write

  • drento_rename_project

    Rename Project

    • Idempotent

    Change a Drento project's display name. Use this when the user says 'rename project X to Y' or 'change the project name'.

    Required scope:projects:write

  • drento_set_idea

    Set Project Idea

    • Idempotent

    Update the plain-English idea description for a Drento project. The idea drives every downstream agent (architect, designer, advisor). Use this when the user says 'change the idea to X', 'this project is now about Y', or 'refine the idea'.

    Required scope:projects:write

  • drento_set_platform

    Set Project Platform

    • Idempotent

    Change a Drento project's target platform between 'website' and 'mobile'. Use this when the user says 'this should be a mobile app', 'turn this into a website', or 'switch the platform to X'.

    Required scope:projects:write

  • drento_generate_blueprint

    Generate Blueprint

    • Idempotent

    Generate the full app-architecture blueprint for a Drento project — pages, views, modals, sections. Reads the project's idea and platform, then produces a tree of nodes. Use this when the user asks to 'design the app structure', 'generate the blueprint', or 'plan out the pages of my project'. Long-running (10-30s) — emits progress notifications.

    Required scope:blueprint:write

  • drento_expand_node

    Expand Blueprint Node

    • Idempotent

    Generate child nodes under an existing blueprint node — sub-pages, views, or modals. Use this when the user says 'expand this page', 'add sub-pages', or 'flesh out this node'.

    Required scope:blueprint:write

  • drento_edit_node

    Edit Blueprint Node

    • Idempotent

    Modify an existing blueprint node — change its name, description, or type. Use this when the user says 'rename this page', 'change the description', or 'turn this into a modal'.

    Required scope:blueprint:write

  • drento_delete_node

    Delete Blueprint Node

    • Destructive
    • Idempotent

    Remove a blueprint node and all its descendants. Also removes the node's generated wireframes and designs. Destructive — only call when the user explicitly says 'delete this page', 'remove the node', or similar.

    Required scope:blueprint:write

  • drento_generate_wireframe

    Generate Wireframe

    • Idempotent

    Generate a low-fidelity wireframe (layout + structure, no colors) for a specific node in a Drento project. Use this when the user asks to 'wireframe this page', 'sketch out the layout', or 'show me the structure'. Long-running (30s+) — emits progress notifications.

    Required scope:wireframes:write

  • drento_regenerate_wireframe

    Regenerate Wireframe

    • Idempotent

    Discard the existing wireframe for a node and generate a fresh one. Use this when the user says 'try another wireframe', 'regenerate this layout', or is unhappy with the previous output. Long-running (30s+).

    Required scope:wireframes:write

  • drento_generate_design

    Generate Design

    • Idempotent

    Generate a high-fidelity design HTML for a node in a Drento project. Applies the project's design system (colors, fonts, components). Use this when the user asks Claude to design, mock up, or visualize a screen — 'design the hero page', 'mock up the dashboard', 'show me a design'. Long-running (30s+) — emits progress notifications.

    Required scope:designs:generate

  • drento_regenerate_design

    Regenerate Design

    • Idempotent

    Discard the existing high-fidelity design for a node and generate a new one. Use this when the user says 'try another design', 'regenerate this screen', or 'redesign this with different style'. Long-running (30s+).

    Required scope:designs:generate

  • drento_set_design_system

    Generate Design System

    • Idempotent

    Generate a fresh design system for a Drento project — color palette, typography, component tokens, and design personality. Use this when the user says 'generate the design system', 'build the brand', or 'create design tokens'.

    Required scope:design-system:write

  • drento_set_colors

    Regenerate Color Palette

    • Idempotent

    Regenerate the color palette of a Drento project's design system. Use this when the user says 'try different colors', 'regenerate the palette', or wants a new color scheme without touching fonts or components.

    Required scope:design-system:write

  • drento_set_fonts

    Regenerate Font Pairing

    • Idempotent

    Regenerate the typography (heading + body fonts) of a Drento project's design system. Use this when the user says 'try different fonts', 'pick new typography', or wants to change only the type pairing.

    Required scope:design-system:write

  • drento_set_components

    Regenerate Component Tokens

    • Idempotent

    Regenerate the component-token set (buttons, inputs, cards, modals, etc.) for a Drento project's design system. Use this when the user says 'regenerate components', 'try different component styles', or wants to refresh the component design language.

    Required scope:design-system:write

  • drento_merge_components

    Merge Component Tokens

    • Idempotent

    Merge the newly generated component tokens with the existing set, keeping user overrides where they exist. Use this when the user says 'merge in the new components' or 'keep my changes but bring in new tokens'.

    Required scope:design-system:write

  • drento_set_style

    Set Design Style

    • Idempotent

    Set the overall design style/personality of a Drento project (e.g. 'minimal', 'playful', 'editorial', 'glassmorphism'). Affects how subsequent generations render. Use this when the user says 'make it more minimal', 'change the vibe to playful', or names a style.

    Required scope:design-system:write

  • drento_generate_logo

    Generate Logo

    • Idempotent

    Generate logo concept variants for a Drento project. Reads the project's idea, name, and design personality. Use this when the user says 'design a logo', 'create a brand mark', or 'generate logo concepts'. Long-running — emits progress notifications.

    Required scope:logos:generate

  • drento_delete_logo

    Delete Logo

    • Destructive
    • Idempotent

    Remove the saved logo from a Drento project. Destructive — cannot be undone. Use this when the user says 'remove the logo', 'clear the brand mark', or 'delete the current logo'.

    Required scope:logos:generate

  • drento_set_logo

    Set Active Logo

    • Idempotent

    Choose which logo variant becomes the project's active logo. Pass the URL of the preferred variant (from a previous drento_generate_logo call). Use this when the user says 'use this one', 'pick variant 2', or 'set this as the logo'.

    Required scope:logos:generate

  • drento_advisor_chat

    Chat with Advisor

    Stream a chat reply from Spark, the Drento product advisor. Spark answers questions about the project, suggests improvements, and reviews the blueprint or design system. Use this whenever the user wants advice, feedback, or a second opinion on their project. Streams partial text via notifications/message.

    Required scope:advisor:chat

  • drento_list_clients

    List Connected Clients

    • Read-only
    • Idempotent

    List every OAuth client (Claude Desktop, Cursor, Windsurf, etc.) and Personal Access Token the user has authorized to access Drento. Use this when the user asks 'what apps are connected', 'show my MCP clients', or 'list authorized integrations'.

    Required scope:account:read

  • drento_revoke_client

    Revoke Connected Client

    • Destructive
    • Idempotent

    Revoke an OAuth client's access to the user's Drento account. Destructive — the client will lose access immediately and must re-authorize. Use this when the user says 'revoke Claude Desktop access', 'disconnect this app', or 'remove this integration'.

    Required scope:account:read

  • drento_get_audit_log

    Get Audit Log

    • Read-only
    • Idempotent

    Fetch the user's MCP audit log — every tool call made through the MCP server, with timestamps, outcomes, and durations. Cursor-paginated. Use this when the user asks 'show my MCP activity', 'what tools have been called', or 'audit my account'.

    Required scope:account:read

  • drento_get_quota

    Get Quota Usage

    • Read-only
    • Idempotent

    Fetch the user's current MCP quota and usage in USD. Returns remaining budget, limit, used amount, and reset time. Use this when the user asks 'how much credit do I have', 'show my usage', or 'what's my quota'.

    Required scope:account:read