ReferenceAdmin
Every team's MCP servers (platform admins and auditors)
GET
/v1/admin/mcp-serversQuery Parameters
q?string
Case-insensitive substring match
Length
length <= 200publishState?string
Value in
- "private"
- "pending"
- "published"
- "rejected"
changes?boolean
With true, only published servers with capabilities waiting for approval
team?string
Team slug or ID
provider?string
Auth provider ID; only servers that require it (as their requirement or in a capability override) or, for a platform provider, servers in oauth mode that link it
Format
uuidauthMode?string
Only servers with this upstream auth mode
Value in
- "none"
- "static_header"
- "oauth"
cursor?string
nextCursor from the previous page
limit?integer
Range
1 <= value <= 200Default
50Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/admin/mcp-servers"{ "data": { "items": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec", "teamSlug": "string", "teamName": "string", "slug": "service-status", "name": "Service status", "description": "string", "url": "https://status.example.com/mcp", "transport": "streamable_http", "authHeaderName": "string", "hasAuth": true, "authValueHint": "string", "timeoutSeconds": 1, "enabled": true, "publishState": "private", "effectivePublishPolicy": "approval_required", "publishRequestedAt": "2019-08-24T14:15:22Z", "publishRequestNote": "string", "publishReviewedAt": "2019-08-24T14:15:22Z", "publishReviewedByName": "string", "publishReviewNote": "string", "counts": { "tools": 0, "resources": 0, "resourceTemplates": 0, "prompts": 0 }, "pendingChanges": 0, "health": { "status": "healthy", "checkedAt": "2019-08-24T14:15:22Z", "statusSince": "2019-08-24T14:15:22Z", "latencyMs": 0, "errorClass": "unavailable", "message": "string", "signInRequired": true }, "refreshedAt": "2019-08-24T14:15:22Z", "lastRefreshError": "string", "requirement": { "providerId": "4834bcdc-4a64-444d-966b-1a6fe381da24", "providerSlug": "string", "providerName": "string", "providerEnabled": true, "scopes": [ "string" ] }, "capturePayloads": true, "authMode": "none", "oauth": { "providerId": "4834bcdc-4a64-444d-966b-1a6fe381da24", "providerSlug": "string", "resource": "https://api.githubcopilot.com/mcp/", "resourceMetadataUrl": "https://api.githubcopilot.com/.well-known/oauth-protected-resource/mcp/", "authorizationServer": "https://github.com/login/oauth", "issuer": "https://github.com/login/oauth", "authorizationEndpoint": "https://github.com/login/oauth/authorize", "tokenEndpoint": "https://github.com/login/oauth/access_token", "revocationEndpoint": "string", "scopes": [ "string" ], "scopesSupported": [ "string" ], "registration": "dcr", "clientIdHint": "string", "hasClientSecret": true, "clientSecretExpiresAt": "2019-08-24T14:15:22Z", "tokenAuthMethod": "client_secret_basic", "sendResource": true, "issParameterSupported": true, "platformProvider": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "slug": "string", "name": "string", "preset": "github", "logoUrl": "string", "kind": "oauth2", "server": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "slug": "string", "name": "string", "teamSlug": "string" } }, "setupConnection": { "status": "active", "personId": "f3e5ff26-28ff-4cd6-9b1b-e303a185a13a", "personName": "string", "authorizedAt": "2019-08-24T14:15:22Z" }, "connectionCount": 0, "discoveredAt": "2019-08-24T14:15:22Z", "redirectUri": "https://mcp.example.com/connect/callback" }, "sendIdentity": true, "revision": 0, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" } ], "nextCursor": "string" }}