Skip to main content
GET
/
organization
/
mcp-servers
Python
import os
from datagrid_ai import Datagrid

client = Datagrid(
    api_key=os.environ.get("DATAGRID_API_KEY"),  # This is the default and can be omitted
)
list_mcp_servers_response = client.organization.mcp_servers.list()
print(list_mcp_servers_response.data)
{
  "object": "list",
  "data": [
    {
      "object": "mcp_server",
      "id": "<string>",
      "name": "<string>",
      "icon_url": "<string>",
      "base_url": "<string>",
      "transport": "<string>",
      "protocol_version": "<string>",
      "authorization_secret_id": "<string>",
      "status": "<string>",
      "metadata": {
        "requires_oauth": true,
        "oauth_configured": true,
        "tool_count": 123,
        "last_synced_at": "<string>"
      },
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ]
}
Lists MCP servers registered in the current teamspace. Use this to:
  • find an existing server_id by name
  • verify registration before agent attachment

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

List of MCP servers

object
enum<string>
required
Available options:
list
data
object[]
required