Skip to content
OpenCode
Esc
navigateopen⌘Jpreview

List MCP servers

Retrieve configured MCP servers and their connection status.

GET/api/mcp
Query parameters
locationobject | any
Responses
200Success
locationLocation.Inforequired
Show properties
directorystringrequired
workspaceIDobject
Show properties
object
projectobjectrequired
Show properties
idstringrequired
directorystringrequired
dataMcp.Server[]required
Show properties
Array of Mcp.Server
namestringrequired
statusMcp.Status.Connected | Mcp.Status.Pending | Mcp.Status.Disabled | Mcp.Status.Failed | Mcp.Status.NeedsAuth | Mcp.Status.NeedsClientRegistrationrequired
Show properties
Any of:
Mcp.Status.Connected
statusstringrequired
Allowed:connected
Mcp.Status.Pending
statusstringrequired
Allowed:pending
Mcp.Status.Disabled
statusstringrequired
Allowed:disabled
Mcp.Status.Failed
statusstringrequired
Allowed:failed
errorstringrequired
Mcp.Status.NeedsAuth
statusstringrequired
Allowed:needs_auth
Mcp.Status.NeedsClientRegistration
statusstringrequired
Allowed:needs_client_registration
errorstringrequired
integrationIDstring
400InvalidRequestError
_tagstringrequired
Allowed:InvalidRequestError
messagestringrequired
kindstring | any
Show properties
Any of:
string
string
any
any
fieldstring | any
Show properties
Any of:
string
string
any
any
401UnauthorizedError
_tagstringrequired
Allowed:UnauthorizedError
messagestringrequired
Request
curl -X GET "/api/mcp"
Response
{
  "location": {
    "directory": "string",
    "workspaceID": {},
    "project": {
      "id": "string",
      "directory": "string"
    }
  },
  "data": [
    {
      "name": "string",
      "status": {
        "status": "connected"
      },
      "integrationID": "string"
    }
  ]
}