# SMB > Small business data, valuations and private Workspaces, for people and the AI apps they use. ## Connect an AI app to SMB - Setup steps written for agents (start here): https://api.smb.co/agent-setup/prompt.md - MCP server: https://api.smb.co/mcp (remote, Streamable HTTP, standard MCP sign-in with OAuth). Never ask a person to paste a password, API key or token into a chat. - [Setup steps for every app](/docs/agent-setup): Gemini, ChatGPT, Claude, Codex, Cursor, GitHub Copilot and others, on one page. - If an app or account can't add MCP servers (for example, Gemini on a work Google account), tell the person plainly and give them the option the setup page lists for that case. Don't invent steps. ## One-click setup links Give the person the link for the app they're using. Each opens that app with SMB filled in; the person confirms, then signs in to SMB. - Claude (web and desktop): https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=SMB&connectorUrl=https%3A%2F%2Fapi.smb.co%2Fmcp - Claude Team or Enterprise Owner, for the whole organization: https://claude.ai/admin-settings/connectors?modal=add-custom-connector&connectorName=SMB&connectorUrl=https%3A%2F%2Fapi.smb.co%2Fmcp - Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=SMB&config=eyJ1cmwiOiJodHRwczovL2FwaS5zbWIuY28vbWNwIn0%3D - VS Code (GitHub Copilot): vscode:mcp/install?%7B%22name%22%3A%22smb%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.smb.co%2Fmcp%22%7D ## Apps without a one-click link - ChatGPT on the web: open https://chatgpt.com/plugins, choose + then Add custom MCP server, paste https://api.smb.co/mcp, keep OAuth, choose Create as a plugin, then install it and sign in. - Codex and the ChatGPT desktop app (one shared setup): run `codex mcp add smb --url https://api.smb.co/mcp`, then `codex mcp login smb`. - Claude Code: run `claude mcp add --transport http --scope user smb https://api.smb.co/mcp`, then type /mcp and sign in. - Gemini app, personal Google account: gemini.google.com, Settings, Connected Apps, Custom apps, Add a custom app, paste https://api.smb.co/mcp. Work or school account: [Gemini at work](/docs/agent-setup/gemini-work). - AI apps always use the MCP server. The [REST API](/docs/api-quickstart), with a workspace API key from SMB, is only for developers building their own software. - **Get started** - [Quick start](https://api.smb.co/llms.mdx/docs/content.md) - [API quickstart](https://api.smb.co/llms.mdx/docs/api-quickstart/content.md): Use your signed-in user token to make an authenticated SMB request. - [Business data](https://api.smb.co/llms.mdx/docs/business-data/content.md): The information SMB can return about a small business. - Agent setup / MCP - [Agent setup / MCP](https://api.smb.co/llms.mdx/docs/agent-setup/content.md): Connect SMB to the AI assistant you already use. - [Gemini](https://api.smb.co/llms.mdx/docs/agent-setup/gemini/content.md): Add SMB to the Gemini app on a personal Google account. - [Gemini at work](https://api.smb.co/llms.mdx/docs/agent-setup/gemini-work/content.md): Google doesn't let work or school accounts add apps like SMB to Gemini yet. Here's what works today. - [ChatGPT and Codex](https://api.smb.co/llms.mdx/docs/agent-setup/chatgpt/content.md): Add SMB to ChatGPT on the web, the ChatGPT desktop app, or Codex. - [Claude](https://api.smb.co/llms.mdx/docs/agent-setup/claude/content.md): Add SMB to the Claude app in one click, or to Claude Code with one command. - [Cursor](https://api.smb.co/llms.mdx/docs/agent-setup/cursor/content.md): Add SMB to Cursor in one click. - [GitHub Copilot in VS Code](https://api.smb.co/llms.mdx/docs/agent-setup/github-copilot/content.md): Add SMB to Copilot in VS Code in one click. - [Gemini CLI](https://api.smb.co/llms.mdx/docs/agent-setup/gemini-cli/content.md): Add SMB to Google's command-line agent with one command. - [Other MCP clients](https://api.smb.co/llms.mdx/docs/agent-setup/other-mcp-clients/content.md): Connect any compatible Streamable HTTP client to SMB. - **API Reference** - Businesses - [Businesses](https://api.smb.co/llms.mdx/docs/api-reference/businesses/content.md): Search, open, add, and update Businesses in SMB. - [Search Businesses](https://api.smb.co/llms.mdx/docs/api-reference/search_businesses/content.md) - [List Workspace Businesses](https://api.smb.co/llms.mdx/docs/api-reference/search_workspace_businesses/content.md) - [Get a Business](https://api.smb.co/llms.mdx/docs/api-reference/get_business/content.md) - [Add a Business](https://api.smb.co/llms.mdx/docs/api-reference/add_business/content.md) - [Update a Business](https://api.smb.co/llms.mdx/docs/api-reference/update_business/content.md) - Valuations - [Run a valuation](https://api.smb.co/llms.mdx/docs/api-reference/run_valuation/content.md) - [Save a Business valuation](https://api.smb.co/llms.mdx/docs/api-reference/create_valuation_intake/content.md) - [Answer valuation questions](https://api.smb.co/llms.mdx/docs/api-reference/refine_valuation/content.md) - [Claim a guest valuation](https://api.smb.co/llms.mdx/docs/api-reference/claim_valuation/content.md) - [Get a valuation](https://api.smb.co/llms.mdx/docs/api-reference/get_valuation/content.md) - [List Business valuations](https://api.smb.co/llms.mdx/docs/api-reference/get_valuations/content.md) - Workspaces - [Workspaces](https://api.smb.co/llms.mdx/docs/api-reference/workspaces/content.md): Confirm your current identity and open an available workspace. - [Get current access](https://api.smb.co/llms.mdx/docs/api-reference/get_current_identity/content.md) - [Get a Workspace](https://api.smb.co/llms.mdx/docs/api-reference/workspaces/get-workspace/content.md): Retrieve one workspace and the access available to you. - [Create a Workspace](https://api.smb.co/llms.mdx/docs/api-reference/workspaces/create-workspace/content.md): Create a team Workspace and become its owner. - [Archive Businesses, Lists and Files](https://api.smb.co/llms.mdx/docs/api-reference/archive/content.md) - [Restore Businesses, Lists and Files](https://api.smb.co/llms.mdx/docs/api-reference/restore/content.md) - Rooms - [List Rooms](https://api.smb.co/llms.mdx/docs/api-reference/list_rooms/content.md) - [Create a Room](https://api.smb.co/llms.mdx/docs/api-reference/create_room/content.md) - [Get a Room](https://api.smb.co/llms.mdx/docs/api-reference/get_room/content.md) - [Update a Room](https://api.smb.co/llms.mdx/docs/api-reference/update_room/content.md) - [Archive a Room](https://api.smb.co/llms.mdx/docs/api-reference/archive_room/content.md) - [Restore a Room](https://api.smb.co/llms.mdx/docs/api-reference/restore_room/content.md) - [Attach to a Room](https://api.smb.co/llms.mdx/docs/api-reference/attach_room_resource/content.md) - [Remove from a Room](https://api.smb.co/llms.mdx/docs/api-reference/detach_room_resource/content.md) - **Room Files** - [List Room Files](https://api.smb.co/llms.mdx/docs/api-reference/list_room_files/content.md) - [Get a Room File](https://api.smb.co/llms.mdx/docs/api-reference/get_room_file/content.md) - [Attach a Room File](https://api.smb.co/llms.mdx/docs/api-reference/attach_room_file/content.md) - [Archive a Room File](https://api.smb.co/llms.mdx/docs/api-reference/archive_room_file/content.md) - [Restore a Room File](https://api.smb.co/llms.mdx/docs/api-reference/restore_room_file/content.md) - [Download a Room File](https://api.smb.co/llms.mdx/docs/api-reference/download_room_file/content.md) - [Move a Room File](https://api.smb.co/llms.mdx/docs/api-reference/move_room_file/content.md) - [List Room file suggestions](https://api.smb.co/llms.mdx/docs/api-reference/list_room_file_suggestions/content.md) - [Accept a Room file suggestion](https://api.smb.co/llms.mdx/docs/api-reference/accept_room_file_suggestion/content.md) - [Dismiss a Room file suggestion](https://api.smb.co/llms.mdx/docs/api-reference/dismiss_room_file_suggestion/content.md) - **Folders** - [List Room folders](https://api.smb.co/llms.mdx/docs/api-reference/list_room_folders/content.md) - [Create a Room folder](https://api.smb.co/llms.mdx/docs/api-reference/create_room_folder/content.md) - [Update a Room folder](https://api.smb.co/llms.mdx/docs/api-reference/update_room_folder/content.md) - [Delete a Room folder](https://api.smb.co/llms.mdx/docs/api-reference/archive_room_folder/content.md) - **Sharing** - [Who can see it](https://api.smb.co/llms.mdx/docs/api-reference/list_access/content.md) - [Share it](https://api.smb.co/llms.mdx/docs/api-reference/share_access/content.md) - [Stop sharing it](https://api.smb.co/llms.mdx/docs/api-reference/remove_access/content.md) - [Set who can see it](https://api.smb.co/llms.mdx/docs/api-reference/set_access_visibility/content.md) - **Goals** - [List a Room's goals](https://api.smb.co/llms.mdx/docs/api-reference/list_room_goals/content.md) - **Participants** - [List Participants](https://api.smb.co/llms.mdx/docs/api-reference/list_room_participants/content.md) - [Invite a Participant](https://api.smb.co/llms.mdx/docs/api-reference/invite_room_participant/content.md) - [Update a Participant](https://api.smb.co/llms.mdx/docs/api-reference/update_room_participant/content.md) - [Revoke a Participant](https://api.smb.co/llms.mdx/docs/api-reference/revoke_room_participant/content.md) - **Shared tools** - [List shared tools](https://api.smb.co/llms.mdx/docs/api-reference/list_room_connections/content.md) - [Share a tool](https://api.smb.co/llms.mdx/docs/api-reference/share_room_connection/content.md) - [Stop sharing a tool](https://api.smb.co/llms.mdx/docs/api-reference/stop_room_connection/content.md) - [Pause a shared tool](https://api.smb.co/llms.mdx/docs/api-reference/pause_room_connection/content.md) - [Resume a shared tool](https://api.smb.co/llms.mdx/docs/api-reference/resume_room_connection/content.md) - [Find a shared app's tools](https://api.smb.co/llms.mdx/docs/api-reference/find_room_connection_tools/content.md) - [Read from a shared app](https://api.smb.co/llms.mdx/docs/api-reference/read_room_connection/content.md) - **Approvals** - [Ask for approval](https://api.smb.co/llms.mdx/docs/api-reference/request_room_approval/content.md) - [Get an approval](https://api.smb.co/llms.mdx/docs/api-reference/get_room_approval/content.md) - [Approve or decline](https://api.smb.co/llms.mdx/docs/api-reference/decide_room_approval/content.md) - **Activity** - [List Room activity](https://api.smb.co/llms.mdx/docs/api-reference/list_room_activity/content.md) - [List my Room activity](https://api.smb.co/llms.mdx/docs/api-reference/list_my_room_activity/content.md) - **File Permissions** - [List File Permissions](https://api.smb.co/llms.mdx/docs/api-reference/list_room_file_permissions/content.md) - [Set a File Permission](https://api.smb.co/llms.mdx/docs/api-reference/set_room_file_permission/content.md) - [Revoke a File Permission](https://api.smb.co/llms.mdx/docs/api-reference/revoke_room_file_permission/content.md) - [Read Room File Contents](https://api.smb.co/llms.mdx/docs/api-reference/read_room_file/content.md) - Events - [List events](https://api.smb.co/llms.mdx/docs/api-reference/list_events/content.md) - [Get an event](https://api.smb.co/llms.mdx/docs/api-reference/get_event/content.md) - [List event types](https://api.smb.co/llms.mdx/docs/api-reference/list_event_types/content.md) - Webhooks - [Create a webhook](https://api.smb.co/llms.mdx/docs/api-reference/create_webhook/content.md) - [List webhooks](https://api.smb.co/llms.mdx/docs/api-reference/list_webhooks/content.md) - [Get a webhook](https://api.smb.co/llms.mdx/docs/api-reference/get_webhook/content.md) - [Update a webhook](https://api.smb.co/llms.mdx/docs/api-reference/update_webhook/content.md) - [Delete a webhook](https://api.smb.co/llms.mdx/docs/api-reference/delete_webhook/content.md) - [Rotate a webhook's secret](https://api.smb.co/llms.mdx/docs/api-reference/rotate_webhook_secret/content.md) - [Send a test webhook](https://api.smb.co/llms.mdx/docs/api-reference/send_test_webhook/content.md) - [List webhook deliveries](https://api.smb.co/llms.mdx/docs/api-reference/list_webhook_deliveries/content.md) - [Retry a webhook delivery](https://api.smb.co/llms.mdx/docs/api-reference/retry_webhook_delivery/content.md) - Automations - [Create an automation](https://api.smb.co/llms.mdx/docs/api-reference/create_automation/content.md) - [List automations](https://api.smb.co/llms.mdx/docs/api-reference/list_automations/content.md) - [Get an automation](https://api.smb.co/llms.mdx/docs/api-reference/get_automation/content.md) - [Update an automation](https://api.smb.co/llms.mdx/docs/api-reference/update_automation/content.md) - [Delete an automation](https://api.smb.co/llms.mdx/docs/api-reference/delete_automation/content.md) - [Run an automation now](https://api.smb.co/llms.mdx/docs/api-reference/run_automation/content.md) - [List automation runs](https://api.smb.co/llms.mdx/docs/api-reference/list_automation_runs/content.md) - Files - [List Files](https://api.smb.co/llms.mdx/docs/api-reference/list_files/content.md) - [Start a File Upload](https://api.smb.co/llms.mdx/docs/api-reference/start_file_upload/content.md) - [Complete a File Upload](https://api.smb.co/llms.mdx/docs/api-reference/complete_file_upload/content.md) - [Create a Text File](https://api.smb.co/llms.mdx/docs/api-reference/create_text_file/content.md) - [Edit File Text](https://api.smb.co/llms.mdx/docs/api-reference/update_file_content/content.md) - [Upload a New Version](https://api.smb.co/llms.mdx/docs/api-reference/start_file_version_upload/content.md) - [List File Versions](https://api.smb.co/llms.mdx/docs/api-reference/list_file_versions/content.md) - [Get a File](https://api.smb.co/llms.mdx/docs/api-reference/get_file/content.md) - [Update a File](https://api.smb.co/llms.mdx/docs/api-reference/update_file/content.md) - [Archive a File](https://api.smb.co/llms.mdx/docs/api-reference/archive_file/content.md) - [Restore a File](https://api.smb.co/llms.mdx/docs/api-reference/restore_file/content.md) - [Read File Contents](https://api.smb.co/llms.mdx/docs/api-reference/read_file/content.md) - [Download a File](https://api.smb.co/llms.mdx/docs/api-reference/download_file/content.md) - Goals - [List Goals](https://api.smb.co/llms.mdx/docs/api-reference/list_goals/content.md) - [Create a Goal](https://api.smb.co/llms.mdx/docs/api-reference/create_goal/content.md) - [Get a Goal](https://api.smb.co/llms.mdx/docs/api-reference/get_goal/content.md) - [Update a Goal](https://api.smb.co/llms.mdx/docs/api-reference/update_goal/content.md) - Tasks - [List Tasks](https://api.smb.co/llms.mdx/docs/api-reference/list_tasks/content.md) - [Create a Task](https://api.smb.co/llms.mdx/docs/api-reference/create_task/content.md) - [Get a Task](https://api.smb.co/llms.mdx/docs/api-reference/get_task/content.md) - [Update a Task](https://api.smb.co/llms.mdx/docs/api-reference/update_task/content.md) - [Update many Tasks](https://api.smb.co/llms.mdx/docs/api-reference/update_tasks/content.md) - Lists - Manage Lists - [Find Lists](https://api.smb.co/llms.mdx/docs/api-reference/list_lists/content.md) - [Create a List](https://api.smb.co/llms.mdx/docs/api-reference/create_list/content.md) - [Get a List](https://api.smb.co/llms.mdx/docs/api-reference/get_list/content.md) - [Edit a List](https://api.smb.co/llms.mdx/docs/api-reference/update_list/content.md) - [Archive a List](https://api.smb.co/llms.mdx/docs/api-reference/archive_list/content.md) - [Restore a List](https://api.smb.co/llms.mdx/docs/api-reference/restore_list/content.md) - Draft and preview - [Get List filters](https://api.smb.co/llms.mdx/docs/api-reference/get_list_capabilities/content.md) - [List Business fields](https://api.smb.co/llms.mdx/docs/api-reference/list_fields/content.md) - [Draft a List](https://api.smb.co/llms.mdx/docs/api-reference/draft_list/content.md) - [Preview a List](https://api.smb.co/llms.mdx/docs/api-reference/preview_list/content.md) - Members - [Get List members](https://api.smb.co/llms.mdx/docs/api-reference/get_list_members/content.md) - [Get List member data](https://api.smb.co/llms.mdx/docs/api-reference/get_list_member_data/content.md) - [Unlock List columns](https://api.smb.co/llms.mdx/docs/api-reference/unlock_list_fields/content.md) - [Include or exclude a List member](https://api.smb.co/llms.mdx/docs/api-reference/set_list_override/content.md) - [Add List members](https://api.smb.co/llms.mdx/docs/api-reference/add_list_members/content.md) - Columns and values - [Add a private List column](https://api.smb.co/llms.mdx/docs/api-reference/create_list_column/content.md) - [Rename a List column](https://api.smb.co/llms.mdx/docs/api-reference/update_list_column/content.md) - [Archive a List column](https://api.smb.co/llms.mdx/docs/api-reference/archive_list_column/content.md) - [Set a private List value](https://api.smb.co/llms.mdx/docs/api-reference/set_list_entry_value/content.md) - [Find Workspace fields](https://api.smb.co/llms.mdx/docs/api-reference/list_workspace_fields/content.md) - [Add a Workspace field](https://api.smb.co/llms.mdx/docs/api-reference/create_workspace_field/content.md) - [Edit a Workspace field](https://api.smb.co/llms.mdx/docs/api-reference/update_workspace_field/content.md) - [Delete a Workspace field](https://api.smb.co/llms.mdx/docs/api-reference/delete_workspace_field/content.md) - [Set a Workspace field value](https://api.smb.co/llms.mdx/docs/api-reference/set_workspace_field_value/content.md) - Persons - [Create a private Person](https://api.smb.co/llms.mdx/docs/api-reference/create_person/content.md) - [Get a private Person](https://api.smb.co/llms.mdx/docs/api-reference/get_person/content.md) - API status - [API status](https://api.smb.co/llms.mdx/docs/api-reference/system/content.md): Confirm that the SMB API is responding. - [Health check](https://api.smb.co/llms.mdx/docs/api-reference/check_api_health/content.md) - [API capabilities](https://api.smb.co/llms.mdx/docs/api-reference/get_api_capabilities/content.md)