# Turbot Pipes — how to use (mcp.ai)

Connect your Turbot Pipes account and use 170 tools for developer tools straight from your AI agent. Connect with your own API key. Turbot Pipes is an intelligence, automation, and security platform built specifically for DevOps, offering hosted Steampipe database instances, shared dashboards, snapshots, and more.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_turbot_pipes?ms=1787291400000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `turbot_pipes_actor_get`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/turbot_pipes`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/turbot_pipes/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/turbot_pipes/actor/get` — Tool to retrieve the authenticated actor. Use when you need details about the currently authenticated actor after obtaining a valid token.
- `POST https://api.mcp.ai/api/turbot_pipes/actor/list/activity` — Tool to list activities for the authenticated actor. Use when you need detailed activity logs with optional filtering and pagination.
  - body: { limit?: integer, filter?: string, next_token?: string }
- `POST https://api.mcp.ai/api/turbot_pipes/actor/list/connections` — Tool to list connections associated with the authenticated actor. Use after confirming authentication to retrieve the actor's connection list.
  - body: { type?: string, limit?: integer, offset?: integer, actorId?: string }
- `POST https://api.mcp.ai/api/turbot_pipes/actor/list/orgs` — Tool to list organizations associated with the authenticated actor. Use when you have a valid access token.
- `POST https://api.mcp.ai/api/turbot_pipes/actor/list/workspaces` — Tool to list workspaces for the authenticated actor. Use when you need to retrieve all workspaces the actor has access to.
- `POST https://api.mcp.ai/api/turbot_pipes/auth/login/token/email/create` — Tool to start login process by sending a confirmation code to a user's email. Use when initiating a passwordless email login flow.
  - body: { email: string }
- `POST https://api.mcp.ai/api/turbot_pipes/create/auth/signup` — Tool to create a new user account via signup. Use when registering a new user with their email address.
  - body: { email: string, state?: string }
- `POST https://api.mcp.ai/api/turbot_pipes/create/org/connection` — Tool to create a new connection for an organization. Use when you need to establish a new connection with a specific plugin (e.g., AWS, GCP, Azure) in an organization.
  - body: { mode?: string, config?: object, handle: string, plugin: string, parent_id?: string, org_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/create/org/connection/folder` — Tool to create a new connection folder for an organization. Use when you need to create a connection folder in an org to organize connections.
  - body: { mode?: string, title: string, parent_id?: string, org_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/create/org/workspace/aggregator` — Tool to create an aggregator for a workspace of an organization. Use when you need to add a new aggregator to a specific organization's workspace.
  - body: { config?: object, handle: string, plugin: string, org_handle: string, connections?: string[], workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/create/org/workspace/connection` — Tool to create a connection on an org workspace or associate an existing org connection to the workspace. Use when you need to create or link a connection to an organization's workspace.
  - body: { config?: object, handle: string, plugin: string, parent_id?: string, org_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/create/org/workspace/connection/folder` — Tool to create a connection folder in a workspace of an organization. Use when you need to organize connections into folders within an org workspace.
  - body: { mode?: string, title: string, parent_id?: string, org_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/create/org/workspace/query` — Tool to execute a SQL query in an org workspace using POST method. Use when you need to run queries against Turbot Pipes workspaces. Results are limited to 5000 rows or 30 seconds of execution time.
  - body: { sql: string, org_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/create/org/workspace/snapshot` — Tool to create a new workspace snapshot for an organization. Use when you need to save a point-in-time capture of dashboard data, layouts, and panels for a workspace.
  - body: { data: object, tags?: object, title?: string, org_handle: string, visibility?: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/create/user/ai/key` — Tool to create a new AI provider API key at the user level. Use when you need to configure AI provider credentials for a specific user in Turbot Pipes.
  - body: { api_key: string, provider: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/create/user/connection` — Tool to create a new connection for a user. Use when you need to establish a new connection with a specific plugin (e.g., AWS, GCP, Azure) for a user account.
  - body: { mode?: string, config?: object, handle: string, plugin: string, parent_id?: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/create/user/integration` — Tool to create a new integration for a user. Use when you need to create a new integration for a specific user by providing the user handle, integration handle, and type.
  - body: { type: string, config?: object, handle: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/create/user/notifier` — Tool to create a new notifier for a user. Use when you need to configure notification endpoints for a specific user in Turbot Pipes.
  - body: { name: string, state: string, notifies: object[], user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/create/user/password` — Tool to create or rotate a user password. Use when you need to generate a new password for a user or reset an existing one.
  - body: { user_handle: string, expires_in_minutes?: integer }
- `POST https://api.mcp.ai/api/turbot_pipes/create/user/workspace/connection` — Tool to create a connection on a workspace for a user. Use when you need to create or link a connection to a user's workspace.
  - body: { config?: object, handle: string, plugin: string, parent_id?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/create/user/workspace/connection/folder` — Tool to create a connection folder in a workspace of a user. Use when you need to organize connections into folders within a user workspace.
  - body: { title: string, parent_id?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/create/user/workspace/datatank` — Tool to create a new user workspace Datatank. Use when you need to create a new Datatank for data storage in a user's workspace.
  - body: { handle: string, description?: string, user_handle: string, desired_state?: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/create/user/workspace/datatank/table` — Tool to create a new user workspace datatank table. Use when you need to create a table within a user's workspace datatank for data storage and querying.
  - body: { name: string, type: string, part_per?: string, frequency: object, description?: string, user_handle: string, source_query?: string, source_table?: string, desired_state?: string, source_schema?: string, datatank_handle: string, workspace_handle: string, skip_initial_refresh?: boolean }
- `POST https://api.mcp.ai/api/turbot_pipes/create/user/workspace/mod/variable/setting` — Tool to create a setting for a mod variable in a user workspace. Use when you need to configure a variable for a mod installed in a user's workspace.
  - body: { name: string, setting: string|integer|number|boolean|object|string|integer|number|boolean|object[], mod_alias: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/create/user/workspace/notifier` — Tool to create a new notifier for a user workspace. Use when you need to configure a notification endpoint (e.g., Slack, email) for a specific workspace.
  - body: { name: string, state?: string, notifies: object[], user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/delete/conversation/org` — Tool to delete a specific org workspace conversation. Use when you need to remove an AI conversation from an organization workspace after confirming the org handle, workspace handle, and conversation 
  - body: { org_handle: string, conversation_id: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/delete/org` — Tool to delete a specified organization if you have appropriate access. Use when you need to permanently remove an organization and have confirmed the org handle.
  - body: { org_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/delete/org/billing/subscription` — Tool to delete an organization billing subscription. Schedules cancellation at the end of the current period. Use when you need to cancel an org subscription after confirming the org handle and subscr
  - body: { org_handle: string, subscription_id: string }
- `POST https://api.mcp.ai/api/turbot_pipes/delete/org/connection/permission` — Tool to delete permission for a connection defined on an org. Use when you need to revoke a specific permission from an org connection.
  - body: { org_handle: string, permission_id: string, connection_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/delete/org/workspace` — Tool to delete an organization workspace. Use when you need to permanently remove a workspace from an organization after confirming org and workspace handles.
  - body: { org_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/delete/org/workspace/mod/variable/setting` — Tool to delete setting for a mod variable in an organization workspace. Use when you need to remove a custom setting for a mod variable in a specific workspace.
  - body: { mod_alias: string, org_handle: string, variable_name: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/delete/user/avatar` — Tool to delete custom avatar for a user. Use when you need to remove a user's custom avatar and revert to default.
  - body: { user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/delete/user/connection/deprecated` — Tool to delete a connection belonging to a user (deprecated endpoint). Use when you need to remove a user's connection after confirming the user handle and connection handle. Returns the deleted conne
  - body: { conn_handle: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/delete/user/integration` — Tool to delete an integration configured for a user. Use when you need to remove a user's integration by providing the user handle and integration handle.
  - body: { user_handle: string, integration_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/delete/user/workspace/mod/variable/setting` — Tool to delete a mod variable setting in a user workspace. Use when you need to remove a variable configuration from a mod installed in a user's workspace.
  - body: { mod_alias: string, user_handle: string, variable_name: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/delete/user/workspace/notifier` — Tool to delete a notifier for a user workspace. Use when you need to remove a notification configuration from a specific workspace.
  - body: { user_handle: string, notifier_name: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/delete/user/workspace/pipeline` — Tool to delete a pipeline from a user's workspace. Use when you need to remove a specific pipeline by its ID from a workspace.
  - body: { pipeline_id: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/auth/provider` — Tool to initiate OAuth authentication flow with a provider. Use when you need to start the OAuth authorization process for GitHub, Google, or SAML authentication.
  - body: { provider: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/conversation/user` — Tool to retrieve details for a specific user workspace conversation. Use when you need to get information about an AI conversation in a user workspace.
  - body: { user_handle: string, conversation_id: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/datatank/table` — Tool to get the details for a workspace Datatank table. Use when you need to retrieve information about a specific datatank table including its state, configuration, and metadata.
  - body: { org_handle: string, datatank_handle: string, workspace_handle: string, datatank_table_name: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/org` — Tool to retrieve organization information by handle. Use when you need details about a specific organization.
  - body: { org_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/org/billing/invoice` — Tool to get an invoice for an organization. Use when you need to retrieve detailed billing invoice information for a specific organization and invoice ID.
  - body: { invoice_id: string, org_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/org/connection/permission` — Tool to retrieve permission details for an org connection. Use when you need to view a specific permission record for a connection within an organization.
  - body: { org_handle: string, permission_id: string, connection_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/org/integration` — Tool to get details of an integration configured on an organization. Use when you need to retrieve information about a specific integration by its handle and organization handle.
  - body: { org_handle: string, integration_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/org/member` — Tool to retrieve a specific organization member by org handle and user handle. Use when you need details about a specific member of an organization.
  - body: { org_handle: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/org/workspace/connection` — Tool to get the details for a workspace and connection association on an organization. Use when you need to retrieve information about how a connection is associated with a specific workspace in an or
  - body: { org_handle: string, workspace_handle: string, connection_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/org/workspace/connection/folder` — Tool to retrieve a connection folder for an organization workspace. Use when you need to get details about a specific connection folder in an org workspace.
  - body: { folder_id: string, org_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/org/workspace/flowpipe/trigger` — Tool to get the details of a trigger for a workspace in an organization. Use when you need to retrieve information about a specific Flowpipe trigger.
  - body: { org_handle: string, trigger_name: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/org/workspace/integration` — Tool to get details of an integration available for a workspace belonging to an organization. Use when you need to retrieve information about a specific integration configured for a workspace within a
  - body: { org_handle: string, workspace_handle: string, integration_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/org/workspace/mod/variable/setting` — Tool to get setting for a mod variable in an organization workspace. Use when you need to retrieve the current configuration and value of a specific mod variable in a workspace.
  - body: { mod_alias: string, org_handle: string, variable_name: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/org/workspace/notifier` — Tool to retrieve a notifier from an org workspace. Use when you need to get details about a specific notification endpoint configured for an organization's workspace.
  - body: { org_handle: string, notifier_name: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/org/workspace/query/data` — Tool to execute a SQL query in an org workspace and retrieve results. Use when you need to run queries against Turbot Pipes workspaces. Results are limited to 5000 rows or 30 seconds of execution time
  - body: { sql: string, extensions: string, org_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/tenant` — Tool to retrieve tenant information by handle. Use when you need details about a specific tenant.
  - body: { tenant_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/tenant/avatar` — Tool to retrieve public avatar image for a tenant. Use when you need to display or download the tenant's avatar.
  - body: { tenant_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user` — Tool to retrieve user information by handle. Use when you need details about a specific user.
  - body: { user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/ai/key` — Tool to retrieve AI provider API key metadata at the user level. Use when you need to check which AI provider keys are configured for a specific user.
  - body: { provider: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/billing/plan` — Tool to get the current user billing plan. Use when you need to retrieve detailed billing plan information for a specific user.
  - body: { user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/billing/upcoming/invoice` — Tool to get the upcoming invoice for a user. Use when you need to retrieve the estimated next invoice for a user's billing cycle. Returns null when no upcoming invoice exists.
  - body: { user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/connection` — Tool to retrieve details of a connection belonging to a user. Use when you need to fetch information about a specific user connection by user handle and connection handle.
  - body: { user_handle: string, connection_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/email` — Tool to retrieve a specific user email record with metadata. Use when you need details about a user's email verification status and metadata.
  - body: { email_id: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/integration` — Tool to get details of an integration configured on a user. Use when you need to retrieve information about a specific user integration by providing the user handle and integration handle.
  - body: { user_handle: string, integration_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/password` — Tool to retrieve user database password. Use when you need to get the database password for a specific user by their handle.
  - body: { user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/preferences` — Tool to retrieve user preferences including email subscription settings. Use when you need to check a user's communication preferences.
  - body: { user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/process` — Tool to retrieve process information for a user. Use when you need details about a specific process associated with a user.
  - body: { process_id: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/workspace` — Tool to retrieve workspace details for a specific user. Use when you need information about a workspace owned by a user.
  - body: { user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/workspace/aggregator` — Tool to get the details of an aggregator belonging to a workspace of a user. Use when you need to retrieve information about a specific aggregator in a user's workspace.
  - body: { user_handle: string, workspace_handle: string, aggregator_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/workspace/connection` — Tool to get the details for a workspace and connection association for a user. Use when you need to retrieve information about how a connection is associated with a specific workspace owned by a user.
  - body: { user_handle: string, workspace_handle: string, connection_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/workspace/connection/folder` — Tool to retrieve a connection folder for a user workspace. Use when you need to get details about a specific connection folder in a user workspace.
  - body: { folder_id: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/workspace/datatank` — Tool to retrieve user workspace datatank details. Use when you need information about a specific datatank within a user's workspace.
  - body: { user_handle: string, datatank_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/workspace/flowpipe/mod` — Tool to retrieve details of an installed flowpipe mod in a user workspace. Use when you need information about a specific flowpipe mod installed in a workspace.
  - body: { mod_alias: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/workspace/flowpipe/pipeline` — Tool to retrieve pipeline details for a user workspace. Use when you need detailed information about a specific Flowpipe pipeline in a user's workspace.
  - body: { pipeline_id: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/workspace/integration` — Tool to get details of an integration available for a workspace belonging to a user. Use when you need to retrieve information about a specific integration configured for a user's workspace.
  - body: { user_handle: string, workspace_handle: string, integration_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/workspace/mod` — Tool to retrieve details of an installed mod in a user's workspace. Use when you need information about a specific mod installed in a workspace owned by a user.
  - body: { mod_alias: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/workspace/mod/variable/setting` — Tool to get setting for a mod variable in a user workspace. Use when you need to retrieve the current configuration and value of a specific mod variable in a user's workspace.
  - body: { mod_alias: string, user_handle: string, variable_name: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/workspace/notifier` — Tool to retrieve a notifier from a user workspace. Use when you need to get details about a specific notification endpoint configured for a user's workspace.
  - body: { user_handle: string, notifier_name: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/workspace/pipeline` — Tool to get the details of a pipeline for a workspace of a user. Use when you need information about a specific pipeline in a user workspace.
  - body: { pipeline_id: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/workspace/process` — Tool to retrieve process details for a user workspace. Use when you need information about a specific process running in a user's workspace.
  - body: { process_id: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/workspace/process/log` — Tool to retrieve process logs for a user workspace process. Use when you need to fetch and analyze logs for a specific process running in a user's workspace.
  - body: { log_file: string, process_id: string, user_handle: string, content_type: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/workspace/query` — Tool to execute a SQL query in a user workspace and retrieve results. Use when you need to run queries against Turbot Pipes user workspaces. Results are limited to 5000 rows or 30 seconds of execution
  - body: { sql: string, user_handle: string, content_type?: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/workspace/query/data` — Tool to execute a SQL query in a user workspace and retrieve results. Use when you need to run queries against Turbot Pipes user workspaces. Results are limited to 5000 rows or 30 seconds of execution
  - body: { sql: string, extensions: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/workspace/schema` — Tool to retrieve workspace schema details for a specific user. Use when you need information about a specific schema within a user's workspace.
  - body: { schema_name: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/get/user/workspace/schema/table` — Tool to get details about a specific table in a user workspace schema. Use when you need information about table structure, columns, and metadata within a user's workspace schema.
  - body: { table_name: string, schema_name: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/identities/get` — Tool to retrieve a specific identity by handle. Use when you need details of an identity by its handle after authenticating.
  - body: { identity_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/identities/get/avatar` — Tool to retrieve avatar image for an identity. Use when you need to display or download the user's avatar after knowing their identity handle.
  - body: { identity_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/identities/list` — Tool to list all identities. Use when you need to retrieve identities with optional filtering, sorting, and pagination after authentication.
  - body: { q?: string, limit?: integer, next_token?: string }
- `POST https://api.mcp.ai/api/turbot_pipes/initiate/login` — Tool to initiate user login. Use when starting a login flow for a user with their email address.
  - body: { email: string, state?: string }
- `POST https://api.mcp.ai/api/turbot_pipes/install/user/integration/slack` — Tool to install a Slack integration for a user identity. Use when you need to initiate the Slack OAuth flow by redirecting to the Slack authorization URL.
  - body: { user_handle: string, integration_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/install/user/workspace/flowpipe/mod` — Tool to install a flowpipe mod to a user's workspace. Use when you need to install a flowpipe mod from a repository path into a specific user workspace.
  - body: { path: string, branch?: string, version?: string, constraint?: string, user_handle: string, workspace_handle: string, integration_handle?: string }
- `POST https://api.mcp.ai/api/turbot_pipes/install/user/workspace/mod` — Tool to install a mod to a user workspace. Use when you need to add a new mod from a repository path to a specific workspace.
  - body: { path: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/org/process` — Tool to list processes for an organization. Use when you need to retrieve all processes for a specific organization with optional pagination.
  - body: { limit?: integer, next_token?: string, org_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/org/service/accounts` — Tool to list service accounts at the organization level. Use when you need to retrieve all service accounts for a specific organization.
  - body: { limit?: integer, next_token?: string, org_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/org/usage` — Tool to list all usage metrics for an organization. Use when you need to retrieve usage data for billing, monitoring, or analytics purposes.
  - body: { limit?: integer, next_token?: string, org_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/org/workspace/datatank` — Tool to list org workspace Datatank with pagination support. Use when you need to retrieve Datatank items for a specific organization and workspace.
  - body: { limit?: integer, next_token?: string, org_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/org/workspace/flowpipe/mod/variable` — Tool to list all variables for a flowpipe mod in an organization workspace. Use when you need to retrieve mod variables within a specific workspace.
  - body: { limit?: integer, mod_alias: string, next_token?: string, org_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/org/workspace/mod` — Tool to list organization workspace installed mods with pagination support. Use when you need to retrieve installed mods for a specific organization and workspace.
  - body: { limit?: integer, next_token?: string, org_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/org/workspace/pipeline` — Tool to list pipelines for a workspace of an organization. Use when you need to retrieve scheduled tasks for dashboard snapshots or queries within a specific workspace.
  - body: { limit?: integer, where?: string, next_token?: string, org_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/org/workspace/process` — Tool to list processes associated with an org workspace. Use when you need to retrieve all processes for a specific organization workspace with optional filtering and pagination.
  - body: { limit?: integer, where?: string, next_token?: string, org_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/org/workspaces` — Tool to list workspaces for a specific organization. Use when you need to retrieve all workspaces associated with an organization handle.
  - body: { limit?: integer, next_token?: string, org_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/tenant/getsettings` — Tool to retrieve tenant settings. Use when you need to view the current configuration for the tenant, including login methods, session timeouts, and user provisioning settings.
- `POST https://api.mcp.ai/api/turbot_pipes/list/tenants` — Tool to list tenants the actor is a member of. Use when you need to retrieve all tenants associated with the authenticated user.
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/ai/keys` — Tool to list AI provider API keys configured at the user level. Use when you need to retrieve all AI keys for a specific user.
  - body: { limit?: integer, next_token?: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/audit/logs` — Tool to list audit logs for a specific user. Use when you need to retrieve audit trail information with optional pagination.
  - body: { limit?: integer, next_token?: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/billing/invoices` — Tool to list user invoices with pagination support. Use when you need to retrieve billing invoice information for a specific user.
  - body: { limit?: integer, next_token?: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/billing/payment/method` — Tool to list user billing payment methods. Use when you need to retrieve payment methods configured for a user's billing.
  - body: { limit?: integer, next_token?: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/billing/subscription` — Tool to list user billing subscriptions. Use when you need to retrieve subscription information for a specific user. Note: Users typically have one active subscription, but this endpoint may also retu
  - body: { limit?: integer, next_token?: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/connections` — Tool to list connections for a specific user by user handle. Use when you need to retrieve all connections associated with a user.
  - body: { limit?: integer, next_token?: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/constraints` — Tool to list all applicable constraints for a user. Use when you need to retrieve quota, rate, or setting constraints with optional filtering and pagination.
  - body: { limit?: integer, where?: string, next_token?: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/emails` — Tool to list emails for a user along with metadata information for each item. Use when you need to retrieve all email addresses associated with a specific user.
  - body: { limit?: integer, next_token?: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/integration` — Tool to list integrations configured for a user. Use when you need to retrieve all integrations for a specific user with optional pagination.
  - body: { limit?: integer, next_token?: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/process` — Tool to list processes for a user. Use when you need to retrieve all processes for a specific user with optional pagination.
  - body: { limit?: integer, next_token?: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/usage` — Tool to list all usage metrics for a user. Use when you need to retrieve usage data for billing, monitoring, or analytics purposes.
  - body: { limit?: integer, where?: string, next_token?: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/aggregator` — Tool to list aggregators for a workspace of a user. Use when you need to retrieve aggregator configurations for a specific user's workspace.
  - body: { limit?: integer, next_token?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/aggregator/connections` — Tool to list all connections that are part of an aggregator in a user workspace. Use when you need to retrieve connections within a specific aggregator.
  - body: { limit?: integer, next_token?: string, user_handle: string, workspace_handle: string, aggregator_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/audit/logs` — Tool to list audit logs for a specific user workspace. Use when you need to retrieve workspace audit trail information with optional pagination.
  - body: { limit?: integer, next_token?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/connection` — Tool to list connections explicitly defined or associated to a workspace. Use when you need to retrieve all connections available in a user's workspace.
  - body: { limit?: integer, next_token?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/connection/association` — Tool to list connections associated with a workspace for a specific user. Use when you need to retrieve all connection associations for a user's workspace.
  - body: { limit?: integer, next_token?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/connection/folder` — Tool to list connection folders for a user workspace. Use when you need to retrieve all connection folders associated with a user's workspace.
  - body: { limit?: integer, next_token?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/connection/tree` — Tool to list connection tree for a user workspace. Use when you need to retrieve the hierarchical connection structure for a specific user's workspace.
  - body: { limit?: integer, where?: string, prefix?: string, next_token?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/conversations` — Tool to list AI conversations in a user workspace with optional filtering and pagination. Use when you need to retrieve conversations from a specific user workspace, optionally filtered by title patte
  - body: { limit?: integer, where?: string, next_token?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/datatank` — Tool to list user workspace Datatank with pagination support. Use when you need to retrieve Datatank items for a specific user and workspace.
  - body: { limit?: integer, next_token?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/datatank/part` — Tool to list user workspace Datatank partitions with pagination support. Use when you need to retrieve partition details for a specific Datatank table in a user's workspace.
  - body: { limit?: integer, next_token?: string, user_handle: string, datatank_handle: string, workspace_handle: string, datatank_table_name: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/datatank/table` — Tool to list user workspace Datatank tables with pagination support. Use when you need to retrieve datatank tables for a specific user, workspace, and datatank.
  - body: { limit?: integer, next_token?: string, user_handle: string, datatank_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/db/logs` — Tool to list database query logs for a specific user workspace. Use when you need to retrieve workspace database query history with optional pagination.
  - body: { limit?: integer, next_token?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/flowpipe/input` — Tool to list Flowpipe inputs for a user workspace. Use when you need to retrieve all Flowpipe inputs for a specific workspace with optional pagination.
  - body: { limit?: integer, next_token?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/flowpipe/mod/variable` — Tool to list all variables for a flowpipe mod in a user workspace. Use when you need to retrieve mod variables within a specific workspace owned by a user.
  - body: { limit?: integer, mod_alias: string, next_token?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/flowpipe/pipeline` — Tool to list Flowpipe pipelines for a user workspace. Use when you need to retrieve pipelines within a specific workspace belonging to a user.
  - body: { limit?: integer, where?: string, next_token?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/flowpipe/pipeline/trigger` — Tool to list Flowpipe triggers associated with a specific pipeline in a user workspace. Use when you need to retrieve all triggers configured for a particular pipeline.
  - body: { limit?: integer, where?: string, next_token?: string, pipeline_id: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/flowpipe/trigger` — Tool to list Flowpipe triggers for a user workspace. Use when you need to retrieve all triggers configured in a specific user's workspace.
  - body: { limit?: integer, where?: string, next_token?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/integration` — Tool to list integrations available for a user workspace. Use when you need to retrieve all integrations configured for a specific user workspace. If run on a custom tenant, this will return integrati
  - body: { limit?: integer, next_token?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/mod` — Tool to list user workspace installed mods with pagination support. Use when you need to retrieve installed mods for a specific user and workspace.
  - body: { limit?: integer, next_token?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/mod/variable` — Tool to list all variables applicable for a mod in a workspace specific to a user. Use when you need to retrieve mod variables within a specific user's workspace.
  - body: { limit?: integer, mod_alias: string, next_token?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/notifier` — Tool to list all notifiers for a user workspace. Use when you need to view notification endpoints configured for a specific user's workspace with optional pagination and filtering.
  - body: { limit?: integer, where?: string, next_token?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/pipeline` — Tool to list pipelines for a workspace of a user. Use when you need to retrieve scheduled tasks for dashboard snapshots or queries within a specific user workspace.
  - body: { limit?: integer, where?: string, next_token?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/process` — Tool to list processes associated with a user workspace. Use when you need to retrieve all processes for a specific user workspace with optional filtering and pagination.
  - body: { limit?: integer, where?: string, next_token?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/schema` — Tool to list schemas for a user workspace. Use when you need to retrieve schemas including aggregators, datatanks, and identity-level connections for a specific user's workspace.
  - body: { limit?: integer, next_token?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/schema/table` — Tool to list tables for a user workspace schema with pagination support. Use when you need to retrieve tables for a specific user, workspace, and schema.
  - body: { limit?: integer, next_token?: string, schema_name: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/snapshot` — Tool to list workspace snapshots for a user. Use when you need to retrieve snapshots from a specific user workspace with optional pagination.
  - body: { limit?: integer, next_token?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspace/usage` — Tool to list the usage associated with a user workspace. Use when you need to retrieve usage metrics for a specific user's workspace with optional filtering and pagination.
  - body: { limit?: integer, where?: string, next_token?: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/list/user/workspaces` — Tool to list workspaces for a specific user. Use when you need to retrieve all workspaces associated with a user handle.
  - body: { limit?: integer, next_token?: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/post/user/workspace/notifier/command` — Tool to post a command for a notifier in a user's workspace. Use when you need to execute commands on workspace notifiers, such as setting a notifier as the default.
  - body: { command: string, user_handle: string, notifier_name: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/post/user/workspace/query` — Tool to perform a SQL query in a user workspace. Use when you need to execute queries against Turbot Pipes user workspaces. Results are limited to 5000 rows or 30 seconds of execution time.
  - body: { sql: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/run/org/workspace/command` — Tool to run a command in an organization workspace. Use when you need to execute workspace operations like rebooting a workspace.
  - body: { command: string, org_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/run/user/workspace/command` — Tool to run a command in a user workspace. Use when you need to execute workspace operations like rebooting a user's workspace.
  - body: { command: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/run/user/workspace/flowpipe/pipeline/command` — Tool to run a command on a Flowpipe pipeline in a user workspace. Use when you need to execute a pipeline command such as 'run' to start pipeline execution.
  - body: { args?: object, command: string, user_handle: string, pipeline_name: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/run/user/workspace/flowpipe/trigger/command` — Tool to run a command on a trigger in a workspace belonging to a user. Use when you need to execute or reset a Flowpipe trigger.
  - body: { args?: object, command: string, user_handle: string, trigger_name: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/run/user/workspace/query` — Tool to perform a SQL query in a user workspace using POST method. Use when you need to execute queries against Turbot Pipes user workspaces. Results are limited to 5000 rows or 30 seconds of executio
  - body: { sql: string, extensions: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/send/user/workspace/chat/message` — Tool to send a chat message to the AI agent in a user workspace. Creates a new conversation if conversation_id is not provided, or continues an existing conversation if provided.
  - body: { model: string, message: string, provider: string, user_handle: string, conversation_id?: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/test/user/ai/key` — Tool to test whether an AI provider API key is valid at the user level. Use when you need to verify if a saved or provided API key works correctly with the specified provider.
  - body: { api_key?: string, provider: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/test/user/connection` — Tool to test a user connection for basic connectivity. Use when you need to verify if a connection's configuration is valid and the credentials work correctly with the specified plugin.
  - body: { config?: object, plugin: string, user_handle: string, connection_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/test/user/integration` — Tool to test the config for a user integration to check for basic connectivity before you create it. Use when you need to validate integration credentials and configuration by providing the user handl
  - body: { type: string, config: object, user_handle: string, integration_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/test/user/workspace/connection` — Tool to test the config for a connection configured on a user workspace to check for basic connectivity. Use when you need to verify that a connection is properly configured before creating or using i
  - body: { config?: object, plugin: string, user_handle: string, workspace_handle: string, connection_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/uninstall/flowpipe/mod` — Tool to uninstall a flowpipe mod from a user's workspace. Use when you need to remove a flowpipe mod from a specific workspace after confirming the user handle, workspace handle, and mod alias.
  - body: { mod_alias: string, user_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/uninstall/org/workspace/flowpipe/mod` — Tool to uninstall a flowpipe mod from an organization workspace. Use when you need to remove a flowpipe mod from a specific workspace after confirming org handle, workspace handle, and mod alias.
  - body: { mod_alias: string, org_handle: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/update/conversation/user` — Tool to update a user workspace conversation (e.g., title). Use when you need to modify properties of an AI conversation in a user workspace.
  - body: { title: string, user_handle: string, conversation_id: string, workspace_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/update/org/billing/subscription` — Tool to update an organization billing subscription. Use to stop cancellation at the next billing period by passing 'stopcancel' action or to upgrade the subscription. Useful when managing org subscri
  - body: { action: string, org_handle: string, subscription_id: string }
- `POST https://api.mcp.ai/api/turbot_pipes/update/org/connection` — Tool to update the details of a connection belonging to an organization. Use when you need to modify connection configuration, change config/credential sources, rename the connection handle, or reassi
  - body: { config?: object, handle?: string, parent_id?: string, org_handle: string, config_source?: string, connection_handle: string, credential_source?: string }
- `POST https://api.mcp.ai/api/turbot_pipes/update/org/connection/folder` — Tool to update the details of an org connection folder. Use when you need to modify the title or parent location of a connection folder.
  - body: { title?: string, folder_id: string, parent_id?: string, org_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/update/org/member` — Tool to update the role of an organization member. Use when you need to change a member's role (e.g., promote to owner or demote to member) within an organization.
  - body: { role: string, org_handle: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/update/org/service/account` — Tool to update an existing service account at the organization level. Use when you need to modify the title, description, or token_min_issued_at for a service account.
  - body: { title?: string, org_handle: string, description?: string, token_min_issued_at?: string, service_account_identifier: string }
- `POST https://api.mcp.ai/api/turbot_pipes/update/org/service/account/token` — Tool to update an existing token for an organization-level service account. Use when you need to modify token properties such as status, title, or description.
  - body: { title?: string, status: string, token_id: string, org_handle: string, description?: string, service_account_identifier: string }
- `POST https://api.mcp.ai/api/turbot_pipes/update/user` — Tool to update user information including handle name, display name, or URL. Use when you need to modify user attributes.
  - body: { url?: string, handle?: string, user_handle: string, display_name?: string, token_min_issued_at?: string, usage_compute_action?: string, usage_storage_action?: string, usage_compute_threshold?: integer, usage_storage_threshold?: integer }
- `POST https://api.mcp.ai/api/turbot_pipes/update/user/ai/key` — Tool to update an existing AI provider API key at the user level. Use when you need to update an API key for a specific AI provider (OpenAI or Anthropic) for a user.
  - body: { api_key: string, provider: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/update/user/connection` — Tool to update the details of a connection belonging to a user. Use when you need to modify configuration, handle, parent_id, config_source, or credential_source of a user's connection. Requires user_
  - body: { mode?: string, config?: object, handle?: string, parent_id?: string, user_handle: string, config_source?: string, connection_handle: string, credential_source?: string }
- `POST https://api.mcp.ai/api/turbot_pipes/update/user/integration` — Tool to update details of an integration configured for a user. Use when you need to modify an existing user integration's state, handle, or configuration.
  - body: { state?: string, config?: object, handle?: string, user_handle: string, integration_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/update/user/preferences` — Tool to update user preferences for email communications. Use when you need to change a user's communication preferences such as opting in or out of product updates, community updates, or tips and tri
  - body: { user_handle: string, communication_product_updates?: string, communication_tips_and_tricks?: string, communication_community_updates?: string }
- `POST https://api.mcp.ai/api/turbot_pipes/update/user/token` — Tool to update a user token's status between active and inactive. Use when you need to enable or disable a token without deleting it.
  - body: { title?: string, status: string, token_id: string, description?: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/update/user/workspace` — Tool to update the workspace for a user. Use when you need to modify workspace settings such as desired state, instance type, database volume size, or search path prefix.
  - body: { handle?: string, user_handle: string, desired_state?: string, instance_type?: string, workspace_handle: string, search_path_prefix?: string[], db_volume_size_bytes?: integer }
- `POST https://api.mcp.ai/api/turbot_pipes/user/notifiers/list` — Tool to list all notifiers for a user. Use when you need to view a user's configured notification endpoints.
  - body: { user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/user/tokens/delete` — Tool to delete a specific user token. Use when you need to revoke a user's token after confirming handle and token ID.
  - body: { token_id: string, user_handle: string }
- `POST https://api.mcp.ai/api/turbot_pipes/user/tokens/get` — Tool to retrieve details of a specific user token. Use when you need to inspect token metadata (e.g., creation time and scopes) after confirming the user handle and token ID.
  - body: { token_id: string, user_handle: string }

## Example prompts
- "What can I do in Turbot Pipes?"
- "Show me a summary of my Turbot Pipes account"

## More
- Page: https://mcp.ai/turbot_pipes
- Agent spec (llms.txt): https://mcp.ai/turbot_pipes/llms.txt
- Postman collection: https://mcp.ai/turbot_pipes/postman.json