#MCP Tools — Using ambientChat with Claude Desktop

Your AI context doesn't have to stay trapped inside one app. With MCP (Model Context Protocol), you can bring your entire ambientChat world into Claude Desktop, brand apps, or any compatible AI client — and it works exactly like having a very well-informed research assistant sitting at your desk.

All tools respect your authentication. The AI can only access your data, using your credentials. Nobody else's stuff, ever.

---

#Inventory Tools

Manage your physical items — everything you've scanned, photographed, or manually added.

Tool	What It Does
list_items	List all items, optionally filtered by category, folder, or search query
get_item	Get full details of a specific item — name, brand, price, expiry, location, notes, nutritional data
search_items	Semantic search — finds items by meaning, not just keywords ("things in my garage", "snacks for the party")
list_expiring_items	Find items expiring within a number of days (default 14), soonest first. Set include_expired to also see items already past their date; limit sets the page size (default 200) and truncated flags when more match
get_items_at_scene	List items last seen at a specific physical location — identified by beacon, GLN, or scene ID
get_scan_session_items	List items created together in the same scan session (scan siblings)
update_item	Edit any item field — name, brand, category, price, expiry date, notes
set_item_location	Set where an item IS — pick one of your zones or type a place. Say "the kayak is in the garage"
update_items_by_filter	Bulk-update fields across many items in one call. Say "change all items in the kitchen to category Food"
trash_item	Move a single item to trash (soft delete). Cleans up linked documents
trash_items	Bulk move multiple items to trash at once
restore_item	Restore an item from trash back to the inventory
regenerate_item_image	Generate a fresh AI illustration for an item. Costs credits

Example things you can say:

• "What's in my pantry?"
• "Show me everything expiring this week."
• "Change the category of all my vitamins to Health."
• "How much is my electronics collection worth?"
• "What was scanned with the olive oil?" (scan siblings)
• "What did I leave in the garage?" (items at scene)

---

#Document Tools

Navigate, search, and manage your digital paperwork — receipts, manuals, photos, and files.

Tool	What It Does
list_documents	List documents with optional filters for media type, category, and folder
get_document	Get full document details — AI summary, linked items, metadata
search_documents	Keyword search across document titles, summaries, and content
search_documents_semantic	AI-powered semantic search — finds documents by meaning, returns full content
update_document	Update a document's title, description, and/or tags. Improves search and accessibility
upload_document	Upload a new document (image or PDF) into a folder for AI processing. Provide the bytes one of three ways: a Firebase Storage URL, a get_document_upload_url storage path, or inline base64 (max 10MB)
get_document_upload_url	Get a short-lived signed URL for uploading document bytes directly to storage, then hand the returned path to upload_document. This is how an AI client that holds a file (e.g. one with a code-execution sandbox) gets it into a folder without inlining the bytes
get_scan_status	Check the status of an upload/scan job by its jobId (returned by upload_document). Tells you whether it's still processing, complete (with the created document/item), or failed (with the reason) — so you don't have to keep refreshing the folder
move_document	Move a document between folders
link_document_to_item	Attach a document you already have to one of your inventory items — the manual, warranty, receipt, or spec sheet that belongs with a thing you own
unlink_document_from_item	Detach a document from an item. Removes only the link; both records stay
add_document_pages	Add the photos you attached to this message as extra pages of an image document — how a photographed multi-page manual becomes ONE document instead of a pile of photos
combine_documents	Gather several photo documents into ONE multi-page document — the fix for a manual uploaded page by page. The first keeps its identity; the rest become its pages and go to Trash
remove_document_page	Remove one page from a multi-page document by its number
get_item_documents	List the paperwork attached to an item — its manual, warranty, receipt, or the scan photo it came from
trash_document	Move a document to trash (soft delete). Cleans up linked inventory items
restore_document	Restore a document from trash
regenerate_document_image	Generate an AI illustration thumbnail for a document. Costs credits
generate_image	Create an image from a text description — optionally grounded in your own photos. Say "draw my armchair in a jungle" and the armchair's actual photo is shown to the generator so the result looks like your armchair, not a generic one; "me as an astronaut" uses your profile photo. The per-image price is checked against your balance before generating, only delivered images are charged, and the result is saved into your context as an image document — with a recipe showing exactly what went into the prompt (and whether each reference was matched from its photo or just described) and a scorecard grading the image against your brief. Say "dual" or "show me both" to run the same brief on Gemini AND OpenAI side by side and pick your favorite. Ask for "widescreen" (3:2) or "phone wallpaper" (9:16) shapes, and say "final quality" for the premium render (paid plans). Prefer knobs over words? Open Image Studio — the ✦ button in chat, or the sidebar on web — for a full composer with model, quality, and shape controls plus live pricing. To build on something you already have, add it as a reference from My Stuff inside the composer
resolve_dual	After a Dual image run, record your verdict: pick a winner (the other image moves to Trash, recoverable) or keep both — no extra charge either way. Works by voice too: "keep the Gemini one", "keep both"

Example things you can say:

• "Make me an image of my armchair reupholstered in mustard."
• "Generate a picture of a lighthouse at dusk and save it to my Ideas folder."
• "Find my Costco receipts from January."
• "Show me all my warranty documents."
• "Move the washing machine manual to the Appliances folder."
• "What receipts do I have for tax deductions?"
• "Save these photos into my Medical folder." (uploads the attached images for processing)
• "That PDF is the manual for my cordless drill — file it against that item."
• "Add these three photos as pages of the drill manual."
• "Read page 11 of the manual and tell me the torque setting."
• "Those three photos are all the same manual — combine them into one document."
• "Do I have the warranty for the dishwasher?"
• "Detach that receipt from the lawnmower, it belongs to the hedge trimmer."
• "Did that upload finish?" (checks the upload job's status)

---

#Views (Folders)

Organize your items and documents into folders and views.

Tool	What It Does
list_views	List folders at a given level of the hierarchy
get_view	Get folder details and its first 20 documents
get_view_tree	See the entire folder hierarchy at a glance, with item, document, and subfolder counts
get_view_members	Get the union of items and documents in a folder
create_view	Create a new folder. Idempotent — won't create duplicates
update_view	Rename a folder, change its description, sort order, or thumbnail mode
reorder_views	Batch update the sort order for multiple folders
generate_view_icon	Generate an AI icon for a folder based on its name and contents. Costs credits
add_items_to_view	Tag items with a folder — adds them without removing prior folder memberships
move_items_to_view	Move items to a single destination folder
remove_items_from_view	Remove items from a folder
navigate_up	Navigate to the parent folder

Example things you can say:

• "Create a folder called Holiday Gifts."
• "Move all the spices into the Spice Rack folder."
• "How many items are in each folder?"
• "Generate an icon for the Kitchen folder."

---

#Markdown Documents

Create, edit, and search your own written documents — notes, lists, reports, and more.

Tool	What It Does
create_markdown_document	Create a new markdown document with optional YAML frontmatter and folder placement
update_text_document	Replace the contents of any TEXT document — note, .txt, .csv, .tsv. Send the complete new text, not a patch. Read it with get_document({include_source: true}) and edit source_text — not raw_text, which for a spreadsheet is a searchable summary rather than the file. A spreadsheet that doesn't parse is refused, not saved
undo_text_update	Step a text document one state back. For a spreadsheet this restores the previous file, byte for byte
redo_text_update	Step one state forward, undoing an undo
get_markdown_document	Retrieve a document's full content, parsed frontmatter, table of contents, and version info
list_markdown_documents	List markdown documents, optionally filtered by folder, type, or tags
search_markdown_content	Semantic + keyword search across markdown document content
read_document_rows	Read a window of rows from a stored spreadsheet (.csv, .tsv, or Excel .xlsx) — pages through a large file the document text only partly shows. For a workbook it reads one sheet at a time, names the sheet it read, and lists the others
propose_import_mapping	Work out what each column of a stored spreadsheet means before importing it, and recall the mapping you approved for that file layout last time
create_items_bulk	Turn mapped spreadsheet rows into inventory items as ONE reversible operation — duplicates skipped, "undo that" removes the whole import
create_data_file	Generate a file from content and save it to your library with a download link — Excel .xlsx, Word .docx, PowerPoint .pptx, or a plain .csv

Example things you can say:

• "Create a packing list for my Hawaii trip."
• "Make a spreadsheet of everything expiring this month." → create_data_file
• "Give me a CSV of my inventory I can import elsewhere." → create_data_file
• "How many rows are in that spreadsheet, and what's in row 500?" → read_document_rows
• "Add everything in that spreadsheet to my inventory." → propose_import_mapping then create_items_bulk
• "What sheets are in that workbook? Read the Q2 one." → read_document_rows (it reports every sheet, and takes a sheet by name or number)
• "Write a summary of what I bought this month."
• "Update the recipes section of my meal plan."
• "Find my notes about home insurance."

---

#Skills

Skills are reusable SKILL.md playbooks that orchestrate your inventory, documents, tags, location, and beacons. The first-party set — curated by ambientChat — is available to everyone (read-only), and you can author your own on any Standard-or-higher plan. The same skills work in Claude and ChatGPT when you connect ambientChat there.

Tool	What It Does
list_skills	List the skills available to you — first-party plus your own — with name, slug, and description
get_skill	Load a skill's full instructions (SKILL.md) by slug, ready to follow
create_skill	Save a new skill of your own — name, slug, when-to-use description, and markdown instructions (Standard+)
update_skill	Edit one of your own skills — its instructions, name, description, or tags. First-party skills stay read-only; creating your own with the same slug overrides them for you

Example things you can say:

• "What skills can you run?"
• "Use the Auto-Filer skill on this document."
• "Run Renewals & Warranty Watch."
• "Save what we just did as a skill called Weekly Fridge Audit."
• "Update my trip-packer skill to always include chargers."

---

#Conversations & History

Your Q&A history — every question you've asked and answer you've received.

Tool	What It Does
journal_conversation	Save a Q&A exchange to your history for searchable recall
recall_history	Search your prior conversations — past Q&A, advice given, topics discussed. Filters by channel (voice/text/mcp), platform, session, or date range
list_conversations	Browse your full Q&A history in date order, with paging. Use for "show my recent conversations"; use recall_history to find a specific topic
trash_conversation	Move a conversation to trash (soft delete)
trash_conversations	Bulk move multiple conversations to trash
restore_conversation	Restore a conversation from trash

Example things you can say:

• "What did we talk about last week?"
• "Recall the recipe advice you gave me yesterday."
• "What questions have I asked about insurance?"
• "Delete all conversations from March."

---

#Change History & Undo

Review and revert recent changes to your inventory. Every edit is tracked and reversible.

Tool	What It Does
recent_item_changes	See recent edits to inventory items — shows old and new values for each change
undo_item_change	Revert a single-item edit by re-applying the old values
recent_bulk_changes	List recent bulk inventory operations — useful after a mass update
undo_bulk_change	Revert an entire bulk update in one call — every item the operation touched goes back

Example things you can say:

• "What did you just change?"
• "Undo that last edit."
• "Show me the recent bulk changes."
• "Revert the bulk update you made to my kitchen items."

How undo works: Every change is logged with before/after values. You can undo individual edits or entire bulk operations. Undo is available from any surface — in-app chat, voice, Claude Desktop, or the web interface.

---

#Sharing

Share your items, documents, conversations, and folders — with a person by email or with a whole group — and manage what others have shared with you. See the Sharing guide for the full walkthrough.

Share something out:

Tool	What It Does
share_with_email	Grant a person live access to an item, document, folder, or conversation by email — read-only or read-write. Sends an invitation if they have no account yet
share_with_group	Share something with an entire group at once
share_item	Share an inventory item
share_document	Share a document — includes title, type, and summary
share_conversation	Share a Q&A answer
share_view	Share a folder — cascades to its sub-folders and contents
list_my_shares	See everything you've shared and with whom
revoke_share_grant	Remove a share — access ends immediately
resend_invitation	Re-send a pending invitation to someone who hasn't signed up yet

Groups:

Tool	What It Does
create_group	Create a group to share with several people at once
invite_to_group	Invite a person to a group by email
accept_group_invitation	Accept an invitation to join a group
list_my_groups	List the groups you belong to
get_group_members	See who's in a group
remove_group_member	Remove a member — ends their access to the group's shares
delete_group	Delete a group

Shared with you (and mounting):

Tool	What It Does
list_shared_with_me	See what others have shared with you
get_shared_resource	Open a specific resource someone shared with you
list_shared_folder_contents	List the contents of a shared folder
hide_shared_with_me	Remove a share from your list (hides it for you only; owner's copy is untouched)
mount_shared_resource	Add something shared with you (or with Everyone) into your own library, so it sits inline alongside your own content — like "Add to My Drive". The master stays with its owner, so you always see their latest version
unmount_shared_resource	Remove a mounted shared resource from your library (reversible; doesn't delete the owner's content or revoke your access)
list_mounts	List the shared resources you've added to your library
list_mounted_contents	Resolve the shared resources you've mounted into a folder into their live data + provenance, so they show inline alongside your own content

Example things you can say:

• "Share the olive oil with my wife, read-only."
• "Share my Recipes folder with the family group."
• "Who have I shared the Warranties folder with?"
• "Stop sharing that receipt with the repair shop."
• "Add the shared Skills to my library."

---

#Connected Services

Connect outside tools (GitHub, Gmail, Calendar, Drive, Slack, Linear, Mercury, or any MCP server by URL) so the assistant can use them in chat alongside your own context. See the Connected Services guide.

Tool	What It Does
list_mcp_servers	List the services you've connected, with status and tool counts
add_mcp_server	Connect a new MCP server by URL — OAuth handled where the provider supports it
update_mcp_server	Edit a connection's settings or stored token
remove_mcp_server	Disconnect a service — its tools leave chat and its access is revoked

Example things you can say:

• "What services do I have connected?"
• "Connect my GitHub."
• "Match my Mercury transactions to the receipts in my library."
• "Disconnect Slack."

(Connecting outside tools into ambientChat is the opposite of Context Sharing — the get_context_sharing tool and the context_sharing setting below, which control what ambientChat shares out to Claude, brands, and partners.)

---

#Tool Permissions

Control what the assistant can do without asking — Anthropic-style per-tool cards. Every tool is Auto (runs automatically), Ask (approval prompt first), or Blocked (never runs). Writes to connected services ask by default; when a prompt appears you can tap Always Allow to stop being asked for that tool. Manage everything under Settings → MCP Servers → Tool Permissions (iOS and web). Safety tools like emptying trash or deleting your account always ask and can't be changed.

Tool	What It Does
list_tool_permissions	List every tool — built-in and from connected services — with its approval status
update_tool_permission	Change a tool's policy to approved, ask, or blocked (asks you to confirm the change)

Example things you can say:

• "Which tools need my approval?"
• "Stop asking me about Linear writes."
• "Block web search."
• "Make save_issue ask again."

---

#Trash & Restore

Manage your trash across all content types.

Tool	What It Does
list_trash	See everything currently in the trash, ordered by most recently trashed
restore_trash	Generic restore — works for items, documents, and conversations without needing to know the type
empty_trash	Permanently delete trash entries. Optional scope: "item", "document", or "all"

Example things you can say:

• "What's in my trash?"
• "Restore the last thing I deleted."
• "Empty the trash."

---

#Search & Discovery

Cross-cutting tools for finding information and getting answers.

Tool	What It Does
web_search	Search the web for current information — used when you need real-time data, recent events, or fact verification
query_expert	Ask another AI model for a second opinion mid-conversation. Useful for comparing perspectives
get_user_context	Assembles relevant context for your query — bio, nearby beacons, focus item details
link_beacon	Adds one of your inventory items or documents to a registry beacon/tag's linked things (up to 8 per beacon; kind none clears them all), so their curated details flow into AI context on sighting (staff operation). Try: “link the lobby beacon to the Rodin sculpture”

Example things you can say:

• "What's the current price of a KitchenAid mixer?" (triggers web search)
• "Ask Gemini what it thinks about this recipe." (query expert)
• "What do you know about me?" (user context)

---

#Settings & Profile

Read and update your profile and app settings — all manageable via voice or chat.

#Profile

Tool	What It Does
get_profile	Get your profile — name, nickname, email, photo, timezone, home/work locations, and bio
update_user_setting (key profile)	Update profile fields — first name, last name, nickname, hail name, home/work location, and bio
upload_profile_image	Upload a new profile photo from image data
reimagine_profile_image	Re-render your profile photo as a claymation figurine portrait

#Identity & Roles

Tool	What It Does
get_identity	Who you are and what you can do — your uid, email, role (superuser / brand-admin / brand-user / enduser), and whether you're a superuser
set_user_role	(Superuser only) Grant or change a user's role by uid or email — audited; writes both the auth claim and the profile mirror so they stay in sync

#Interests ("How I Roll")

Tool	What It Does
list_interests	List your interests / "how I roll" tags — free-text preferences that personalize AI responses
add_interest	Add an interest tag (e.g. "vegetarian", "loves hiking")
remove_interest	Remove an interest by id

#AI & Scanning

Tool	What It Does
get_ai_model_pref	Get your default AI model preference
update_user_setting (key ai_model)	Set your default AI model — validated against the model registry
get_ble_scan_rate	Get your Bluetooth tag scan rate: off, eco, normal, or turbo
update_user_setting (key ble_scanning)	Set your Bluetooth scan rate

#App Behavior

Tool	What It Does
get_app_behavior_prefs	Get app-behavior preferences — haptic feedback, sounds, keep source photos
update_user_setting (key app_behavior)	Update haptic feedback, feedback sounds, or the "keep source photos" toggle
get_background_trails_pref	Get your background location trails master switch state
update_user_setting (key background_trails)	Toggle background location trails on or off

#Save Destinations

Tool	What It Does
get_save_preferences	Get your sticky save-destination — the folder new scans/items default into
update_user_setting (key save_destinations)	Set or clear your default save folder

#Notifications & Context Sharing

Tool	What It Does
get_notification_preferences	Get beacon-category notification preferences — which categories are disabled
update_user_setting (key notifications)	Toggle notifications for a single beacon category, or bulk enable/disable all
get_venue_invitation_settings	Read the venue-invitation settings: the master switch plus the venues you've told "don't show this invitation again" — synced to your account
update_user_setting (key venue_invitations)	Turn all venue invitations on/off, or opt out of (and back into) one venue's tour invitation — every change reaches every device
get_context_sharing	Get third-party context-sharing preferences — master switch + per-service toggles
update_user_setting (key context_sharing)	Toggle context sharing for Claude Desktop, McCormick, Amazon, etc.

#Account Management

Tool	What It Does
get_account_deletion_precheck	Pre-flight check — shows data counts, subscription status, and warnings
request_account_deletion	Request account deletion. Creates a confirmation with 5-minute expiry

Example things you can say:

• "Switch my default AI to Claude."
• "Turn off haptic feedback."
• "Set my scan rate to turbo."
• "Turn off location trails."
• "Stop sharing context with Amazon."
• "Give me a claymation profile picture."

---

#Privacy

Control how your ambient data (location, beacons) is shared with AI calls.

Tool	What It Does
get_privacy_preferences	Get your ambient-data privacy preferences — location precision per AI call type
update_user_setting (key privacy)	Update location precision settings for different AI call types

Example things you can say:

• "What are my privacy settings?"
• "Don't share my exact location with AI — use city-level only."

---

#Voice Preferences

Control how the assistant speaks to you.

Tool	What It Does
get_voice_preferences	Get your voice/TTS settings — voice name, style, auto-speak, playback speed
update_user_setting (key voice)	Update voice name, style, auto-speak toggle, or playback speed

Example things you can say:

• "Switch to the Shimmer voice."
• "Speed up your speech."
• "Stop auto-speaking responses."
• "What voice are you using?"

---

#Settings Catalog

Browse all available settings and their current values.

Tool	What It Does
list_user_settings	Read every settings domain you have in a single structured payload
list_setting_dimensions	Read the catalog of settings the AI can manage on your behalf — each names the setting_key for updates
update_user_setting	Change ANY setting: pass the domain's setting_key plus the fields to change — one write tool for every settings domain

Example things you can say:

• "Show me all my settings."
• "What settings can you change for me?"
• "Set my scan rate to eco." (one update_user_setting call — same for any setting)

---

#Subscription & Usage

Check your plan, credit balance, and usage history.

Tool	What It Does
get_subscription	Get your subscription summary — tier, period dates, credits used/remaining, exemption status
get_usage_state	Get current usage and billing summary — tier, credits, exemption status
get_billing_events	Get itemized billing history — individual AI requests with credits consumed, model used, and token counts

Example things you can say:

• "How many credits do I have left?"
• "What plan am I on?"
• "Show me my usage this month."
• "What's my most expensive AI request?"

---

#Export & Import

Move your data in and out of ambientChat.

Tool	What It Does
print_resource	Print an item, document, or saved answer — renders the branded PDF and (in the ambientChat app) opens the print dialog automatically
export_user_data	Start an export of all your data as a ZIP archive — inventory, documents, conversations, preferences, settings, profile
get_export_status	Check if your export is ready and get the download URL
get_import_upload_url	Get a secure upload URL for importing data
import_user_data	Import data from an uploaded archive — preserves original IDs and reconciles links

Example things you can say:

• "Print this document."
• "Print my coffee maker."
• "Export all my data as a ZIP."
• "Is my export ready?"
• "Import data from the file I uploaded."

---

#Onboarding & Help

Get started and find help.

Tool	What It Does
get_ambientchat_welcome	Get your personalized welcome card — tiles, greeting, suggested prompts, and next best action
get_help	Search the help documentation (Don't Panic guides) for answers to your question
get_onboarding_state	Read your onboarding progress — tier, engagement metrics, dismissed tiles, activation status
update_onboarding_state	Update onboarding preferences — turn the welcome card off (stop_showing) or back on (resume_showing), dismiss tiles, restore dismissed items, reset
record_onboarding_event	Record onboarding analytics events (used internally for A/B analysis)

Example things you can say:

• "How do I scan a receipt?"
• "Show me the getting started guide."
• "Dismiss the welcome card."

---

#User Stats

Tool	What It Does
get_user_stats	Get counts of your content — active and trashed inventory items, documents, folders, and conversations

Example things you can say:

• "How many items do I have?"
• "Give me an overview of my account."

---

#Confirmation Tools

Safety gates for irreversible actions. Some operations create a pending confirmation that you must approve within a short time window.

Tool	What It Does
list_pending_confirmations	See actions awaiting your approval
confirm_action	Approve a pending action
deny_action	Reject a pending action

Tools that require confirmation: request_account_deletion Tools that require failsafe confirmation: empty_trash

---

#Scan Regression Tools (Developer Only)

These tools are restricted to superusers for internal quality testing.

Tool	What It Does
get_scan_regression_runs	List recent scan-regression harness runs with summary metrics
get_scan_regression_run	Fetch one scan-regression run with full per-fixture detail
run_scan_regression	Trigger a scan-regression run against deployed code
get_scan_regression_request	Check the status of a previously created scan-regression request

---

#How to Connect

#The MCP Server URL

https://mcp.ambientchat.ai

That's the address. Point any MCP-compatible client at it, sign in with your ambientChat credentials, and the tools above become available.

#Via Claude Desktop (MCP)

1. Open Claude Desktop settings
2. Navigate to the MCP Servers configuration
3. Add a new MCP server with the URL https://mcp.ambientchat.ai
4. Authenticate with your ambientChat credentials
5. Claude Desktop will discover all available tools automatically

#Using Tools in Conversation

Once connected, you don't need to call tools by name. Just ask natural questions and the AI uses the appropriate tools:

• "What food is expiring this week?" → list_expiring_items
• "Find my Costco receipts from January." → search_documents
• "How much is my electronics collection worth?" → search_items
• "Create a packing list for my Hawaii trip." → create_markdown_document
• "Change all items in the kitchen to category Food." → update_items_by_filter
• "Undo that last bulk change." → undo_bulk_change
• "Export all my data as CSV." → export_user_data
• "What did we talk about last week?" → recall_history
• "Share this recipe with my wife." → share_conversation

#Tips & Tricks

• Same context everywhere. MCP gives external clients the same context as in-app chat. The search quality, semantic matching, and data access are identical.
• Great for desktop workflows. Writing a report? Planning a meal? Doing insurance paperwork? Your full inventory and document archive is accessible without switching to your phone.
• Combine tools naturally. Search your inventory, then create a document summarizing what you found. The tools compose together — search, analyze, write, save — all in one conversation.
• Everything is undoable. Bulk changes, individual edits, trash operations — all reversible. Say "undo that" and the AI knows what you mean.
• Voice works too. Every tool listed here works identically via voice in the mobile app. Just say what you need.

#Known Limitations

• Requires a compatible MCP client. Claude Desktop is the primary supported client. The MCP server follows the standard protocol.
• Uploading images/files now works via MCP. Use upload_document with inline base64 (small files) or the get_document_upload_url → PUT → upload_document flow (any size). In claude.ai chat, dropping in a photo and saying "save this to my Medical folder" works when code execution is enabled — the assistant uploads the attached file for you. Live, on-device camera scanning still happens in the mobile app.
• Rate limits apply. MCP tool calls consume the same credits as in-app chat. Your subscription tier determines available credits.
• Real-time sync is not instant. If you scan something on your phone, it may take a few seconds before MCP tools see the new item.

#Version History

Version	Date	What Changed
28	2026-07-28	Spreadsheet → inventory import: propose_import_mapping reads the columns (remembering a layout you have approved before) and create_items_bulk creates the items as one operation you can undo in one go
29	2026-08-10	Text documents are editable: update_text_document replaces a note/.txt/.csv/.tsv, with undo_text_update / redo_text_update stepping the history — a spreadsheet undo restores the previous file exactly. Read the editable text with get_document({include_source: true})
30	2026-08-11	update_markdown_document, undo_markdown_update and redo_markdown_update are retired — markdown is a text document like any other, so update_text_document / undo_text_update / redo_text_update serve it too. The generic tool gained section updates (section_heading / append) so nothing was lost
33	2026-08-16	link_beacon ADDS a linked thing to a beacon (up to 8) instead of replacing what is there; kind none still clears them all
34	2026-08-20	Added get_venue_invitation_optouts / update_venue_invitation_optout — the per-venue "don't show this invitation again" choices, stored on your account so they survive reinstalls
36	2026-08-20	Settings writes converged on ONE tool: update_user_setting(key, value) replaces update_privacy_preferences, update_voice_preferences, update_notification_preferences, update_context_sharing, update_profile, update_save_preferences, update_background_trails_pref, update_app_behavior_prefs, update_ble_scan_rate, update_ai_model_pref, and update_venue_invitation_settings. Per-domain get_* read tools remain; list_setting_dimensions names each domain's setting_key
35	2026-08-20	Those two became get_venue_invitation_settings / update_venue_invitation_settings: one pair for the whole domain — the master switch moved into your account too, and un-muting a venue from anywhere (chat, web, phone) now reaches every device. Venue invitations also appear in list_user_settings / list_setting_dimensions
27	2026-07-28	Spreadsheets: read_document_rows pages through a stored .csv/.tsv/.xlsx (one sheet at a time for a workbook, naming the others), and create_office_document is now create_data_file — it also makes .csv
26	2026-07-27	Word-style Undo/Redo — undo_markdown_update steps BACK one change (repeat to keep going), redo_markdown_update steps forward. A new edit discards anything ahead
23	2026-07-26	Added undo_markdown_update — document edits are snapshotted and can be reverted with "undo that"
22	2026-07-18	Added Tool Permissions section (list_tool_permissions / update_tool_permission) — per-tool Auto / Ask / Blocked policy, "Always Allow" on approval prompts
14	2026-07-05	Rewrote Sharing for in-app live sharing + groups (share_with_email, share_with_group, group lifecycle, revoke_share_grant, list_shared_with_me, …); added Connected Services section (add/list/update/remove_mcp_server) (v0.13.2)
13	2026-06-26	Added list_mounted_contents — resolve mounted shares into live data + provenance for inline display (AMB-377)
12	2026-06-26	Added mount_shared_resource / unmount_shared_resource / list_mounts — add shared content into your own library (AMB-376)
11	2026-06-25	Added list_skills / get_skill — first-party SKILL.md skills, readable by everyone (AMB-350)
10	2026-06-07	Terminology: undo surfaces say "the web interface" not "admin console"
1	2026-03-01	Initial guide — 28 tools across 6 categories
2	2026-05-27	Complete rewrite — all 93 user-facing tools across 17 categories (AMB-188)
3	2026-05-28	Added the MCP server URL (https://mcp.ambientchat.ai); reverted title to v1 to keep the seed idempotent
4	2026-05-29	Added get_document_upload_url; upload_document now accepts base64 / signed-URL bytes so MCP clients can upload images into folders (AMB-281)
5	2026-05-28	Added list_conversations (browse Q&A history with paging) — AMB-104 MCP promotion
6	2026-05-29	Added get_save_preferences / update_save_preferences (sticky save folder) — AMB-104 MCP promotion
7	2026-05-29	Added list_interests / add_interest / remove_interest (How I Roll tags) — AMB-104 MCP promotion
8	2026-06-01	get_profile / update_profile now read & write bio (folded in from the legacy profile field, which was removed) — AMB-104
9	2026-06-01	Added get_scan_status — query an upload/scan job by jobId (processing / complete / failed) — AMB-287