SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Linq MCP with Hermes

Connect Hermes to Linq MCP. Send an sms to a customer, review recent rcs conversation messages, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Linq logoLinq
Api Key

Linq is a communications API for sending and managing iMessage, RCS, and SMS conversations. It also supports attachments, phone numbers, payments, and webhooks in one platform.

68 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 Linq 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 Linq with

ChatGPTClaude CoworkAtomic Agent

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 Linq 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 Linq

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

4. Done. You're all set with a new Linq 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 Linq or request any Linq-related task. It will prompt you to authenticate and authorize access.

5. Done!

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

The Linq MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Linq account. It provides structured and secure access to messaging, chats, phone numbers, polls, payments, and webhook subscriptions, so your agent can send messages, manage conversations, check messaging and delivery details, handle payments, and configure event notifications on your behalf.

  • iMessage, RCS, and SMS conversations: Have your agent check a recipient’s messaging capability, create chats, send initial messages, view conversations, edit recent messages, and delete messages.
  • Chat and contact management: Let the agent list chats, inspect participants and shared locations, add people to group chats, leave group chats, and manage blocked phone numbers or email addresses.
  • Polls and message threads: Direct your agent to create iMessage polls, add poll options, review responses, and retrieve threaded replies.
  • Payments and payment requests: Instruct your agent to create, review, cancel, and reconcile payments or customer-facing payment requests, including checking payment handle connections and provider status.
  • Phone lines and webhooks: Have your agent list sending numbers, find an available number, review contact-card details, and create, inspect, or remove webhook subscriptions for Linq events.

Way Forward

With Linq 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 Linq action and event your agent gets out of the box.

Add Chat Participant

Add an external participant to an existing group chat.

Add Poll Options

Irreversibly add recipient-visible options to an existing iMessage poll.

Block Handle

Block a handle account-wide from inbound and direct outbound messaging.

Cancel Payment

Irreversibly cancel a financial payment and close its virtual card.

Cancel Payment Request

Irreversibly cancel an unpaid payment request and its underlying payment intent.

Check Messaging Capability

Check whether a recipient can receive iMessage or RCS without sending a message.

Connect Payment Handle

Start the financial-consent ceremony for a customer phone number or email so an agent can later pay on that customer's behalf.

Create Chat

Create or reuse a chat on an explicit sending line and send an irreversible recipient-visible initial message.

Create Payment

Create or advance a real financial payment on a connected customer's behalf, potentially minting a single-use virtual card.

Create Payment Request

Create a customer-facing checkout that can collect a one-time charge or start an auto-renewing subscription.

Create Poll

Irreversibly send a recipient-visible iMessage poll to an existing chat.

Create Webhook Subscription

Create a webhook subscription for selected Linq events at a controlled HTTPS callback.

Delete Attachment

Permanently delete a Linq attachment and its stored bytes.

Delete Message

Irreversibly delete a message record from Linq.

Delete Webhook Subscription

Permanently delete a Linq webhook subscription and stop its future event deliveries.

Edit Message

Irreversibly change recipient-visible text in one part of a message sent within the last 15 minutes.

Get Attachment

Return metadata and current status for a Linq attachment referenced by a message.

Get Available Number

Select an available Linq sending number, optionally for recipients or a line type.

Get Chat

Return one chat by ID, including participants, service, state, and health information.

Get Chat Location

Return precise locations currently shared by contacts in a chat.

Get Experience

Return one Linq experience and preserve its dynamic action field definitions.

Get Message

Return one Linq message by ID with its content parts, sender, actual and preferred transport, delivery state, reply target, and timestamps.

Get Payment

Read a payment's financial state, amount, customer handle, merchant details, and any customer-action URL.

Get Payment Credentials

Return the complete, highly sensitive short-lived handoff used to reveal a ready payment's virtual card directly from the provider.

Get Payment Handle Connection

Read the financial-consent connection status for a customer phone number or email.

Get Payment Provider

Read the organization's onboarding status for a payment provider.

Get Payment Request

Return one payment request's amount, lifecycle status, checkout details, and provider join keys.

Get Poll

Return an iMessage poll's current options, voters, and distinct voter count.

Get Reputation Audit

Return a Linq line reputation audit created with explicit approval.

Get Webhook Subscription

Return one Linq webhook subscription by ID, including its callback URL, event and phone filters, active state, and configured routing-header names.

Leave Chat

Leave an iMessage group chat.

List Blocked Handles

Return phone numbers, email addresses, short codes, and sender IDs currently blocked account-wide from inbound and direct outbound messaging.

List Chats

Return one page of chats, optionally filtered by sending line or participant, with a cursor for the next page.

List Contact Cards

Return Linq account contact-card identity data, optionally for one E.

List Experiences

Discover Linq experiences and their dynamic action fields.

List Messages

Return one page of messages from a chat, including content, sender, transport, delivery state, direction, reply target, and timestamps, plus a cursor for older messages.

List Message Thread

Return one page containing the origin message and threaded replies, starting from any message in the thread.

List Payment Requests

Return one newest-first page of payment requests for reconciliation, optionally filtered by lifecycle status.

List Phone Numbers

Return the connected Linq account's sending lines with line type, forwarding configuration, and reputation status.

List Webhook Events

Return the webhook event types currently available for subscription on the connected Linq account.

List Webhook Subscriptions

Return the connected Linq account's webhook subscriptions, including event and phone-number filters, target URLs, active state, and routing-header names.

Mark Chat As Read

Mark every message in a chat as read and send an irreversible read receipt.

Remove Chat Background

Reset a chat's recipient-visible transcript background to the default.

Remove Chat Participant

Remove an external participant from a group chat.

Request Attachment Upload

Reserve persistent attachment storage and return a 15-minute presigned upload URL.

Request Chat Location

Prompt a contact in a one-to-one iMessage chat to consent to sharing their precise location.

Revoke Payment Handle Connection

Irreversibly revoke this partner's financial-consent grant for a customer phone number or email.

Send Message

Send one irreversible, externally visible message to phone numbers or emails.

Send Message to Chat

Send one follow-up or threaded reply to an existing Linq chat using its established sending line.

Send Voice Memo to Chat

Irreversibly send recipient-visible audio as a native iMessage voice memo bubble to every participant in an existing Linq chat.

Set Chat Background

Set a recipient-visible color, animated, or photo transcript background.

Set Up Contact Card

Create or replace a Linq contact card for a sending line.

Share Contact Card With Chat

Share the connected sending line's active contact card with a chat.

Start Payment Provider Onboarding

Create a hosted payment-provider onboarding session for the organization.

Start Reputation Audit

Start a potentially metered or limited reputation audit for a Linq sending line.

Start Typing Indicator

Show a best-effort recipient-visible typing indicator for about 85-90 seconds.

Stop Chat Location Sharing

Stop a specific contact's inbound location share.

Stop Typing Indicator

Immediately clear the connected line's recipient-visible typing indicator for a chat.

Toggle Poll Vote

Irreversibly send a recipient-visible update that adds or removes the connected line's vote on one option of an iMessage poll.

Unblock Handle

Remove an account-wide messaging block.

Update Chat

Update a group chat's display name or icon.

Update Contact Card

Update the public contact-card identity for one Linq sending line.

Update iMessage App Card

Irreversibly send a recipient-visible in-place update to an iMessage app card.

Update Message Reaction

Irreversibly mutate recipient-visible reaction state by adding or removing a tapback, or by adding an iMessage sticker.

Update Phone Number

Change a Linq sending line's production forwarding configuration.

Update Sticker Placement

Irreversibly send a recipient-visible update that moves, resizes, or rotates an existing iMessage sticker on a message.

Update Webhook Subscription

Update a Linq webhook subscription's callback, filters, active state, or routing-header names.

Verify Payment Handle

Submit a customer's single-use OTP to complete the financial-consent ceremony and authorize future payments on the customer's behalf.

FRAMEWORKS

How to build Linq MCP Agent with another framework

ChatGPT logo

ChatGPT

Use Linq MCP with ChatGPT

Claude Cowork logo

Claude Cowork

Use Linq MCP with Claude Cowork

Atomic Agent logo

Atomic Agent

Use Linq MCP with Atomic Agent

FAQ

Frequently asked questions

With a standalone Linq MCP server, the agents and LLMs can only access a fixed set of Linq tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Linq 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 Linq tools.

Yes, absolutely. You can configure which Linq 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 Linq data and credentials are handled as safely as possible.

Start with Linq.It takes 30 seconds.

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

Start building