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.
create_project
ChatGPTInternal tool - DO NOT call directly. Use initiate_project instead. Called automatically by the widget when user selects a workspace.
create_variant
ChatGPTCreate an independent project variant from the current main branch, or from base_sha when provided. Requires project variants to be enabled for the API key owner or workspace. Create two variants, then call send_message with each variant_id to run alternative implementations in parallel.
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.
disable_project_skill
ChatGPTDisable a project skill without removing it from the project repo, so the Lovable agent stops using it for this project's agent runs.
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.
enable_project_skill
ChatGPTEnable a project skill so the Lovable agent uses it for this project's agent runs.
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 workspaces
get_message
ChatGPTGet the status and content of a message. Pass the message_id and thread_id returned by send_message for thread-aware status. Check the response status field: 'in_progress' means the agent is still working, 'completed' means done.
get_project
ChatGPTCheck build status and get URL/screenshot. Returns status: "building", "ready", or "failed".
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: plan, credit balance, member count, and settings. Use to check available credits before starting work.
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
ChatGPTBuilds a web application. Can include backend, database, and authentication when needed. Input: Only "prompt" is required. Do not pass workspace_id - workspace selection is handled automatically via the widget. After calling: Follow the "Next step" in the response. Do not write code. To edit afterwards, users must go to Lovable's web interface.
list_available_connectors
ChatGPTBrowse available connector templates. Returns connector IDs that can be passed to add_connector.
list_connections
ChatGPTList authenticated connections (accounts) for connectors in a workspace. Shows which specific accounts are connected — for example, which Google Drive account or Stripe account is linked. Use list_connectors to see available connector types, then list_connections to see which ones have active connections. Optionally filter by connector_id.
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. Use remove_connector to remove.
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 pagination via the before parameter (use created_at from the last edit).
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_project_skills
ChatGPTList skills present in the project repo, including whether each skill is currently enabled for agent runs in this project. Use this before enabling or disabling a project skill.
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.
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.
open_project_for_editing
ChatGPTGet a link for the user to edit their website in Lovable. Use when user wants to modify, edit, or add features to an existing website. Websites can only be edited in Lovable's web interface, not here.
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.
remove_connector
ChatGPTRemove a connector from a workspace.
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.
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 a project's visibility. 'private' makes it editable by workspace members. 'workspace_view' makes it visible (read-only) to workspace members (requires Business plan or higher). 'public' makes it visible to anyone (not available on enterprise plans). 'draft' makes it visible only to the creator (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
Claude