request_oauth_integration_url
Initiate an OAuth handoff to a vendor integration (Google Ads, GA4, Search Console, Sheets, Drive, BigQuery, Meta Ads, Jira, Confluence). Returns an authorization URL the user opens in a browser. After the user clicks Allow, the connection is created and you can poll check_integration_status(handoff_id) to find out when the data is ready.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"provider": "<provider>"
},
"name": "request_oauth_integration_url"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| provider | Yes | OAuth provider to authorize. Currently supports the native-OAuth catalog: Google (Ads, Analytics 4, Search Console, Sheets, Drive, BigQuery), Meta Ads, and Atlassian Jira / Confluence. | |
| integration_type | No | Per-provider sub-type. Google accepts google_ads, gsheets, ga4, gsc, gdrive, bigquery, gcs, gcp, basic. Meta accepts ads or basic. Jira and Confluence accept basic. Defaults to basic. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| provider | Yes | ||
| next_step | Yes | Tool to call next, normally "check_integration_status". | |
| handoff_id | Yes | ||
| authorize_url | Yes | Open in a browser to grant consent. | |
| integration_type | Yes | ||
| expires_in_seconds | Yes |