Skip to main content

List custom MCP servers

POST 
/api/v1/mcp-servers/list

Returns the project's matching custom servers without pagination. Use the secret name filter to inspect dependencies before rotating or deleting a credential.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Answer questions about a website using your own Firecrawl account

Request​

Responses​

The project's servers

List enabled custom MCP servers in the authenticated project.​

Section ID: DOC-IN-tools-connections-servers-api-listCustomMcpServers#example-mcp-servers-listCustomMcpServers-request

Request example

{}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.​

Section ID: DOC-IN-tools-connections-servers-api-listCustomMcpServers#example-mcp-servers-listCustomMcpServers-response

Response example

{
  "servers": [
    {
      "serverId": "example-id",
      "displayName": "example",
      "description": "example",
      "endpoint": "https://example.com/callback",
      "authType": "CUSTOM_MCP_SERVER_AUTH_TYPE_NONE",
      "enabled": true,
      "requestTimeout": "1s",
      "version": "1",
      "createdBy": "example",
      "createdAt": "2026-09-16T12:00:00Z",
      "updatedAt": "2026-09-16T12:00:00Z"
    }
  ],
  "total": 1
}

Document ID: DOC-IN-tools-connections-servers-api-listCustomMcpServers. Section identities and revisions.

SectionStable reference
List custom MCP serversDOC-IN-tools-connections-servers-api-listCustomMcpServers#overview
RequestDOC-IN-tools-connections-servers-api-listCustomMcpServers#request
ResponsesDOC-IN-tools-connections-servers-api-listCustomMcpServers#responses