List MCP servers
Newest first. Sorts by created_at, updated_at, last_used_at and name; q searches names, addresses and descriptions, or finds a pasted mcp_… ID. Filters, each repeatable: health as people see it (healthy, unhealthy, revoked, pending, sign_in_pending, paused), auth_type, status, review (waiting: tools wait for a person; clear), created_by, updated_by. Rows carry no tools (null) unless with_tools=true, which the agent and workflow editors ask for to offer each server's approved tools.
Query parameters
workspace_idstringhealthstring[]auth_typestring[]statusstring[]reviewstring[]created_bystring[]updated_bystring[]with_toolsbooleanDefaultfalselimitintegerRows per page, 1 to 200.
Default50at least 1at most 200cursorstringqstringSearch: rows whose name (or the list's other searchable text) contains this, any case.
at most 200 charactersorderstringSort field; a leading
-sorts down. Each list names the fields it sorts by.at most 64 charactersmatches ^-?[a-z_]+$includestring[]total_count(counted up to 10,000) andfacets(a count per filter value).One oftotal_countfacetscreated_afterstringOnly rows created at or after this time (RFC 3339).
date-timecreated_beforestringOnly rows created at or before this time (RFC 3339).
date-timeupdated_afterstringOnly rows last changed at or after this time (RFC 3339).
date-timeupdated_beforestringOnly rows last changed at or before this time (RFC 3339).
date-time
Response200
objectstringlistdataMcpServer[]38 fields
idstringobjectstringmcp_serverauth_typestringOne ofnonebearerheadersoauth2auto_approvestringOne ofnoneread_onlyallbaaMcpBaa or null2 fields
attested_atstring or nullreferencestring or null
call_timeout_sintegercatalog_idstring or nullcreated_atstring or nulldata_classstringOne ofpublicinternalpiisensitivephidescriptionstring or nulldiscovery_errorstring or nullheader_namesstring[]healthstringOne ofhealthydegradedunhealthyrevokeddisabledhealth_changed_atstring or nullhealth_reasonstring or nullhoststringlast_discovered_atstring or nulllogoMcpLogo or nullupload,mark(from the console's library) orserver(its own icon).urlserves the image (uploadandserver).3 fields
markstring or nullsourcestring or nullOne ofuploadmarkserverurlstring or null
logo_removedbooleanmax_output_bytesintegernamestringoauthMcpOAuthInfo or null5 fields
clientstring or nullOne ofdynamicownclient_idstring or nullissuerstring or nullresourcestring or nullscopesstring[]
row_versionintegerserver_infoMcpServerInfo9 fields
capabilitiesstring[]instructionsstring or nullnamestring or nullpromptsobject[]protocol_versionstring or nullresourcesobject[]titlestring or nullversionstring or nullwebsite_urlstring or null
share_instructionsbooleansigned_in_untilstring or nullstatusstringOne ofpendingactivedisabledtool_countsMcpToolCounts6 fields
approvedintegerblockedintegerchangedintegerpendingintegerremovedintegertotalinteger
toolsMcpTool[] or null20 fields
annotationsobject or nullAny JSON object.
approvalstringOne ofneveralwayspolicyapproved_atstring or nullapproved_bystring or nullauto_approvedbooleanchanged_atstring or nulldescriptionstring or nullfirst_seen_atstring or nullhashstringinput_schemaobjectAny JSON object.
keystringliveMcpToolLive or nullThe definition the server offers now, for a tool that changed since approval.
6 fields
annotationsobject or nullAny JSON object.
descriptionstring or nullhashstring or nullinput_schemaobjectAny JSON object.
output_schemaobject or nullAny JSON object.
titlestring or null
namestringoutput_schemaobject or nullAny JSON object.
removed_atstring or nullside_effectsstringOne ofreadwritedestructiveside_effects_sourcestring or nullOne ofserverdefaultpersonstatsMcpToolStats or null5 fields
avg_msinteger or nullcallsintegererrorsintegerlast_atstring or nulllast_errorstring or null
statusstringOne ofpendingapprovedblockedchangedremovedtitlestring or null
tools_truncatedbooleantransportstringOne ofautostreamable_httpssetransport_detectedstring or nullOne ofstreamable_httpsseupdated_atstring or nullurlstringusageMcpUsage3 fields
callsintegererrorsintegerlast_used_atstring or null
workspace_idstringcreated_byActorRef or nullWho created or last changed something, resolved to a name for display.
system,workload(an automation) andend_user(a widget visitor) have no ID or name: the console words them.nameis null for someone the directory no longer knows.idis what the lists'created_by/updated_byfilters take.avatar_versionis set for a person with a photo: it is atGET /v1/members/{id}/avatar?v=<avatar_version>while they are a member.5 fields
idstring or nullkindstringOne ofuserapi_keyservice_accountworkloadend_usersystemnamestring or nullavatar_versionstring or nullemailstring or null
updated_byActorRef or nullWho created or last changed something, resolved to a name for display.
system,workload(an automation) andend_user(a widget visitor) have no ID or name: the console words them.nameis null for someone the directory no longer knows.idis what the lists'created_by/updated_byfilters take.avatar_versionis set for a person with a photo: it is atGET /v1/members/{id}/avatar?v=<avatar_version>while they are a member.5 fields
idstring or nullkindstringOne ofuserapi_keyservice_accountworkloadend_usersystemnamestring or nullavatar_versionstring or nullemailstring or null
has_morebooleannext_cursorstring or nullfacetsmap<string, map<string, integer>> or nullpeoplemap<string, ActorRef> or null5 fields
idstring or nullkindstringOne ofuserapi_keyservice_accountworkloadend_usersystemnamestring or nullavatar_versionstring or nullemailstring or null
total_countinteger or nulltotal_count_exactboolean or null
Status codes
- 200Successful Response
- 422The request is not valid:
errors[]names each field. - 4XXThe request was refused: the problem says why.
- 5XXThe API could not answer: the problem says why.
curl "https://api.mydeepagents.com/v1/mcp_servers?limit=20" \
-H "Authorization: Bearer $MDA_API_KEY"{
"object": "list",
"data": [
{
"id": "mcp_01jc832gmyrb97hnzx3h75bsfd",
"object": "mcp_server",
"auth_type": "none",
"auto_approve": "none",
"baa": {
"attested_at": "2026-11-10T09:30:00.000Z",
"reference": "reference"
},
"call_timeout_s": 60,
"catalog_id": "linear",
"created_at": "2026-11-10T09:30:00.000Z",
"created_by": {
"kind": "user",
"id": "usr_01jcf1j9wjxfrnhqda3mq7ejxn",
"name": "Ada Lovelace",
"email": "ada@example.com"
},
"data_class": "public",
"description": "Reads new support email and drafts a reply.",
"discovery_error": null,
"header_names": [
"X-Api-Key"
],
"health": "healthy",
"health_changed_at": "2026-11-10T09:30:00.000Z",
"health_reason": null,
"host": "mcp.example.com",
"last_discovered_at": "2026-11-10T09:30:00.000Z",
"logo": {
"mark": "mark",
"source": "upload",
"url": "https://mcp.example.com/mcp"
},
"logo_removed": true,
"max_output_bytes": 1048576,
"name": "Support triage",
"oauth": {
"client": "dynamic",
"client_id": "client id",
"issuer": "issuer",
"resource": "resource",
"scopes": [
"agent.view",
"agent.run",
"run.view"
]
},
"row_version": 4,
"server_info": {
"capabilities": [
"tools"
],
"instructions": "instructions",
"name": "Support triage",
"prompts": [
{}
],
"protocol_version": "2025-11-25",
"resources": [
{}
],
"title": "Support triage",
"version": "version",
"website_url": "https://example.com"
},
"share_instructions": true,
"signed_in_until": "2026-11-10T09:30:00.000Z",
"status": "pending",
"tool_counts": {
"approved": 2,
"blocked": 2,
"changed": 2,
"pending": 2,
"removed": 2,
"total": 2
},
"tools": [
{
"annotations": {},
"approval": "never",
"approved_at": "2026-11-10T09:30:00.000Z",
"approved_by": "usr_01jcf1j9wjxfrnhqda3mq7ejxn",
"auto_approved": true,
"changed_at": "2026-11-10T09:30:00.000Z",
"description": "Reads new support email and drafts a reply.",
"first_seen_at": "2026-11-10T09:30:00.000Z",
"hash": "hash",
"input_schema": {},
"key": "key",
"live": {},
"name": "Support triage",
"output_schema": {},
"removed_at": "2026-11-10T09:30:00.000Z",
"side_effects": "read",
"side_effects_source": "server",
"stats": {},
"status": "pending",
"title": "Support triage"
}
],
"tools_truncated": true,
"transport": "auto",
"transport_detected": "streamable_http",
"updated_at": "2026-11-10T09:30:00.000Z",
"updated_by": {
"kind": "user",
"id": "usr_01jcf1j9wjxfrnhqda3mq7ejxn",
"name": "Ada Lovelace",
"email": "ada@example.com"
},
"url": "https://mcp.example.com/mcp",
"usage": {
"calls": 2,
"errors": 2,
"last_used_at": "2026-11-10T09:30:00.000Z"
},
"workspace_id": "ws_01jccj30nr8ad7mx1yc5v9zx3h"
}
],
"has_more": false,
"next_cursor": null,
"total_count": 1
}