+Beyond-Bot.ai + Ambiguous MCP
Operate an Ambiguous workspace through its provider-hosted MCP server, including documents, spreadsheets, tasks, CRM, calendar, mail, chat, and administration. Uses the connected account’s workspace-scoped API key. Some tools send external messages, delete data, change access, or consume the workspace action allowance.
What You Can Do with this Integration
Automate Data Entry
Automatically sync new contacts or deals from Beyond-Bot.ai to Ambiguous MCP.
Enrich Customer Profiles
Use Beyond-Bot.ai to find and add new information to your records in Ambiguous MCP.
Trigger Workflows
Start automated workflows in Ambiguous MCP based on conversations with your virtual expert.
Available Actions
Here are the specific actions your virtual expert can perform within Ambiguous MCP.
Ack Mentions Activity
Acknowledge the Mentions & reactions inbox after it has been displayed. Marks the caller's unread chat mention notifications read and stamps users.mentions_acked_at, so the projector recomputes both chat.mentions and chat.reactions to 0 durably (the sidebar "Mentions & reactions" item un-bolds and stays cleared across re-fetch). Per-channel read cursors are untouched, so channel message unread counts are unaffected; a reaction that arrives after the ack re-bolds the item.
Ack Thread Activity
Acknowledge readable Threads inbox activity on entry without advancing personal read cursors or clearing explicit manual unread intent.
Add Conditional Format
Add a conditional formatting rule to a spreadsheet. Provide one of booleanRule, gradientRule, iconSetRule, or dataBarRule. The server generates a unique ID for the rule.
Add Connected Element
Extend a flow: place a new node beside an existing element and connect them in one call — the server computes the position unless you pass `drop_point`. Use this instead of create_canvas_element + a manual connector when building a flowchart, product map, or swimlane step-by-step. Give `source_element_id` and a `direction` (n/s/e/w); the new node lands one standard gap on that side and is nudged clear of any overlap, and a connector is created pre-attached from the source to it. For a drag-to-empty gesture, supply optional `drop_point: { x, y }` to center the new node at that board-space point instead of automatic placement. Provide `element` for the new node's type (connector/frame/swimlane not allowed here), or omit it to duplicate the source. Coordinates: board units, top-left origin, +x right / +y down. Example: add_connected_element({ id: "<boardId>", source_element_id: "<elId>", direction: "e", element: { type: "shape", shape: "diamond" } }) → { element, connector }.
Add Deal Line Item
Add a line item to a deal. Either reference an existing product (via product_id) or create a custom line by providing name and unit_price. The deal amount is auto-recalculated.
Add Forwarding Address
Add a forwarding address (sends verification email).
Add Pipeline Member
Add (or update the role of) a user or team on a CRM pipeline. Provide either user_id or team_id, plus role (admin | member). Admins/owners and pipeline admins can manage members.
Add Shared Drive Member
Add a member (manager-only).
Add Sheet Column
Add a column to a sheet tab.
Add Sheet Rows
Append rows to a sheet tab. Each row is an object keyed by column ID. Example: [{"A": "Widget", "B": 9.99}].
Add Sheet Tab
Add a new tab to a sheet. Auto-generates the name if not provided.
Add Slide
Add a new slide to an existing presentation. Provide the slide as a JSON object with layout, background, and elements. Each element has a type (text, image, shape, table, video, group), position (x, y), size (w, h), and type-specific properties. IMPORTANT: Create SEPARATE text elements for each visual block (title, each bullet point, each paragraph). Do NOT put multiple lines or bullet points in a single text element — create one element per line with proper positioning. Use bullet character '•' instead of markdown '*' or '-'. Set fontSize and fontWeight per element for visual hierarchy. If the user is currently viewing a presentation, use the presentation ID from the page context.
Add Task Attachment
Attach a Drive file to a task. Idempotent — re-attaching the same file returns the existing row. Attaching makes the file readable by everyone who can read the task, so a file you do not own needs the share right on it (403 `file_attach_requires_share` when you can only view it).
Add Team Member
Add a user to a team with an optional role (admin or member). Only team admins or workspace admins can add members. Default role is 'member'. Use this when the user asks to add someone to a team or distribution list.
Admin Integration Delete
disconnect an integration
Admin Integrations List
list all integrations for workspace
Admin Integrations Slack Channels
list Slack channels via bot token
Admin Integration Update
update integration config
Admin Invite Delete
Revoke (cancel) a pending invite. Pending only — an accepted or expired invite is refused `409 invite_not_pending`; its row is history, not a live grant.
Admin Invite Resend
Resend invite email + refresh expiry. The email carries a freshly minted link, so every link sent before for this invite stops working. Pending invites only — an accepted or expired invite is refused `409 invite_not_pending`.
Admin Invites List
List pending, accepted, and expired workspace invites, pending first and then newest. Paginated; `pending_total` counts invites awaiting acceptance. Each row also carries `delivery` — what the provider said about the latest send of that invite email, so a bounced invite is distinguishable from an ignored one.
Admin Mail Suppression Create
manually add a suppression
Admin Mail Suppression Delete
remove a suppression
Admin Mail Suppressions List
list suppressed addresses
Admin Notification Defaults Get
Read workspace-default email notification prefs. Returns sensible defaults (all enabled) when never configured.
Admin Notification Defaults Update
Partially update workspace-default email notification prefs. Emits settings.updated audit event.
Admin Usage Export
Export usage stats as CSV
Admin Usage Timeseries
Daily creation counts (last 14 days, split into "last 7" + "prior 7" windows) for the four hero metrics on the Overview tab. Returns `{users, documents, messages, emails}` each with `{buckets[7], total, previous_total}` so the UI can draw a sparkline + render a 7...
Admin User Get
Get one workspace user's full admin record by id.
Admin User Reset Password
Create and email a one-hour password-reset link. On delivery failure, returns `sent: false` with `reset_url`.
Admin User Suspend
Suspend a user account. Suspended accounts return 403 on all API calls.
Admin User Unsuspend
Unsuspend a user account. Restores access to all API calls.
Admin Workspace Logo Delete
Remove workspace logo (admin only)
Analytics Annotations List
List a project's annotations, oldest date first: each is a date, an optional end date, a short text and its author, drawn on every time-series chart in the project. `from`/`to` keep only annotations overlapping that range.
Analytics Catalog Overrides List
List catalog metadata overrides for the workspace.
Analytics Catalog Stats
Per-event last_seen_at and 30-day volume for the workspace's tracked events.
Analytics Cohorts Get
Read a saved cohort's name, stored criteria and member-count snapshot by ID, without recomputing its audience. Use analytics_cohorts_list to find cohort IDs. Requires a role on the report's project; `404` otherwise.
Analytics Cohorts List
List saved cohort reports in the active workspace, including their definitions and stored member counts. Lists one Analytics project (`project_id`) and requires a role on it.
Analytics Dashboards Get
Read a saved analytics dashboard's name, stored query and tile layout by ID. Requires a role on the dashboard's project; unavailable dashboards return not found. Use analytics_dashboards_list to find accessible IDs. Requires a role on the report's project; `404` otherwise.
Analytics Dashboards List
List the saved analytics dashboards of one Analytics project (`project_id`), including their tile layouts. Everyone who can view the project sees every dashboard in it. Requires a role on the report's project; `404` otherwise.
Analytics Events Get
Read one Analytics evidence event owned by the caller's source workspace. Foreign and missing IDs return 404.
Analytics Events List
List source-owned Analytics evidence with bounded filters and stable pagination. Measured group IDs never grant access.
Analytics Funnels Get
Read a saved funnel report's name and stored conversion query definition by ID, without running the funnel. Use analytics_funnels_list to find report IDs. Requires a role on the report's project; `404` otherwise.
Analytics Funnels List
List saved funnel reports in the active workspace, including their names and conversion query definitions. Lists one Analytics project (`project_id`) and requires a role on it.
Analytics Insights Get
Read a saved insights report's name and stored query definition by ID, without executing the query. Use analytics_insights_list to find report IDs. Requires a role on the report's project; `404` otherwise.
Analytics Insights List
List saved insights reports in the active workspace, including their names and query definitions. Lists one Analytics project (`project_id`) and requires a role on it.
Analytics Metric Definitions List
List metric definitions visible in the named Analytics project, or its workspace default when omitted. management=true instead reads the workspace-wide admin catalog. Each definition includes its newest stored period.
Analytics Metrics Upsert
Upsert external metric rows (ad spend, cloud spend, incident minutes) keyed by metric, grain, period and dimensions. A row replaces the live value only when its observed_at is newer; an older observation is kept in the restatement history and reported as stale. Requires workspace admin rank and the analytics.write scope; the public write key is refused.
Analytics Metric Value
Read one number from a saved insight or funnel over a window: the value, the same metric over the window before it, a sparkline and a link to the report. Embedded metrics on canvas, in chips and in sheets read through this. Example: report=insights:<id>&from=today-28d&to=now.
Analytics Mv Metadata
Get materialized view name and last refresh time.
Analytics Projects Access Request Create
Ask the project's owners for access at viewer or editor. Must ask higher than the role held (`400 access_role_not_higher`); `409 access_request_open` while one is open; `404` for an unknown project.
Analytics Projects Access Request Current
Return whether the caller has an open access request for the project.
Analytics Projects Access Request Decide
Approve at viewer or editor, or decline, an open access request. Project owners only. Returns 409 once decided.
Analytics Projects Get
Read one Analytics project, its view and the caller's role. `404` when the caller holds no role on it.
Analytics Projects List
List the Analytics projects the caller holds a role on, each with its view and the caller's role. Workspace admins hold no implicit role: a private project an admin was not added to is not listed.
Analytics Projects Permissions List
List the project's members: users and teams with their roles. The Everyone team row is the workspace tier.
Analytics Query Execute
Execute an ad-hoc analytics query (events/insights/funnel/retention/cohort). Returns structured results over the project's view (the workspace default project when project_id is omitted).
Analytics Restricted Marks List
List the workspace's restricted event names, trait keys and metric keys. Workspace admin only.
Analytics Retentions Get
Read a saved retention report's name and stored query definition by ID, without computing retention. Use analytics_retentions_list to find report IDs. Requires a role on the report's project; `404` otherwise.
Analytics Retentions List
List saved retention reports in the active workspace, including their names and query definitions. Lists one Analytics project (`project_id`) and requires a role on it.
Analytics Settings Get
Get the workspace's analytics settings — the timezone calendar windows such as today-7d and day/week/month buckets resolve in.
Analytics Users Aggregates
List analytics user profiles from the materialized view (faster at high volume, nightly refresh). Falls back to direct read when MV is unavailable.
Analytics Users List
List analytics user profiles (paginated, searchable). Returns traits, first_seen, last_identified.
Analytics User Timeline
Get a user's event timeline with session grouping (30-min inactivity split). Walks the alias graph (depth 5) to include all prior identities.
Analytics Write Key List
List all writeKeys for the workspace (plaintext never returned on list).
Append Sheet Values
Append rows of values to a sheet at the first empty row in a range. The server finds the insertion point — no need to read the last row first. Uses OVERWRITE semantics (does not shift existing data).
Apply Deal Template
Create a new deal from a saved deal template. The template provides default pipeline, stage, amount, probability, and line items. Use this when starting a deal that matches a known pattern (e.g., 'Standard Enterprise Plan').
Apply Master To Slide
Link a master slide to a specific slide by 0-based index. The slide stores a by-reference link, retains its existing elements as child-owned content, and clears prior master-element override markers. Current master elements inherit at render time and future master edits flow through automatically.
Apply Task Template
Create a new task by applying a template's defaults. The template pre-fills status, priority, estimate, assignee, description, and labels. Override any field by passing it explicitly. Title is always required.
Apply Transition To All
Apply a slide transition to every slide in the deck. Set transition.type to 'none' to clear transitions on all slides. Prefer duration_s (float seconds, 0.1–10); legacy speed presets map to slow=1.0s, medium=0.5s, fast=0.3s.
Archive Mail Thread
Archive every inbox-folder message in a thread
Asset Get Content
An image inside a doc, sheet, slide deck, canvas board, wiki page or task description is an asset of that container, not a Drive file: it never appears in Drive, and it is readable exactly when its container is. Returns the image bytes when the caller can read the container — through the document's role, the wiki page's role or the task's access check, collaborators in other workspaces included. Bytes are proxied, never redirected, with `Cache-Control: no-store`; an active type such as SVG is served as a download. Every miss is the same 404.
Assign Role
Assign a role to a user. Requires admin role.
Auth Whoami
Return the current authenticated user's profile (works with both JWT and API-key auth), including active workspace name + ID and agent kind + manager when applicable. needs_workspace_setup: true indicates the account has no workspace yet.
Automations Enqueue
Queue an enabled automation for background execution. Send a JSON object with an optional payload object containing the trigger data. Returns 202 Accepted with run_id, status and status_url; the Location response header points to GET /api/automations/runs/{run_id}. Poll with the same credential until success, failed, filtered, cancelled or depth_exceeded. The durable scheduler resumes queued work. Dry runs use /api/automations/{id}/test instead; _test_mode is rejected on this endpoint.
Batch Archive Emails
Archive multiple emails in one atomic call. Moves all specified messages to the archive folder. Use this when the user wants to bulk-archive many emails (e.g., inbox-zero cleanup, archiving all messages from a sender).
Batch Clear Sheet Values
Clear all cell values in multiple ranges atomically. Sets cells to null without removing rows or columns. Useful for resetting template sheets or clearing data regions.
Batch File Permissions
Batch-fetch permissions for up to 50 files by ID. Returns a map of file_id → permissions array.
Batch Get Contacts
Fetch multiple CRM contacts by their IDs in a single request (max 100). Missing or inaccessible IDs are silently omitted from the result.
Batch Get Deals
Fetch multiple CRM deals by their IDs in a single request (max 100). Missing or inaccessible IDs are silently omitted from the result.
Batch Get Files
Batch-fetch up to 50 files by ID. Powers drive:// embed hydration in Chat/Docs/Wiki/CRM.
Batch Get Sheet Values
Fetch multiple disjoint ranges from a spreadsheet in a single request. Avoids N sequential round-trips when reading KPIs from different regions.
Batch Modify Emails
Batch modify multiple emails in one atomic call. Can star/unstar, mark read/unread, add/remove labels, and change folder — all at once for up to 500 messages. Use this when the user wants to bulk-update many emails (e.g., star all from a sender, mark a batch as read, apply labels to multiple messages).
Batch Trash Emails
Trash multiple emails in one atomic call. Moves all specified messages to the trash folder. Use this when the user wants to bulk-trash many emails (e.g., spam cleanup, clearing a project mailbox).
Block Sender
Block a sender (address or domain).
Book Event Resources
Book one or more resources (rooms, equipment) for an existing event. Returns a conflict error if a resource is already booked.
Browse Public Channels
Browse the workspace's public channels, including the ones the caller has not joined, each with a `joined` flag and member count. `list_channels` returns memberships only, so this is the only way to discover a public channel you are not in and get the id `chat_channel_join` needs. Private channels and DMs are never listed. Use this when the user asks what channels exist, or asks to join a channel by name.
Bulk Archive Tasks
Archive up to 100 tasks at once. Only archives tasks the caller created or is assigned to.
Bulk Copy Files
Copy multiple files to a folder (max 100). The destination needs editor access (contributor in a shared drive); a folder the caller cannot see answers 404 like one that does not exist, and a visible one they cannot write to answers 403. A copy into a shared-drive folder belongs to that drive.
Bulk Delete Contacts
Delete many CRM contacts in a single operation. Returns counts of deleted/skipped/failed items.
Bulk Delete Deals
Delete many CRM deals at once by their ids.
Bulk Delete Messages
Soft-delete up to 100 messages in a channel. Deletes only the IDs the caller may delete (own messages, or any message when the caller is a channel admin); every other ID returns in `rejected`. Emits one bulk `message.deleted` event, never one per message.
Bulk Delete Tasks
Soft-delete multiple tasks at once by ID. Only deletes tasks the current user created. Max 100 task IDs per call. Subtasks cascade. Use `restore_task` to recover individually.
Bulk Export Contacts
Export selected contacts as CSV or vCard. CSV includes core fields and custom properties; vCard preserves imported RFC 6350 properties and parameters.
Bulk Export Deals
Export selected deals as CSV
Bulk Move Files
Move multiple files to a folder (max 100). The destination needs editor access (contributor in a shared drive); a folder the caller cannot see answers 404 like one that does not exist, and a visible one they cannot write to answers 403. Per-file failures come back in `errors`: "File not found" for a file the caller cannot view, "Forbidden" for one they can view but not edit. An item whose sharing is restricted (editors can't share, on it or a folder above it) moves only with its owner.
Bulk Update Contacts
Update many CRM contacts in a single operation. Useful for re-assigning ownership, updating lifecycle stage on a list of contacts, or reclassifying industry. Provide an array of contact IDs and the fields to apply to all of them.
Bulk Update Deals
Update many CRM deals in a single operation. Useful for moving multiple deals to a new stage, reassigning ownership, or marking a batch of deals as won/lost. Provide an array of deal IDs and the fields to apply.
Bulk Update Tasks
Update multiple tasks at once by ID. Only updates tasks the current user has access to (creator or assignee). Max 200 task IDs per call. Omit fields you do not want to change. Pass `null` to clear a nullable field (assignee_id, project_id, due_date, goal_id, task_status_id).
Calendar Conflicts
Detect attendee scheduling conflicts.
Community feedback
Sign in with your B-Bot account to like or review.
Reviews
No reviews yet. Be the first to leave feedback.