Focus
Focus mode: everything a network's API allows for one connected account. The manifest lists the resources (with JSON schemas for tables and forms); the generic operations run them. Typed per-network aliases live under the "Focus ·
- GET/focus/platforms
- GET/accounts/{accountId}/focus
- GET/accounts/{accountId}/focus/{resource}
- POST/accounts/{accountId}/focus/{resource}
- PATCH/accounts/{accountId}/focus/{resource}
- DEL/accounts/{accountId}/focus/{resource}
- GET/accounts/{accountId}/focus/{resource}/{itemId}
- PATCH/accounts/{accountId}/focus/{resource}/{itemId}
- DEL/accounts/{accountId}/focus/{resource}/{itemId}
- POST/accounts/{accountId}/focus/{resource}/{itemId}/{action}
List networks with Focus mode
/focus/platformsNetworks that publish a focus module, with their navigation groups, resource / action counts and MCP toolset.
Try it with MCPAsk your agent to call list-focus-platforms (toolset focus)Set up MCP
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 8 item attributes
objectstringfocus_platform
platformstringlabelstringgroupsarray of objectShow 3 item attributes
keystringlabelstringiconstring | nullresource_countintegeraction_countintegeroperation_countintegertoolsetstringpageintegerrequiredlimitintegerrequiredtotalinteger | nullhas_morebooleanrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
{
"object": "list",
"data": [
{
"object": "focus_platform",
"platform": "string",
"label": "string",
"groups": [
{
"key": "string",
"label": "string",
"icon": "string"
}
],
"resource_count": 1,
"action_count": 1,
"operation_count": 1,
"toolset": "string"
}
],
"page": 1,
"limit": 1,
"total": 1,
"has_more": true,
"next_page_url": "https://example.com",
"previous_page_url": "https://example.com"
}Get the Focus manifest of an account
/accounts/{accountId}/focusResources of the account's network with their JSON schemas, operations and actions. Availability is computed from the account's granted scopes; missing_scopes and reconnect_url (connect with scope_set=focus) tell how to unlock the rest.
Try it with MCPAsk your agent to call get-focus-manifest (toolset focus)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringfocus_manifest
platformstringlabelstringaccountobjectShow 10 child attributes
objectstringaccount
idstringplatformstringaccount_typestringusernamestring | nulldisplay_namestring | nullavatar_urlstring | nullstatusstringactiveneeds_reconnect
profile_idstring | nullscopesarray of stringgroupsarray of objectShow 3 item attributes
keystringlabelstringiconstring | nullresourcesarray of objectShow 17 item attributes
keystringlabelstringdescriptionstring | nulliconstring | nullgroupstringviewstringsingletonbooleanid_fieldstringtitle_fieldstring | nullcolumnsarray of string | nullfieldsobjectoperationsobjectShow 5 child attributes
listobjectShow 4 child attributes
availablebooleanqueryobject | nullbodyobject | nullsummarystring | nullgetobjectShow 4 child attributes
availablebooleanqueryobject | nullbodyobject | nullsummarystring | nullcreateobjectShow 4 child attributes
availablebooleanqueryobject | nullbodyobject | nullsummarystring | nullupdateobjectShow 4 child attributes
availablebooleanqueryobject | nullbodyobject | nullsummarystring | nulldeleteobjectShow 4 child attributes
availablebooleanqueryobject | nullbodyobject | nullsummarystring | nullactionsarray of objectShow 7 item attributes
namestringlabelstringtargetstringitemcollection
destructivebooleanbodyobject | nullsummarystring | nullavailablebooleanavailablebooleanmissing_scopesarray of stringdocsstring | nulltyped_pathstring | nullmissing_scopesarray of stringneeds_reconnectbooleanreconnect_urlstring | nullResponses
{
"object": "focus_manifest",
"platform": "string",
"label": "string",
"account": {
"object": "account",
"id": "string",
"platform": "string",
"account_type": "string",
"username": "string",
"display_name": "string",
"avatar_url": "https://example.com",
"status": "active",
"profile_id": "string",
"scopes": [
"string"
]
},
"groups": [
{
"key": "string",
"label": "string",
"icon": "string"
}
],
"resources": [
{
"key": "string",
"label": "string",
"description": "string",
"icon": "string",
"group": "string",
"view": "string",
"singleton": true,
"id_field": "string",
"title_field": "string",
"columns": [
"string"
],
"fields": {},
"operations": {
"list": {
"available": true,
"query": {},
"body": {},
"summary": "string"
},
"get": {
"available": true,
"query": {},
"body": {},
"summary": "string"
},
"create": {
"available": true,
"query": {},
"body": {},
"summary": "string"
},
"update": {
"available": true,
"query": {},
"body": {},
"summary": "string"
},
"delete": {
"available": true,
"query": {},
"body": {},
"summary": "string"
}
},
"actions": [
{
"name": "string",
"label": "string",
"target": "item",
"destructive": true,
"body": {},
"summary": "string"
}
],
"available": true,
"missing_scopes": [
"string"
],
"docs": "string",
"typed_path": "string"
}
],
"missing_scopes": [
"string"
],
"needs_reconnect": true,
"reconnect_url": "https://example.com"
}List focus items (or get a singleton resource)
/accounts/{accountId}/focus/{resource}Lists items of a resource with cursor pagination (cursor = previous next_cursor). Other query parameters are validated against the resource's operations.list.query schema and passed to the network. For singleton resources (singleton: true in the manifest) returns the object.
Try it with MCPAsk your agent to call list-focus-items (toolset focus)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
resourcestringrequiredFocus resource key from the manifest (e.g. videos)
1–80 characters · pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$
Query parameters
cursorstringOpaque cursor from next_cursor
limitintegerPage size (the network may cap it lower)
1–500
Returns object
One of 2 shapes
object: "list" object
objectstringrequiredlist
dataarray of objectrequiredlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullOption 2 object
Responses
{
"object": "list",
"data": [
{}
],
"limit": 1,
"total": 1,
"has_more": true,
"next_cursor": "string",
"next_page_url": "https://example.com",
"previous_page_url": "https://example.com"
}Create a focus item
/accounts/{accountId}/focus/{resource}Body validated against the resource's operations.create.body schema.
Try it with MCPAsk your agent to call create-focus-item (toolset focus)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
resourcestringrequiredFocus resource key from the manifest (e.g. videos)
1–80 characters · pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Responses
{}Update a singleton focus resource
/accounts/{accountId}/focus/{resource}For resources with singleton: true (channel settings, chat info, …). Body validated against operations.update.body.
Try it with MCPAsk your agent to call update-focus-singleton (toolset focus)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
resourcestringrequiredFocus resource key from the manifest (e.g. videos)
1–80 characters · pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$
Responses
{}Delete or reset a singleton focus resource
/accounts/{accountId}/focus/{resource}Try it with MCPAsk your agent to call delete-focus-singleton (toolset focus)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
resourcestringrequiredFocus resource key from the manifest (e.g. videos)
1–80 characters · pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
{
"object": "focus_item",
"platform": "string",
"resource": "string",
"id": "string",
"deleted": true,
"result": null
}Get a focus item
/accounts/{accountId}/focus/{resource}/{itemId}Query parameters are passed to the network (validated against operations.get.query when present).
Try it with MCPAsk your agent to call get-focus-item (toolset focus)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
resourcestringrequiredFocus resource key from the manifest (e.g. videos)
1–80 characters · pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$
itemIdstringrequiredThe network's id of the item
1–512 characters
Query parameters
typeanyadditionalPropertiesanyResponses
{}Update a focus item
/accounts/{accountId}/focus/{resource}/{itemId}Body validated against operations.update.body.
Try it with MCPAsk your agent to call update-focus-item (toolset focus)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
resourcestringrequiredFocus resource key from the manifest (e.g. videos)
1–80 characters · pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$
itemIdstringrequiredThe network's id of the item
1–512 characters
Responses
{}Delete a focus item
/accounts/{accountId}/focus/{resource}/{itemId}Try it with MCPAsk your agent to call delete-focus-item (toolset focus)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
resourcestringrequiredFocus resource key from the manifest (e.g. videos)
1–80 characters · pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
{
"object": "focus_item",
"platform": "string",
"resource": "string",
"id": "string",
"deleted": true,
"result": null
}Run a focus action
/accounts/{accountId}/focus/{resource}/{itemId}/{action}Item actions (target: "item") take the item id; collection actions (target: "collection") and actions of singleton resources use - as itemId (…/focus/{resource}/-/{action}). Body validated against the action's body schema.
Try it with MCPAsk your agent to call run-focus-action (toolset focus)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
resourcestringrequiredFocus resource key from the manifest (e.g. videos)
1–80 characters · pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$
itemIdstringrequiredThe network's id of the item
1–512 characters
actionstringrequiredAction name from the manifest (e.g. transition)
1–80 characters · pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
{
"object": "focus_action_result",
"platform": "string",
"resource": "string",
"action": "string",
"id": "string",
"result": null
}