List MCP exposures
By tool name; q searches tool names, titles and descriptions or finds a pasted mxp_…. Sorts by tool_name, created_at, updated_at, last_called_at and calls_total. Filters: kind (agent, workflow, action), enabled (true, false), alias, agent_id, workflow_id, connection_id. Only the kinds whose view permission the caller holds are listed.
Query parameters
workspace_idstringkindstring[]enabledstring[]aliasstring[]agent_idstringworkflow_idstringconnection_idstringcreated_bystring[]updated_bystring[]limitintegerRows 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
objectstringlistdataMcpExposure[]26 fields
idstringobjectstringmcp_exposureactionstring or nullagent_idstring or nullaliasstring or nullOne oflivestagingallow_writebooleanavailablebooleancalls_totalintegerconnection_idstring or nullcreated_atstring or nulldescriptionstringenabledbooleanerrors_totalintegerkindstringOne ofagentworkflowactionlast_called_atstring or nullrow_versionintegerside_effectsstring or nullOne ofreadwritedestructivetarget_namestring or nulltitlestring or nulltool_namestringunavailable_reasonstring or nullupdated_atstring or nullworkflow_idstring or nullworkspace_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_exposures?limit=20" \
-H "Authorization: Bearer $MDA_API_KEY"{
"object": "list",
"data": [
{
"id": "id",
"object": "mcp_exposure",
"action": "send_message",
"agent_id": "agt_01jctdbahw9btk5p831xs974yq",
"alias": "live",
"allow_write": true,
"available": true,
"calls_total": 2,
"connection_id": "con_01jc9ekd74h6eg79ggg89yx7py",
"created_at": "2026-11-10T09:30:00.000Z",
"created_by": {
"kind": "user",
"id": "usr_01jcf1j9wjxfrnhqda3mq7ejxn",
"name": "Ada Lovelace",
"email": "ada@example.com"
},
"description": "Reads new support email and drafts a reply.",
"enabled": true,
"errors_total": 2,
"kind": "agent",
"last_called_at": "2026-11-10T09:30:00.000Z",
"row_version": 4,
"side_effects": "read",
"target_name": "target name",
"title": "Support triage",
"tool_name": "search_docs",
"unavailable_reason": null,
"updated_at": "2026-11-10T09:30:00.000Z",
"updated_by": {
"kind": "user",
"id": "usr_01jcf1j9wjxfrnhqda3mq7ejxn",
"name": "Ada Lovelace",
"email": "ada@example.com"
},
"workflow_id": "wf_01jctgae7hqqg3qxjfrgs9t89k",
"workspace_id": "ws_01jccj30nr8ad7mx1yc5v9zx3h"
}
],
"has_more": false,
"next_cursor": null,
"total_count": 1
}