# Insighto.ai — MCP server on mcp.ai
> Connect your Insighto.ai account and use 65 tools for AI chatbots straight from your AI agent. Connect with your own API key. Insighto.ai is an AI-powered communication platform that enables businesses to create and deploy conversational AI chatbots and voice agents for enhanced customer engagement across multiple channels.

By: mcp.ai · official
Page: https://mcp.ai/insighto_ai

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_insighto_ai?ms=1787291400000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/insighto_ai/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/insighto_ai/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/insighto_ai/skill.md
Postman collection (v2.1): https://mcp.ai/insighto_ai/postman.json

## Tools
- insighto_ai_add_intent_to_assistant(intent_id: string, attributes?: object, assistant_id: string) — Tool to add an intent to an assistant in Insighto.ai. Use when linking existing intents to an assistant for enhanced conversation handling.
- insighto_ai_create_agency(domain?: object, org_id: string, branding?: object, user_auth?: object, billing_plan?: object) — Tool to create a new agency in Insighto.ai. Use when setting up a new agency with organization-specific configuration and branding.
- insighto_ai_create_contact_custom_field(org_id?: string, custom_field_name: string, custom_field_type: string) — Tool to create a new contact custom field in Insighto.ai. Use when you need to add custom metadata fields for contacts.
- insighto_ai_create_form(name: string, fields?: object[], org_id?: string, form_type: string, attributes?: object, webhook_id?: string, trigger_tools?: object[], contact_mapping?: object, trigger_instructions: string) — Tool to create a new form in Insighto.ai. Use when you need to create either a natural (conversational AI-driven) or simple (traditional) form for collecting information from users.
- insighto_ai_create_intent(name: string, is_active?: boolean, attributes?: object, description?: string, intent_type?: string) — Tool to create a new intent in Insighto.ai. Use when adding custom intents before training or deployment. Call after confirming intent attributes.
- insighto_ai_create_prompt(name?: string, owner_type?: string, description?: string, prompt_template?: string) — Tool to create a new prompt in Insighto.ai. Use when adding custom prompts for AI interactions. The prompt template can include variables in {{variable_name}} format.
- insighto_ai_create_provider(name: string, org_id?: string, status?: boolean, attributes?: object, provider_key: string, provider_name?: string) — Creates a new AI provider configuration (e.g., OpenAI, ElevenLabs, Azure Speech, Cartesia, PlayHT) for use in voice and text-to-speech workflows. The provider stores credentials and settings in the at
- insighto_ai_create_tag(name: string, attributes?: object, color_code: string, description: string) — Tool to create a new tag in Insighto.ai. Use when categorizing contacts, conversations, or other entities with custom labels.
- insighto_ai_create_toolfunction(name: string, details?: object, tool_id?: string, is_enabled?: boolean, description: string, tool_function_type: string) — Tool to create a new toolfunction in Insighto.ai. Use when you need to register a new tool function (SDK, CURL, or query index type) before using it in workflows or assistant operations.
- insighto_ai_create_webhook(name: string, enabled?: boolean, endpoint: string) — Tool to create a new outbound webhook in Insighto.ai. Use when you need to configure webhook endpoints for event notifications.
- insighto_ai_create_widget(name?: string, org_id?: string, attributes?: object, bubble_text?: string, description?: string, widget_type: string, assistant_id?: string, bubble_color?: string, display_name?: string, header_color?: string, style_params?: object, intro_message?: string, action_buttons: string|object[], bot_icon_color?: string, ice_break_color?: string, remove_branding?: boolean, bot_message_color?: string, header_text_color?: string, user_message_color?: string, action_buttons_color?: string, textbox_default_text?: string, user_opening_messages: string[], bot_text_message_color?: string, user_text_message_color?: string) — Tool to create a new widget with specified attributes. Use after confirming assistant_id and widget_type.
- insighto_ai_delete_assistant_by_id(assistant_id: string) — Tool to delete an assistant by its ID. Use when you need to permanently remove an assistant from the system.
- insighto_ai_delete_bulk_forms_by_ids(form_ids: string[]) — Tool to delete multiple forms by their IDs in a single operation. Use when you need to remove multiple forms at once.
- insighto_ai_delete_contacts_in_bulk(contact_ids: string[]) — Tool to delete multiple contacts in bulk. Use when you need to remove several contacts at once by providing their UUIDs.
- insighto_ai_delete_form_by_id(form_id: string) — Tool to delete a form by its unique identifier. Use when you need to permanently remove a form from the system.
- insighto_ai_delete_link_tag_entity_by_id(link_tag_entity_id: string) — Tool to delete a link_tag_entity by its ID. Use when you need to remove a specific link_tag_entity from the system.
- insighto_ai_delete_linked_assistant_datasource(assistant_id: string, datasource_id: string) — Tool to delete (unlink) a datasource from a linked assistant in Insighto.ai. Use when you need to remove a specific datasource from an assistant's knowledge base. Requires valid datasource_id and assi
- insighto_ai_delete_prompt_by_id(prompt_id: string) — Tool to delete a prompt by its unique ID. Use when you need to remove a prompt from the system.
- insighto_ai_delete_provider_by_id(provider_id: string) — Tool to delete an AI provider configuration by its unique identifier. Use when you need to permanently remove a provider from the system.
- insighto_ai_delete_tag_by_id(tag_id: string) — Tool to delete a tag by its unique identifier. Use when you need to permanently remove a tag from the system.
- insighto_ai_delete_tool_by_id(tool_id: string) — Tool to delete a tool by its ID. Use when you need to remove a tool from the system.
- insighto_ai_delete_toolfunction_by_id(toolfunction_id: string) — Tool to delete a toolfunction by its ID. Use when you need to remove a toolfunction from the system.
- insighto_ai_delete_twilio_auth_by_id(twilio_auth_id: string) — Tool to delete a Twilio authentication configuration by its ID. Use when you need to remove a Twilio auth integration from the system.
- insighto_ai_delete_userwhatsapp_by_id(userwhatsapp_id: string) — Tool to delete a UserWhatsApp by its ID. Use when you need to remove a specific UserWhatsApp connection.
- insighto_ai_delete_widget_by_id(widget_id: string) — Tool to delete a widget by its unique ID. Use when you need to permanently remove a widget from the system.
- insighto_ai_get_agency_billing_plan(billing_plan_id: string) — Tool to retrieve details of a specific agency billing plan by ID. Use when you need to view billing plan information including limits for bots, queries, words, voice seconds, and support options.
- insighto_ai_get_agency_branding_by_id(agency_id: string) — Tool to retrieve branding configuration for a specific agency by agency ID. Use when you have a valid agency ID and need its branding settings.
- insighto_ai_get_agent_list(page?: integer, size?: integer) — Tool to fetch a paginated list of agents. Use when you need to retrieve user/agent information with pagination support.
- insighto_ai_get_assistant_by_id(assistant_id: string) — Tool to retrieve details of a specific assistant by assistant ID. Use when you have a valid assistant ID and need the full assistant profile.
- insighto_ai_get_captured_form_by_form_id(page?: integer, size?: integer, form_id: string) — Tool to retrieve captured form submissions by form ID. Use when you have a valid form ID and need to fetch all submissions for that specific form with pagination support.
- insighto_ai_get_contact_by_id(contact_id: string) — Tool to retrieve details of a specific contact by contact ID. Use when you have a valid contact ID and need the full contact profile.
- insighto_ai_get_datasource_by_id(datasource_id: string) — Tool to retrieve details of a specific datasource by datasource ID. Use when you have a valid datasource ID and need the full datasource details.
- insighto_ai_get_intent_by_id(intent_id: string) — Tool to retrieve details of a specific intent by its ID. Use when you have a valid intent ID and need the full intent details.
- insighto_ai_get_list_of_contacts(page?: integer, size?: integer) — Tool to fetch a paginated list of contacts. Use after confirming a valid API key to iterate through pages of contacts.
- insighto_ai_get_list_of_conversations(page?: integer, size?: integer, date_to: string, date_from: string, intent_id?: string, assistant_id?: string, includes_voice?: boolean) — Tool to fetch a list of conversations. Use after specifying date range and filters to retrieve conversation metadata.
- insighto_ai_get_list_of_data_sources_linked_to_assistant_id(page?: integer, size?: integer, assistant_id: string) — Tool to retrieve a paginated list of data sources linked to a specific assistant. Use when you need to discover which data sources are associated with an assistant ID. Requires admin or manager role.
- insighto_ai_get_list_of_datasources(page?: integer, size?: integer) — Retrieves a paginated list of data sources from Insighto AI. Data sources contain the knowledge base content (text, files, URLs) used by AI assistants. Use this to discover available data sources, get
- insighto_ai_get_list_of_widgets_linked_to_assistant_id(page?: integer, size?: integer, assistant_id: string) — Tool to fetch a paginated list of widgets linked to a specific assistant. Use when you need to discover which widgets are associated with an assistant ID.
- insighto_ai_get_pricing_for_user(llm_model_id?: string, voice_stt_id?: string, voice_tts_id?: string) — Tool to retrieve pricing information for Insighto.ai services. Use when you need to calculate costs for LLM, voice, or transcription services.
- insighto_ai_get_prompt_by_id(prompt_id: string) — Tool to retrieve details of a specific prompt by prompt ID. Use when you have a valid prompt ID and need the full prompt details.
- insighto_ai_get_provider_by_id(provider_id: string) — Tool to retrieve details of a specific provider by provider ID. Use when you have a valid provider ID and need the full provider configuration.
- insighto_ai_get_speechtotext_list(page?: integer, size?: integer) — Tool to fetch a paginated list of available speech-to-text voice configurations. Use when you need to retrieve available languages and providers for voice-to-text conversion.
- insighto_ai_get_widget_by_id(widget_id: string) — Tool to retrieve details of a specific widget by widget ID. Use when you have a valid widget ID and need the widget configuration.
- insighto_ai_list_channels(page?: integer, size?: integer) — Tool to retrieve a paginated list of channels. Use after authenticating to fetch all available channels and their configurations.
- insighto_ai_read_campaign_contact_list(page?: integer, size?: integer, campaign_id: string) — Tool to retrieve a paginated list of contacts associated with a specific campaign. Use when you need to fetch all contacts enrolled in a campaign.
- insighto_ai_read_contact_custom_field_list(page?: integer, size?: integer) — Tool to retrieve a list of custom fields associated with contacts. Use when you need to inspect or sync contact metadata definitions.
- insighto_ai_read_contact_sync_log_list(page?: integer, size?: integer) — Tool to retrieve a paginated list of contact sync logs. Use when you need to inspect sync history, troubleshoot sync issues, or audit contact synchronization operations.
- insighto_ai_read_intents_list(page?: integer, size?: integer) — Tool to retrieve a list of all intents. Use after authenticating; supports pagination.
- insighto_ai_read_tag_list(page?: integer, size?: integer) — Tool to retrieve a paginated list of tags. Use after authenticating to fetch and browse through all available tags.
- insighto_ai_read_tool_function_invoke_log_list(page?: integer, size?: integer, conversation_id?: string) — Tool to retrieve a paginated list of tool function invoke logs. Use when you need to inspect function invocation history, troubleshoot tool execution issues, or audit tool function calls.
- insighto_ai_read_tool_toolfunction_list(page?: integer, size?: integer, tool_id: string) — Tool to retrieve a paginated list of tool functions for a specific tool. Use after authenticating to fetch and browse through all tool functions associated with a given tool ID.
- insighto_ai_read_twilio_auth_list(page?: integer, size?: integer) — Tool to retrieve a paginated list of Twilio authentications. Use after authenticating to fetch and browse through all configured Twilio auth integrations.
- insighto_ai_retrieve_linked_tool_and_user(page?: integer, size?: integer, tool_id: string) — Tool to retrieve linked tool and user information for a specific tool. Use when you need to fetch users linked to a tool by tool ID.
- insighto_ai_retrieve_list_of_user_custom_voice(page?: integer, size?: integer) — Tool to retrieve a paginated list of user custom voices. Use after authenticating to fetch available custom voices.
- insighto_ai_retrieve_user_monthly_usages_aggregation(page?: integer, size?: integer) — Tool to retrieve user monthly usages aggregation data. Use when you need to fetch analytics about user usage patterns aggregated by month.
- insighto_ai_retrieve_webhook_log(page?: integer, size?: integer, webhook_id: string) — Tool to retrieve webhook logs for a specific webhook. Use to monitor webhook delivery status and debug webhook issues.
- insighto_ai_send_messages_to_contacts(message?: string, widget_id: string, contact_ids: string[], start_new_conversation?: boolean) — Tool to send messages to a list of contacts in bulk. Use when your widget is connected to WhatsApp or SMS and you have the contact IDs ready.
- insighto_ai_update_link_tool_user(name?: string, org_id?: string, tool_id?: string, attributes?: object, credentials?: object, link_tool_user_id: string) — Tool to update a link tool user by its ID. Use when you need to modify properties of an existing tool integration.
- insighto_ai_update_tool_by_id(sdk?: object, name?: string, org_id?: string, enabled?: boolean, tool_id: string, base_url?: string, category?: string, logo_url?: string, tool_type?: string, attributes?: object, description?: string, tool_provider?: string, authentication?: object) — Tool to update a tool by its ID. Use when you need to modify properties of an existing tool such as name, description, or enabled status.
- insighto_ai_update_toolfunction_by_id(name?: string, details?: object, tool_id?: string, is_enabled?: boolean, description?: string, toolfunction_id: string, tool_function_type?: string) — Tool to update an existing toolfunction by its ID. Use when you need to modify properties of a toolfunction such as name, description, type, or enabled status.
- insighto_ai_update_twilio_auth_by_id(name?: string, twilio_auth_id: string, twilio_auth_token?: string, twilio_account_sid?: string) — Tool to update a Twilio authentication configuration by its ID. Use when you need to modify Twilio auth credentials or settings.
- insighto_ai_update_user_profile(city?: string, email?: string, phone?: string, state?: string, address?: string, country?: string, role_id?: string, user_id: string, is_trial?: boolean, birthdate?: string, is_active?: boolean, is_paying?: boolean, last_name?: string, first_name?: string, used_trial?: boolean, is_superuser?: boolean, is_enterprise?: boolean, billing_updated_at?: string, stripe_customer_id?: string, last_credits_refresh?: string, next_billing_plan_id?: string, next_credits_refresh?: string, active_billing_plan_id?: string, stripe_subscription_id?: string, stripe_last_payment_date?: string, stripe_has_payment_method?: boolean, stripe_subscription_status?: string) — Tool to update a user profile in Insighto.ai. Use when modifying user account details, contact information, or billing settings.
- insighto_ai_update_userwhatsapp_by_id(phone_number_id?: string, userwhatsapp_id: string, phone_business_id?: string, facebook_app_secret?: string, whatsapp_access_token?: string, whatsapp_phone_number?: string) — Tool to update a UserWhatsApp configuration by its ID. Use when you need to modify WhatsApp Business API settings for a user.
- insighto_ai_update_webhook_by_id(name?: string, enabled?: boolean, endpoint?: string, webhook_id: string) — Tool to update an outbound webhook by its unique ID. Use when you need to modify webhook configuration such as name, endpoint URL, or enabled status.
- insighto_ai_upsert_contact_by_email_or_phone_number(email: string, last_name: string, first_name: string, phone_number: string) — Tool to upsert (create or update) a contact in Insighto.ai using email or phone number. Use when you need to create a new contact or update an existing one by email or phone number.

## Example prompts
- "What can I do in Insighto.ai?"
- "Show me a summary of my Insighto.ai account"

## Links
Docs: https://mcp.ai/docs/mcps/insighto_ai
Website: https://mcp.ai/mcps/insighto_ai