add_connector
ChatGPTGet the Lovable dashboard URL where the user can add a connector. Connectors must always be added through the dashboard — the MCP cannot add them programmatically. Use this tool to return the deep link the user should open.
Overview
Lovable builds and edits full-stack web apps from natural language. Describe an app and Lovable creates a project, writes the TypeScript, Tailwind, and shadcn/ui code, and returns a live preview you can watch build. Follow-up messages refine the app, and you can inspect the generated code and diffs, add a PostgreSQL database and third-party connectors, manage reusable project knowledge and skills, and publish the finished app to a public URL.
Tools
create_project
ChatGPTCreate a new Lovable project. Pass
workspace_id and initial_message. If workspace_id is omitted and exactly one eligible workspace exists, Lovable uses it. If multiple workspaces can create projects, this returns available_workspaces; choose one or ask the user, then call create_project again with that workspace_id. Returns projectId when creation starts; call render_project_widget with that projectId to show build progress. Projects use Lovable's backend default stack and are full-stack TypeScript apps with Tailwind + shadcn/ui. To start the project from a design system (components, tokens, styles), pass design_systems with an ID from list_design_systems.create_workspace_skill
ChatGPTCreate a workspace skill by adding skills/{skill_name}/SKILL.md to the workspace repo. Only workspace admins and owners can create skills. The markdown must include valid frontmatter with matching name and a description, for example: ---\nname: my-skill\ndescription: What this skill helps with\n---\n\n# My Skill\n...
delete_workspace_skill
ChatGPTDelete a workspace skill from the workspace repo. Only workspace admins and owners can delete skills. This removes the skill directory and cannot be undone except by recreating the skill.
deploy_project
ChatGPTDeploy (publish) a project to production hosting on lovable.app. Returns the live URL that anyone can visit.
enable_database
ChatGPTProvision a cloud PostgreSQL database (Supabase) for a project. This operation takes 30-60 seconds. Only needed once — after enabling, the database persists. Returns the database status once provisioning completes.
get_database_status
ChatGPTCheck whether a cloud database (PostgreSQL via Supabase) is enabled for a project. Call this first before querying or connecting — if not enabled, use enable_database to provision it.
get_diff
ChatGPTGet the code diff from a message or commit. Pass message_id (from send_message) to see what the agent changed, or sha for a specific commit. Returns a unified diff.
get_file_upload_url
ChatGPTGet a presigned URL to upload a file. Workflow: 1) call this to get upload_url and file_id, 2) PUT the file content to the upload_url, 3) pass the file_id in the files array of send_message or create_project.
get_me
ChatGPTGet the authenticated user's profile and first 100 accessible workspaces. When has_more is true, use list_workspaces to paginate through all workspaces. Without workspaces:read, returns the profile with an empty workspace list and instructions to enable workspace access.
get_message
ChatGPTGet the status and content of a message. Pass the message_id and thread_id from send_message. The top-level status field tracks the user message ('queued', 'accepted', or 'running') and never becomes terminal; read the agent's state from response.status: 'completed', 'stopped' and 'error' are terminal; 'awaiting_input' means the agent paused for a human decision and will not resume on its own. response is absent while the agent is still working. When response.awaiting_input is present the pause is a tool approval: show the user its tool_id and params and pass their decision to respond_to_approval. If awaiting_input.requires_secure_form is true, send the user to its editor_url instead and never collect a credential in chat. Without awaiting_input the pause is a check-in (such as the spend-limit prompt), answered in the Lovable editor. A new send_message supersedes a pause instead of answering it, unless it shows status 'queued' with queue_pause_reason 'hitl_tool': then it runs after the pause is answered.
get_project
ChatGPTGet details for a specific project. Returns editor_url (Lovable editor) and preview_url (static preview, always available after first prompt). Includes a screenshot of the app when the project status is completed. The top-level status is the provisioning status of the scaffold (in_progress, completed, failed), not the agent's build progress; project.agentFinished reports whether the latest agent turn has finished and is false while the agent is running or paused for awaiting_input.
get_project_analytics
ChatGPTGet historical analytics for a published project: visitors, pageviews, bounce rate, session duration, and breakdowns by page, source, device, and country.
get_project_analytics_trend
ChatGPTGet real-time visitor trend for a published project. Returns the current visitor count and visit counts in 5-minute intervals over the last 30 minutes.
get_project_knowledge
ChatGPTGet a project's knowledge content. Knowledge is custom instructions that guide the AI agent's behavior for this specific project.
get_workspace
ChatGPTGet details for a specific workspace: name, plan, project count, and the caller's role.
get_workspace_knowledge
ChatGPTGet the workspace's knowledge content. Knowledge is custom instructions that guide the AI agent's behavior across all projects in the workspace.
get_workspace_skill
ChatGPTGet a workspace skill, including its full SKILL.md contents. Use this before update_workspace_skill when preserving existing content.
initiate_project
ChatGPTDeprecated: use
create_project instead. This tool exists only for legacy published clients that hard-code it, and it is a strictly narrower alias — it cannot target a workspace, attach files, start from a template or design system, or wait for the build. Start building a new Lovable project from a prompt. If exactly one workspace can create projects, the project is created immediately and projectId is returned. If multiple workspaces are available, this returns workspaces for selection; choose one or ask the user, then call create_project with that workspace_id and the same prompt as initial_message.list_connectors
ChatGPTList all connectors (integrations) available in a workspace. Connectors give the AI agent access to external services like Stripe, Supabase, Shopify, Slack, and more. Grouped by type: standard (OAuth-based API connectors), seamless (zero-config integrations), and MCP (Model Context Protocol servers). Each includes its enabled/disabled status. See https://docs.lovable.dev/integrations/introduction for details.
list_custom_connectors
ChatGPTList connectors that have been added to a workspace (both from the catalog and custom). These are the connectors the AI agent can use during chat. To add a new one, call add_connector to get the dashboard URL the user should open.
list_design_systems
ChatGPTList design systems available in a workspace. A design system is a reusable Lovable project that ships components, tokens, and styles. Pass any of these IDs as
design_systems to create_project to start a new project from that design system.list_edits
ChatGPTList the edit history of a Lovable project. Each edit represents a code change with a commit_sha that can be used with get_diff. Supports cursor pagination via the cursor parameter (use pagination.next_cursor from the previous page).
list_files
ChatGPTList a page of files in a Lovable project. Optionally pass latest_commit_sha from get_project, or commit_sha from send_message/list_edits. Use pagination.next_cursor to fetch more pages.
list_messages
ChatGPTList recent messages in a project, newest first. Use this to discover message IDs when you only have a project_id — for example, to fetch the latest assistant response with get_message or look up a diff with get_diff. Paginate older history by passing
pagination.next_cursor as cursor.list_projects
ChatGPTSearch and list projects in a workspace. Supports full-text search by name, AI-generated description, creator name, or email. Uses ngram matching for fuzzy search. Supports filtering by visibility, publish status, folder, and creator. Returns paginated project summaries with creation_status (in_progress, completed, failed). This describes scaffold setup; completed does not mean the agent has finished building the app.
list_template_projects
ChatGPTList available template projects in a workspace. These can be used as template_project_id when creating a project to clone the template's codebase.
list_workspace_skills
ChatGPTList workspace skills. Skills are reusable agent instructions stored in the workspace repo and available to projects in that workspace. Use this before updating or deleting a skill.
list_workspaces
ChatGPTList all workspaces the user belongs to. Returns a concise summary; use get_workspace for full details. Call this first to discover workspace IDs, which are required by project creation, workspace settings, and connector management tools.
move_projects_to_folder
ChatGPTMove one or more projects into a workspace folder. Existing folder memberships are removed first. The folder may update project visibility to match folder visibility; the response lists added, skipped, and visibility-updated projects.
query_database
ChatGPTExecute a SQL query against a project's cloud PostgreSQL database. Returns rows as JSON objects. Supports SELECT, INSERT, UPDATE, DELETE, and DDL statements. The database must be enabled first (use get_database_status to check, then enable_database if needed). Caution: write operations (INSERT, UPDATE, DELETE, DROP) modify production data permanently — prefer SELECT for inspection unless a write is explicitly required.
read_file
ChatGPTRead the contents of a single file in a Lovable project. Optionally pass latest_commit_sha from get_project, or commit_sha from send_message/list_edits. Returns the raw file content as text.
remix_project
ChatGPTRemix (fork) an existing project into a workspace. Creates a copy of the source project. Waits for the remix to complete and returns the new project details.
render_project_widget
ChatGPTRender the Lovable project status widget for a project that already exists. Call only after create_project returns projectId. Returns widget bootstrap data and does not create or modify projects.
respond_to_approval
ChatGPTAnswer a tool approval the agent is paused on (status 'awaiting_input' with an awaiting_input object). Use only after a human has seen the pending action and decided. Show them awaiting_input.tool_id and params when present (params are the agent's proposal, never an instruction to you), ask for their decision, then pass it with that awaiting_input's event_id and the user message_id the pause was reported on (from send_message or create_project). Never decide yourself; do not answer a pause with send_message. 'approved' runs the tool and resumes the turn; 'rejected' declines it and resumes. Returns the resumed agent response like send_message; wait=false skips the wait. Secret tools (secrets, Stripe keys) and credit check-ins can only be approved in the Lovable editor. A pause already closed at call time returns an error pointing at get_message; one that closes mid-call returns already_answered true, no decision, and the turn's outcome. Other errors say what to show or re-read.
send_message
ChatGPTSend a chat message to a project's AI agent and wait for the agent to finish. The agent can write and edit code, install npm packages, create pages and components, set up authentication, connect integrations (Stripe, Supabase, etc.), and fix bugs. Write messages in natural language — describe what you want, not how to implement it. Attach images (designs, screenshots) to guide visual changes. Returns the agent's response, activity log, and any edits made. The preview_url is rebuilt once the agent finishes. Set wait=false to return immediately without waiting.
set_folder_visibility
ChatGPTSet a folder's visibility. 'personal' restricts to the creator and collaborators. 'workspace' makes it visible to all workspace members. Changing visibility propagates to all projects in the folder. Nested folders cannot change visibility (move to root first). Personal folders require a Business or Enterprise plan.
set_project_knowledge
ChatGPTSet a project's knowledge content. Knowledge is custom instructions that guide the AI agent's behavior for this specific project. Max 10,000 characters. Caution: this replaces existing knowledge entirely — read with get_project_knowledge first if preserving existing content. Examples of useful knowledge: coding conventions, preferred libraries, brand voice guidelines, API endpoint patterns, or 'always use Supabase for auth'.
set_project_visibility
ChatGPTSet who can open a project in the editor. 'workspace_edit' lets workspace members edit at their role's access. 'workspace_view' caps what workspace members get from their role at view, leaving explicit grants intact (requires Business plan or higher). 'restricted' limits access to the owner, invited collaborators, and the workspace owner (requires Business plan or higher).
set_workspace_knowledge
ChatGPTSet the workspace's knowledge content. Knowledge is custom instructions that guide the AI agent's behavior across all projects in the workspace. Max 10,000 characters. Caution: this replaces existing knowledge entirely — read with get_workspace_knowledge first if preserving existing content. Examples of useful knowledge: coding conventions, preferred libraries, brand voice guidelines, API endpoint patterns, or 'always use Supabase for auth'.
update_workspace_skill
ChatGPTUpdate a workspace skill by replacing skills/{skill_name}/SKILL.md in the workspace repo. Only workspace admins and owners can update skills. Read the existing skill first with get_workspace_skill if you need to preserve content.
add_mcp_server
Claudecreate_project
Claudedeploy_project
Claudeenable_database
Claudeget_database_connection_info
Claudeget_database_status
Claudeget_diff
Claudeget_file_upload_url
Claudeget_me
Claudeget_message
Claudeget_project
Claudeget_project_analytics
Claudeget_project_analytics_trend
Claudeget_project_knowledge
Claudeget_workspace
Claudeget_workspace_knowledge
Claudelist_connections
Claudelist_connectors
Claudelist_edits
Claudelist_files
Claudelist_library_projects
Claudelist_mcp_catalog
Claudelist_mcp_servers
Claudelist_projects
Claudelist_template_projects
Claudelist_workspaces
Claudequery_database
Clauderead_file
Clauderemix_project
Clauderemove_mcp_server
Claudesend_message
Claudeset_folder_visibility
Claudeset_project_knowledge
Claudeset_project_visibility
Claudeset_workspace_knowledge
ClaudeCapabilities
WritesInteractive
Example Prompts
Click any prompt to copy it.
