AI Discovery

List Discovered MCP Servers

Returns MCP servers discovered across your organization's devices by the Willow Scan Agent.

Results are grouped by identity hash (identical configurations seen on multiple devices are merged) and include a status of either shadow (running outside the gateway) or managed (proxied through your Willow gateway), plus any guard-check and AI-risk assessments.

get/api/discovery/mcp-servers

Request

  • Base URL: https://app.withwillow.ai
  • URL: https://app.withwillow.ai/api/discovery/mcp-servers
  • Auth: HTTP bearer

Query parameters

cursorinteger

Zero-based cursor offset for pagination.

limitinteger

Maximum number of MCP servers to return (1-200).

status'shadow' | 'managed'

Filter by governance status.

Response

List of discovered MCP servers retrieved successfully

Example response

{
  "data": [
    {
      "identityHash": "9f2c1a7e5b3d4c8e6a1f0b2d3e4f5a6b",
      "identifier": "@modelcontextprotocol/server-filesystem",
      "displayName": "Filesystem",
      "userCount": 3,
      "names": [
        "filesystem"
      ],
      "capabilityType": "mcp_server",
      "config": {
        "type": "stdio",
        "command": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-filesystem",
          "/Users"
        ],
        "url": "https://mcp.example.com/sse"
      },
      "sourceApplications": [
        "cursor",
        "claude-desktop"
      ],
      "sourceFilePaths": [
        "~/.cursor/mcp.json"
      ],
      "deviceCount": 5,
      "instanceCount": 8,
      "status": "shadow",
      "guardCheck": {
        "severity": "warning",
        "details": [
          "Server requests broad filesystem access"
        ],
        "checked_at": "2024-06-01T12:00:00Z"
      },
      "aiRisk": {
        "level": "high",
        "score": 78,
        "reasoning": "Grants write access to production systems without scoping",
        "calculated_at": "2024-06-01T12:00:00Z"
      }
    }
  ],
  "pagination": {
    "hasMore": true,
    "total": 128
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.