HomeDocsMCPlist_instagram_media
MCP tool · Instagram engagement

list_instagram_media

List an Instagram account's recent posts (caption, permalink, timestamp, comment count) so you can find one to read or moderate comments on. account is the connected-account id or handle.

Calling it

Invoke this tool with a JSON-RPC 2.0 tools/call request against the hosted MCP endpoint at POST https://getsocialclaw.com/mcp. Send your workspace API key as Authorization: Bearer sc_live_your_key. In an MCP client (Claude, Cursor, Claude Code) the client makes this call for you — just ask it to use list_instagram_media.

Arguments

ParameterTypeDescription
account string required Instagram connected-account id or handle.
limit number optional Max media to return (default 25, capped at 100).
after string optional Pagination cursor from a previous response.

Example request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_instagram_media",
    "arguments": {
      "account": "..."
    }
  }
}

Response

The server replies with a JSON-RPC result whose content array carries the tool output as a JSON-encoded text block. isError is true when the call failed.

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ /* JSON-encoded tool result */ }"
      }
    ],
    "isError": false
  }
}