SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Insighto ai MCP with Hermes

Connect Hermes to Insighto ai MCP. Send whatsapp message to all new leads, fetch conversation history for a specific contact, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Insighto ai logoInsighto ai
Api Key

Insighto.ai is an AI-powered platform for building conversational chatbots and voice agents. Engage customers across web, messaging apps, and voice with smart, automated conversations.

65 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Insighto ai account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Insighto ai with

Claude CodeClaude CoworkOpenAI Agents SDKClaude Agent SDKCodexOpenClawAtomic AgentGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAIPydantic AIAutoGen

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Insighto ai with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Insighto ai

Ask your agent to connect to Insighto ai, or simply request any Insighto ai-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Insighto ai connection.

Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Insighto ai or request any Insighto ai-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Insighto ai MCP server, and what's possible with it?

The Insighto ai MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Insighto ai account. It provides structured and secure access to your conversational AI assets, so your agent can create new intents, manage contacts, analyze conversations, deploy widgets, and broadcast messages across channels on your behalf.

  • Intent creation and management: Easily add or review conversational intents to enhance your chatbots and voice agents, making them smarter and more responsive.
  • Bulk contact communication: Let your agent send messages to multiple contacts in bulk through WhatsApp or SMS, enabling efficient campaign blasts and customer updates.
  • Comprehensive contact and conversation insights: Retrieve full contact profiles, browse lists of contacts, and access detailed conversation metadata for analytics or personalized support.
  • Widget and provider deployment: Quickly create and configure new widgets and providers to extend your AI’s reach across new channels and platforms.
  • Datasource and metadata management: Fetch and inspect all data sources and custom contact fields, so your agent can sync, organize, or enrich customer data as needed.

Way Forward

With Insighto ai connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every Insighto ai action and event your agent gets out of the box.

Add Intent To Assistant

Tool to add an intent to an assistant in Insighto.

Create Agency

Tool to create a new agency in Insighto.

Create Contact Custom Field

Tool to create a new contact custom field in Insighto.

Create Form

Tool to create a new form in Insighto.

Create Intent

Tool to create a new intent in Insighto.

Create Prompt

Tool to create a new prompt in Insighto.

Create Provider

Creates a new AI provider configuration (e.

Create Tag

Tool to create a new tag in Insighto.

Create Toolfunction

Tool to create a new toolfunction in Insighto.

Create Webhook

Tool to create a new outbound webhook in Insighto.

Create Widget

Tool to create a new widget with specified attributes.

Delete Assistant By ID

Tool to delete an assistant by its ID.

Delete Bulk Forms By IDs

Tool to delete multiple forms by their IDs in a single operation.

Delete Contacts In Bulk

Tool to delete multiple contacts in bulk.

Delete Form By ID

Tool to delete a form by its unique identifier.

Delete Linked Assistant Datasource

Tool to delete (unlink) a datasource from a linked assistant in Insighto.

Delete Link Tag Entity By ID

Tool to delete a link_tag_entity by its ID.

Delete Prompt By ID

Tool to delete a prompt by its unique ID.

Delete Provider By ID

Delete an Insighto.

Delete Tag By ID

Tool to delete a tag by its unique identifier.

Delete Tool By ID

Tool to delete a tool by its ID.

Delete Toolfunction By ID

Tool to delete a toolfunction by its ID.

Delete Twilio Auth By ID

Tool to delete a Twilio authentication configuration by its ID.

Delete UserWhatsApp By ID

Tool to delete a UserWhatsApp by its ID.

Delete Widget By ID

Tool to delete a widget by its unique ID.

Get Agency Billing Plan

Retrieve an agency billing plan by ID to view its details, including limits for bots, queries, words and voice seconds, and its support options.

Get Agency Branding By ID

Tool to retrieve branding configuration for a specific agency by agency ID.

Get Agent List

Tool to fetch a paginated list of agents.

Get Assistant By ID

Tool to retrieve details of a specific assistant by assistant ID.

Get Captured Form By Form ID

Tool to retrieve captured form submissions by form ID.

Get Contact By ID

Tool to retrieve details of a specific contact by contact ID.

Get Datasource By ID

Tool to retrieve details of a specific datasource by datasource ID.

Get Intent By ID

Tool to retrieve details of a specific intent by its ID.

Get List Of Contacts

Tool to fetch a paginated list of contacts.

Get List Of Conversations

Tool to fetch a list of conversations.

Get List Of Datasources

List Insighto.

Get List Of Data Sources Linked To Assistant Id

Tool to retrieve a paginated list of data sources linked to a specific assistant.

Get List Of Widgets Linked To Assistant Id

Tool to fetch a paginated list of widgets linked to a specific assistant.

Get Pricing For User

Tool to retrieve pricing information for Insighto.

Get Prompt By ID

Tool to retrieve details of a specific prompt by prompt ID.

Get Provider By ID

Tool to retrieve details of a specific provider by provider ID.

Get Speechtotext List

Tool to fetch a paginated list of available speech-to-text voice configurations.

Get Widget By ID

Tool to retrieve details of a specific widget by widget ID.

List Channels

Tool to retrieve a paginated list of channels.

Read Campaign Contact List

Tool to retrieve a paginated list of contacts associated with a specific campaign.

Read Contact Custom Field List

Tool to retrieve a list of custom fields associated with contacts.

Read Contact Sync Log List

Tool to retrieve a paginated list of contact sync logs.

Read Intents List

Tool to retrieve a list of all intents.

Read Tag List

Tool to retrieve a paginated list of tags.

Read Tool Function Invoke Log List

Tool to retrieve a paginated list of tool function invoke logs.

Read Tool Toolfunction List

Tool to retrieve a paginated list of tool functions for a specific tool.

Read Twilio Auth List

Tool to retrieve a paginated list of Twilio authentications.

Retrieve Linked Tool And User

Tool to retrieve linked tool and user information for a specific tool.

Retrieve List Of User Custom Voice

Tool to retrieve a paginated list of user custom voices.

Retrieve User Monthly Usages Aggregation

Tool to retrieve user monthly usages aggregation data.

Retrieve Webhook Log

Tool to retrieve webhook logs for a specific webhook.

Send Messages To Contacts

Tool to send messages to a list of contacts in bulk.

Update Link Tool User

Tool to update a link tool user by its ID.

Update Tool By ID

Tool to update a tool by its ID.

Update Toolfunction By ID

Tool to update an existing toolfunction by its ID.

Update Twilio Auth By ID

Tool to update a Twilio authentication configuration by its ID.

Update User Profile

Tool to update a user profile in Insighto.

Update UserWhatsApp By ID

Tool to update a UserWhatsApp configuration by its ID.

Update Webhook By ID

Tool to update an outbound webhook by its unique ID.

Upsert Contact By Email Or Phone Number

Create or update an Insighto.

FRAMEWORKS

How to build Insighto ai MCP Agent with another framework

Claude Code logo

Claude Code

Use Insighto ai MCP with Claude Code

Claude Cowork logo

Claude Cowork

Use Insighto ai MCP with Claude Cowork

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Insighto ai MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Insighto ai MCP with Claude Agent SDK

Codex logo

Codex

Use Insighto ai MCP with Codex

OpenClaw logo

OpenClaw

Use Insighto ai MCP with OpenClaw

Atomic Agent logo

Atomic Agent

Use Insighto ai MCP with Atomic Agent

Google ADK logo

Google ADK

Use Insighto ai MCP with Google ADK

LangChain logo

LangChain

Use Insighto ai MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Insighto ai MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Insighto ai MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Insighto ai MCP with LlamaIndex

CrewAI logo

CrewAI

Use Insighto ai MCP with CrewAI

Pydantic AI logo

Pydantic AI

Use Insighto ai MCP with Pydantic AI

AutoGen logo

AutoGen

Use Insighto ai MCP with AutoGen

FAQ

Frequently asked questions

With a standalone Insighto ai MCP server, the agents and LLMs can only access a fixed set of Insighto ai tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Insighto ai and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Insighto ai tools.

Yes, absolutely. You can configure which Insighto ai scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Insighto ai data and credentials are handled as safely as possible.

Start with Insighto ai.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Insighto ai tool your agent needs.Free to start.

Start building