{
  "markdown": "# Lovable MCP\n\nThe official [Model Context Protocol](https://modelcontextprotocol.io/) server for [Lovable](https://lovable.dev), an AI-powered full-stack app builder.\n\nConnect Claude, Cursor, Codex, and other MCP-compatible clients to Lovable so they can create, edit, deploy, and manage Lovable projects through natural language.\n\n\n## Endpoint\n\n```\nhttps://mcp.lovable.dev\n```\n\nTransport: [Streamable HTTP](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#streamable-http).\n\n## Authentication\n\n**OAuth 2.1.** MCP clients discover the authorization server via RFC 9728 metadata at `https://mcp.lovable.dev/.well-known/oauth-protected-resource` and obtain a bearer token automatically. The token is passed as `Authorization: Bearer <token>`.\n\n## Install\n\nClaude, Claude Code, and ChatGPT need only the URL. Any other client must also pass Lovable's public OAuth client ID (`6d465f583e1e4ce5801b1616f735670c`), shown below.\n\n### Claude Code\n\n```sh\nclaude mcp add --transport http lovable https://mcp.lovable.dev\n```\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"lovable\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.lovable.dev\"\n    }\n  }\n}\n```\n\n### ChatGPT\n\nAdd the URL directly — no client ID needed:\n\n```\nhttps://mcp.lovable.dev\n```\n\n### Cursor / Windsurf\n\nAdd to your client's MCP config (`~/.cursor/mcp.json`, or Windsurf's `mcp_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"lovable\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.lovable.dev\",\n      \"auth\": {\n        \"CLIENT_ID\": \"6d465f583e1e4ce5801b1616f735670c\"\n      }\n    }\n  }\n}\n```\n\n### VS Code\n\n```json\n{\n  \"servers\": {\n    \"lovable\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.lovable.dev\",\n      \"auth\": {\n        \"CLIENT_ID\": \"6d465f583e1e4ce5801b1616f735670c\"\n      }\n    }\n  }\n}\n```\n\n### Codex CLI\n\n```sh\ncodex mcp add lovable --url https://mcp.lovable.dev\ncodex mcp login lovable\n```\n\n### Other clients\n\nUse the same `type: http` + `url` + `auth.CLIENT_ID` shape as the Cursor example above.\n\n## Tools\n\nThe server exposes tools across these areas:\n\n- **Projects & workspaces** — list, create, deploy, remix, inspect; manage visibility\n- **Agent interaction** — send messages to a project's AI agent and retrieve responses\n- **Code inspection** — diffs, file tree, file contents, edit history\n- **Knowledge** — read and write project / workspace AI instructions\n- **Cloud database** — enable a Postgres database, check status, run SQL, get connection info\n- **Connectors & MCP servers** — list, add, and remove external integrations (Linear, Notion, Slack, custom MCP, …)\n- **Templates & libraries** — browse template and library projects\n- **Analytics** — historical and real-time project traffic\n- **File uploads** — generate upload URLs for attaching images\n\n> **Heads up:** `create_project` and `send_message` consume Lovable build credits. `deploy_project` publishes a public URL. `query_database` runs SQL directly against your project's database.\n\nSee the [Lovable MCP documentation](https://docs.lovable.dev/integrations/lovable-mcp-server#lovable-mcp-server-research-preview) for the full tool reference.\n\n## Common workflow\n\nBuild and deploy a new app:\n\n```\n1. list_workspaces()                       → workspace_id\n2. create_project(workspace_id, ...)       → project_id   (uses credits)\n3. send_message(project_id, \"Add ...\")     → message_id   (uses credits)\n4. get_diff(project_id, message_id)        → review changes\n5. deploy_project(project_id)              → live URL\n```\n\nMost tools need a `workspace_id` — call `list_workspaces` first. `read_file` needs a git ref; get `latest_commit_sha` from `get_project`.\n\n## Troubleshooting\n\n| Symptom | Fix |\n|---|---|\n| `401 Unauthorized` / expired token | Re-run your client's login flow to refresh the OAuth token |\n| OAuth window loops or never completes | Confirm the client passes the `auth.CLIENT_ID` shown above |\n| \"Transport not supported\" | The client must support Streamable HTTP |\n| Tool fails on a missing `workspace_id` | Call `list_workspaces` first and pass the returned ID |\n\n## Registry\n\nThis repository hosts the [`server.json`](./server.json) entry for the [MCP registry](https://registry.modelcontextprotocol.io/).\n\n## License\n\n[Apache License 2.0](./LICENSE)\n",
  "bytes": 4301,
  "sha": "c9038ff9ae8f5384cb56840d9c1646064935da7962249273ffa3eb8d043ce4d9",
  "repo_slug": "lovablelabs/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_lovablelabs_mcp_lovable_8647b1e4/readme"
}