v0 MCP Server

The v0 MCP server lets MCP-compatible clients use v0 through the v0 API. Connect it to your IDE, desktop assistant, or agent runtime to create chats, list chats, inspect chat details, list and send messages, and get preview URLs from an MCP client.

The MCP server runs at:

https://v0.app/api/mcp

1. Connect your MCP client

Use the remote MCP URL directly if your client supports streamable HTTP MCP servers:

{
  "mcpServers": {
    "v0": {
      "url": "https://v0.app/api/mcp"
    }
  }
}

If your client requires a local stdio bridge, use mcp-remote:

{
  "mcpServers": {
    "v0": {
      "command": "npx",
      "args": ["mcp-remote", "https://v0.app/api/mcp"]
    }
  }
}

The first connection starts an OAuth flow. Sign in to v0, choose the account or team you want the client to use, and approve the connection.

The MCP server uses OAuth for MCP clients. Do not put a v0 API key in your MCP client configuration.

2. Use v0 tools

The v0 MCP server exposes tools backed by these v0 API endpoints:

Create chat: POST /v2/chats
List chats: GET /v2/chats
Get chat: GET /v2/chats/{chatId}
List messages: GET /v2/chats/{chatId}/messages
Send message: POST /v2/chats/{chatId}/messages
Get preview: GET /v2/chats/{chatId}/preview

Tools that return a chat (such as create chat and get chat) include a ready-to-open url for the chat, scoped to the account or team you connected, so you don't have to construct it yourself.

3. Try common workflows

Once connected, ask your MCP client to work with v0.

Create a chat

Create a v0 chat that builds a React dashboard with charts and filters.

List chats

List my v0 chats related to React dashboards.

Get chat details

Show me the details of v0 chat chat_abc123.

List messages in a chat

List the messages in v0 chat chat_abc123.

Continue an existing chat

Send a message to chat chat_abc123 asking v0 to add dark mode support.

Get a preview URL

Get the preview URL for chat chat_abc123.

4. Reconnect or change accounts

If the client loses access, reconnect the v0 MCP server from your MCP client. If you need to switch users or teams, remove the existing v0 MCP connection in the client and connect to https://v0.app/api/mcp again.

Troubleshooting

Connection failed

Verify the MCP server URL is https://v0.app/api/mcp.
Make sure your MCP client supports remote MCP servers or is configured through mcp-remote.

Authentication failed

Reconnect the v0 MCP server in your client.
If your team requires SSO, complete the re-authentication link returned by the tool response, then retry the request.

Tool is missing

Restart or reconnect your MCP client so it refreshes the server's tool list.
Check the v2 API reference for the resource you expect the MCP server to use.

On this page