---
title: Find MCP Servers
description: Retrieves a list of MCP servers configured for your account. Returns all servers with their connection details, authentication type, and enabled status.
product: Platform API
type: reference
prerequisites:
  - /docs/api/platform/quickstart
---

# Find MCP Servers



<EndpointDisplay method="get" path="/mcp-servers" />

## Usage [#usage]

<CustomCodeBlock languages="['TypeScript', 'cURL']" defaultLanguage="TypeScript">
  <CodeVariant
    language="TypeScript"
    title="TypeScript Example"
    code="`import { v0 } from 'v0-sdk'

const result = await v0.mcpServers.find()

console.log(result)`"
  />

  <CodeVariant
    language="cURL"
    title="cURL Example"
    code="`curl -X GET https://api.v0.dev/v1/mcp-servers \
  -H &#x22;Authorization: Bearer $V0_API_KEY&#x22; \
  -H &#x22;Content-Type: application/json&#x22;`"
  />
</CustomCodeBlock>

### Response [#response]

<APISignature
  parameters="[
  {
    &#x22;name&#x22;: &#x22;object&#x22;,
    &#x22;type&#x22;: &#x22;'list'&#x22;,
    &#x22;required&#x22;: true,
    &#x22;description&#x22;: &#x22;&#x22;,
    &#x22;deprecated&#x22;: false
  },
  {
    &#x22;name&#x22;: &#x22;data&#x22;,
    &#x22;type&#x22;: &#x22;object[]&#x22;,
    &#x22;required&#x22;: true,
    &#x22;description&#x22;: &#x22;&#x22;,
    &#x22;deprecated&#x22;: false,
    &#x22;arrayItems&#x22;: {
      &#x22;name&#x22;: &#x22;item&#x22;,
      &#x22;type&#x22;: &#x22;object&#x22;,
      &#x22;required&#x22;: true,
      &#x22;description&#x22;: &#x22;&#x22;,
      &#x22;deprecated&#x22;: false,
      &#x22;properties&#x22;: [
        {
          &#x22;name&#x22;: &#x22;id&#x22;,
          &#x22;type&#x22;: &#x22;string&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;A unique identifier for the MCP server.&#x22;,
          &#x22;deprecated&#x22;: false
        },
        {
          &#x22;name&#x22;: &#x22;object&#x22;,
          &#x22;type&#x22;: &#x22;'mcp_server'&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;Fixed value identifying this object as an MCP server.&#x22;,
          &#x22;deprecated&#x22;: false
        },
        {
          &#x22;name&#x22;: &#x22;name&#x22;,
          &#x22;type&#x22;: &#x22;string&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;A human-readable name for the MCP server.&#x22;,
          &#x22;deprecated&#x22;: false
        },
        {
          &#x22;name&#x22;: &#x22;url&#x22;,
          &#x22;type&#x22;: &#x22;string&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;The URL of the MCP server endpoint.&#x22;,
          &#x22;deprecated&#x22;: false
        },
        {
          &#x22;name&#x22;: &#x22;description&#x22;,
          &#x22;type&#x22;: &#x22;string&#x22;,
          &#x22;required&#x22;: false,
          &#x22;description&#x22;: &#x22;An optional description of the MCP server.&#x22;,
          &#x22;deprecated&#x22;: false
        },
        {
          &#x22;name&#x22;: &#x22;enabled&#x22;,
          &#x22;type&#x22;: &#x22;boolean&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;Whether the MCP server is currently enabled.&#x22;,
          &#x22;deprecated&#x22;: false
        },
        {
          &#x22;name&#x22;: &#x22;auth&#x22;,
          &#x22;type&#x22;: &#x22;object&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;The authentication configuration. Only the type is returned; sensitive values are redacted.&#x22;,
          &#x22;deprecated&#x22;: false,
          &#x22;properties&#x22;: [
            {
              &#x22;name&#x22;: &#x22;type&#x22;,
              &#x22;type&#x22;: &#x22;'none' | 'bearer' | 'custom-headers' | 'oauth'&#x22;,
              &#x22;required&#x22;: true,
              &#x22;description&#x22;: &#x22;The authentication method used by the server.&#x22;,
              &#x22;deprecated&#x22;: false
            }
          ]
        },
        {
          &#x22;name&#x22;: &#x22;scope&#x22;,
          &#x22;type&#x22;: &#x22;'user' | 'team'&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;Whether the server is scoped to the user or a team.&#x22;,
          &#x22;deprecated&#x22;: false
        },
        {
          &#x22;name&#x22;: &#x22;createdAt&#x22;,
          &#x22;type&#x22;: &#x22;string&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;The ISO 8601 timestamp when the server was created.&#x22;,
          &#x22;deprecated&#x22;: false
        },
        {
          &#x22;name&#x22;: &#x22;updatedAt&#x22;,
          &#x22;type&#x22;: &#x22;string&#x22;,
          &#x22;required&#x22;: false,
          &#x22;description&#x22;: &#x22;The ISO 8601 timestamp when the server was last updated.&#x22;,
          &#x22;deprecated&#x22;: false
        }
      ]
    }
  }
]"
/>