# Linq MCP

Vendor: Linq  
Category: communication  
Auth: API_KEY  
Composio slug: `linq`

Send and manage iMessage, RCS, and SMS conversations, attachments, phone numbers, payments, and webhooks through the Linq Partner API.

## Tools

- **Add Chat Participant** — Add an external participant to an existing group chat. The participant-visible change is queued asynchronously.
- **Add Poll Options** — Irreversibly add recipient-visible options to an existing iMessage poll. Poll options cannot be edited or removed after they are added.
- **Block Handle** — Block a handle account-wide from inbound and direct outbound messaging. Pair controlled test blocks with UNBLOCK_HANDLE cleanup.
- **Cancel Payment** — Irreversibly cancel a financial payment and close its virtual card. Confirm the payment identifier and authorization before calling because the canceled payment cannot be resumed.
- **Cancel Payment Request** — Irreversibly cancel an unpaid payment request and its underlying payment intent. The checkout can no longer be completed after cancellation; paid, canceled, or expired requests cannot be canceled. Confirm the request ID and intent first.
- **Check Messaging Capability** — Check whether a recipient can receive iMessage or RCS without sending a message. Linq permits only one capability check per 10 seconds; cache successful answers briefly (minutes, not days) instead of checking before every send.
- **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. This consent-sensitive, irreversible action may contact the customer and send an OTP; call it only with the custo
- **Create Chat** — Create or reuse a chat on an explicit sending line and send an irreversible recipient-visible initial message. First-message text and parts cannot contain links.
- **Create Payment** — Create or advance a real financial payment on a connected customer's behalf, potentially minting a single-use virtual card. This is consent-sensitive and financially consequential; obtain explicit customer authorization, verify the amount a
- **Create Payment Request** — Create a customer-facing checkout that can collect a one-time charge or start an auto-renewing subscription. This creates financial state but does not itself send the checkout URL to a recipient. Confirm the amount, currency, mode, rail, an
- **Create Poll** — Irreversibly send a recipient-visible iMessage poll to an existing chat. A poll cannot be the chat's first message, and its options are add-only and immutable.
- **Create Webhook Subscription** — Create a webhook subscription for selected Linq events at a controlled HTTPS callback. The response includes a one-time signing secret that must be stored securely.
- **Delete Attachment** — Permanently delete a Linq attachment and its stored bytes.
- **Delete Message** — Irreversibly delete a message record from Linq. This does not unsend the message or remove it from recipients' devices, and its idempotency key cannot be reused to resend it.
- **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. Linq permits at most five edits per message. A response with no message fields means Linq accepted an edit for a deleted message.
- **Get Attachment** — Return metadata and current status for a Linq attachment referenced by a message. This metadata-only action does not download the file.
- **Get Available Number** — Select an available Linq sending number, optionally for recipients or a line type. Treat the returned vCard URL as sensitive and ephemeral.
- **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. Treat coordinates and addresses as sensitive and minimize retention.
- **Get Experience** — Return one Linq experience and preserve its dynamic action field definitions. Discovery does not prove that required provider setup is complete.
- **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. Treat returned identifiers and hosted URLs as sensitive financial metadata.
- **Get Payment Credentials** — Return the complete, highly sensitive short-lived handoff used to reveal a ready payment's virtual card directly from the provider. The response includes provider, user_token, card_ref, and fetch_url when supplied. Use it only for the immed
- **Get Payment Handle Connection** — Read the financial-consent connection status for a customer phone number or email. Query only a customer handle whose owner consented to this lookup; the response may include a transient connect_id for a pending ceremony.
- **Get Payment Provider** — Read the organization's onboarding status for a payment provider. This is a read-only financial setup check; a 404 is an execution failure and must not be interpreted as a normal disabled status.
- **Get Payment Request** — Return one payment request's amount, lifecycle status, checkout details, and provider join keys. This is read-only financial metadata; treat checkout URLs and customer or provider IDs as sensitive.
- **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. Audits are retained for no more than 24 hours.
- **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. This is irreversible and prevents further interaction through the sending line.
- **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.164 sending line.
- **List Experiences** — Discover Linq experiences and their dynamic action fields. Availability in this response does not prove payment-provider onboarding is complete.
- **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. A message with no thread returns by itself.
- **List Payment Requests** — Return one newest-first page of payment requests for reconciliation, optionally filtered by lifecycle status. This is read-only financial metadata; checkout URLs and customer or provider IDs in results are sensitive.
- **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. This irreversibly changes recipient-visible conversation membership.
- **Request Attachment Upload** — Reserve persistent attachment storage and return a 15-minute presigned upload URL. This action does not upload file bytes; PUT the raw bytes separately to the returned opaque URL using the exact required_headers.
- **Request Chat Location** — Prompt a contact in a one-to-one iMessage chat to consent to sharing their precise location. This is recipient-visible and rate-limited per chat.
- **Revoke Payment Handle Connection** — Irreversibly revoke this partner's financial-consent grant for a customer phone number or email. This prevents future payments through the grant but does not delete the customer's provider wallet; revoke only with explicit authorization.
- **Send Message** — Send one irreversible, externally visible message to phone numbers or emails. Linq reuses a matching chat or creates one and automatically selects the sending line.
- **Send Message to Chat** — Send one follow-up or threaded reply to an existing Linq chat using its established sending line. This creates an irreversible recipient-visible message.
- **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.

## Setup

1. Create or open a Switchy Project.
2. Open Integrations and connect Linq.
3. Authorise through api_key.
4. Teammates can now @-mention Linq tools in chat.

---
Last verified: 2026-10-17T02:00:10.360Z  
Canonical URL: https://switchy.build/directory/mcps/linq