Extract

Diagnose a connection by analyzing error logs from its most recent retained run. Reads only the tail of the log file to extract ERROR/CRITICAL messages and stacktraces without downloading the entire log. A specified expired run has the normal not-found response because retention leaves no run tombstone. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

diagnose_connection

Get detailed info for a specific connection. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

get_connection

Read configuration for up to 25 streams. Follow next_page_token or pass stream_ids for a targeted form. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

get_connection_configuration

Get detailed info for a specific connector. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

get_connector

Discover required inputs, conditions, defaults, and current values. Secrets require browser or OAuth setup. Ask the user for missing non-secret inputs; credentials must be entered on setup_url, never in chat or elicitation. Do not invent credentials, resource identifiers, nested configuration objects or mappings. Use each parameter's description, type, conditions and custom_object_parameters to ask specific questions. Follow configuration_method for special authentication. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

get_connector_configuration

Discover dynamic choices after authentication, optionally in connection/stream context. Use IDs from configuration discovery. Connector parameters take neither ID; connection parameters require connection_id only; stream parameters require both. The connector must be a source or destination of the owning connection. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

get_connector_parameter_options

Get source sample-data task status, CSV content, and authenticated CSV URL when ready. When csv_content is returned, save it locally as suggested_filename. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

get_sample_data

Poll connector authentication or connection catalog refresh. Never returns raw task logs/results. Stop on SUCCESS, SKIPPED, FAILURE, REVOKED, INTERRUPTED, PURGED, UNKNOWN or EXPIRED. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

get_setup_task_status

Get the stored field/catalog spec for one source stream. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

get_source_stream

View answer-saving settings only when the user asks or needs a settings link. Do not call as a precheck before saving: save tools enforce current permission. Offer settings_url to enable or disable saving. Never enable it yourself. If the user asks to stop saving, stop immediately in this chat. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Do not add another invitation after this tool.

get_answer_saving_preference

List retained recent runs for a connection, newest first. An empty list is valid when all historical runs have expired. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

list_connection_runs

List all connections (pipelines). Returns all rows unless page_token is provided. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

list_connections

List all account connectors (sources and destinations). Returns first 50. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

list_connectors

List streams from a source connector's stored catalog. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

list_source_streams

List destination connector platforms that can be used with create_destination. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

list_supported_destinations

List source connector platforms that can be used with create_source. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

list_supported_sources

Load dynamic dropdown choices for a form field using its saved connector/stream context. Authenticate first. Save changed dependency fields before refreshing choices. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

get_configuration_choices

Discover connection streams and destination data contracts after authentication/configuration. Poll get_setup_task_status, then get_connection_configuration to obtain stream IDs, source fields, destination contracts, required fields and supported load modes. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

refresh_connection_catalog

Save explicitly supplied non-secret form changes after server validation. Use group IDs and property names from get_configuration_form. Send only edited properties; lists replace the complete list, removing omitted entries. Changes overwrite saved configuration and can affect subsequent syncs. Browser-only/secret fields are rejected. For native elicitation, submit the accepted draft; cancel/decline never saves. Partial setup is allowed (for example login inputs before dynamic resource choices); remaining_inputs lists fields still needing attention. Saving is not setup completion. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

submit_configuration_form

Save only the current Extract setup, operations or diagnostics result; the backend enforces current saving permission. question is a brief task-specific intent; answer is only the current Extract result. Never include conversation history, raw transcripts, prior turns, or unrelated messages. Never include credentials or authentication links. Reuse history_ref for corrections. Use a fresh UUID submission_id for each response and the same ID/arguments on retries. For analysis use save_answer (insights_save_answer on /mcp) with existing analysis history. Save directly without a preference precheck or repeated consent prompts. If saving is rejected or unavailable, deliver the answer without a feedback link. If the user also supplied a rating, submit it with answer_ref; do not repeat the invitation on the receipt. Show feedback_url only if non-null. Sample-data download responses require only 'Saved to <path>'. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Do not add another invitation after this tool.

save_response

Search connections by connection name, source, destination, or status. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

search_connections

Search configured account connectors by display name, type, or platform. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

search_connectors

Enable only the listed streams for a connection. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

select_connection_streams

Use this only when a human explicitly rates an identifiable saved answer helpful or not helpful. Thumbs up/down is sufficient; reason and comment are optional. Preserve the exact answer_ref returned when that version was saved, even after corrections. Ask if the target is ambiguous. Never invent satisfaction, infer it from silence, or report agent/tool failures as user ratings. Use a new UUID submission_id for each deliberate rating; reuse it and identical arguments after a transport failure. Do not ask for more feedback after this receipt. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Do not add another invitation after this tool.

submit_feedback

Trigger a manual run for a connection. Only call after user confirms. Requires mcp:write scope and run_connections permission. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

trigger_run

Patch connection and stream parameters and field mappings, preserving omitted fields/streams. parameters uses {source: {name: value}, destination: {name: value}}; pass {} or streams=[] when unused. Stream entries use IDs from get_connection_configuration. Select data_contract_id and field_map entries {type: 'field', source_field_name, data_contract_field, apply_hashing} or {type: 'static_value', static_value, data_contract_field}. Lists replace the full existing list, removing omitted entries; replacing field mappings or load modes changes subsequent sync behavior. Ask the user for required scoped values and desired mappings using discovered parameter and contract definitions. Choose a supported load mode from configuration discovery. Use update_connection_schedule separately for scheduling. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

update_connection_configuration

Update only a connection's schedule/enabled state within account plan limits. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

update_connection_schedule

Patch non-secret account connector parameters, display name, and enabled state. For adding one SQL dataset to a BigQuery/warehouse source, prefer add_source_dataset to preserve the existing list atomically. Omitted values stay unchanged; lists supplied here are replaced in full, removing omitted entries. Disabling a connector can interrupt dependent syncs. Credential-bearing parameters, including nested secrets, are rejected; never include passwords, API keys, or service-account keys. Discover inputs with get_connector_configuration first and ask the user for required values. Use start_connector_oauth for provider consent or the returned setup_url for credential entry, including passwords, service-account keys and SSH setup. Existing SSH key pairs cannot be replaced through these settings. Never ask the user to paste secrets in chat; direct them to the secure Extract page. After saving call authenticate_connector and poll get_setup_task_status. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

update_connector_configuration

Validate saved credentials and discover the connector catalog; does not run a pipeline. Poll get_setup_task_status(task_id); continue setup only after SUCCESS. Save this completed Extract result without repeated consent prompts: save_response for account answers. Save directly without a preference precheck; the backend enforces current saving permission. If saving is rejected/unavailable, deliver the answer without a feedback link. Use get_answer_saving_preference only for requested settings or a settings link. Only the user can change this preference in their browser. Stop saving immediately if asked. Never send chat history or prior turns. Show only returned non-null feedback_url. Submit ratings only on explicit human feedback with the correct answer_ref. No repeat invitation if already rated; no prompts on intermediate steps, downloads or receipts. Otherwise show a 'Leave feedback' link after the saved answer; choose a rating in the form.

authenticate_connector