How to integrate Linq MCP with Atomic Agent

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

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

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Linq.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Linq account. See the Atomic Agent documentation for installation instructions.

Also integrate Linq with

How Atomic Agent connects to Linq

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Linq to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Linq. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Linq account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

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.

Use Linq from Atomic Agent

With your account connected, ask Atomic Agent to work with Linq in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

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.

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. Atomic Agent 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