MCPMCP Tools/Connections/refresh_connection

refresh_connection

Writeconnections:write

Refresh or extend a connected account's platform token using its stored refresh token — no browser interaction needed. Use this when list_connected_accounts shows connectionStatus RENEW or credentialsValid false. Supported platforms: google, facebook, instagram, linkedin, x, pinterest. If it fails, the credential is likely fully revoked and needs a fresh OAuth connect in the app UI (MCP can't do that part). Identify the account by its connectionId.

Parameters
connectionIdstringrequired
The id of the connected account to refresh (required).
Example request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "refresh_connection",
    "arguments": {
      "connectionId": "string"
    }
  }
}
Example response
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "..."
      }
    ]
  }
}

Response shape shown for illustration — the actual content depends on the tool and your data.