Skip to content
MCP server

Textline MCP by usefulapi

Read Textline conversations, contacts and reports; send a text, add notes, resolve or…

Install
Runs
Remotely
Version
1.31.0
Listing updated
4 days ago

About Textline MCP by usefulapi

Textline MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Read Textline conversations, contacts and reports; send a text, add notes, resolve or transfer.

Install

Run in a terminal

claude mcp add --transport http textline https://textline.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://textline.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "textline": {
      "url": "https://textline.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "textline": {
      "type": "http",
      "url": "https://textline.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "textline": {
      "serverUrl": "https://textline.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "textline": {
      "type": "http",
      "url": "https://textline.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (23)

Read directly from the server.

textline_list_conversations
List conversations (one per contact) in a department of the Textline shared inbox, with the contact and resolved status. Optional keyword search. GET /api/conversations.json.
textline_get_conversation
Retrieve one conversation and its posts (messages in and out, internal whispers, resolve/transfer events), newest page first. Page with page/page_size or with before_uuid/after_uuid (a post uuid). GET /api/conversation/{uuid}.json.
textline_get_conversation_by_phone
Retrieve the conversation with a phone number (in a department) and its posts (messages). GET /api/conversations.json?phone_number=….
textline_list_customers
List or search contacts (customers) in the Textline address book: name, phone, email, tags, notes, custom fields, consent and reachability. GET /api/customers.json.
textline_get_customer
Retrieve one contact (customer) from the address book by UUID. GET /api/customer/{uuid}.json.
textline_get_customer_by_phone
Retrieve one contact (customer) from the address book by phone number. GET /api/customers.json?phone_number=….
textline_list_custom_fields
List the address book's custom fields (name, data type, UUID). Use the UUIDs with textline_update_customer. GET /api/address_book/custom_fields.json.
textline_list_saved_searches
List the address book's saved searches (contact segments) with name, description and UUID. GET /api/address_book/saved_searches.json.
textline_get_organization
Retrieve the organization (account) name, optionally with its departments and agents. GET /api/organization.json.
textline_list_departments
List the departments (groups / inbox phone lines) the token's agent can see: name, UUID, phone number, type (sms, facebook, smart_sms) and member agent UUIDs. GET /api/groups.json.
textline_list_agents
List the agents (users) in the organization: name, email, UUID, permission level, availability and department UUIDs. GET /api/organization.json?include_users=1.
textline_get_agent
Retrieve one agent (user) by UUID or email: name, permission level, availability (on_call) and departments. GET /api/users.json.
textline_list_dispositions
List the dispositions (resolution reasons) set up in the account, optionally for one department. Use a UUID with textline_resolve_conversation. GET /api/dispositions.json.
textline_list_surveys
List surveys (NPS, CSAT, custom) with their type and UUID. GET /api/surveys.json.
textline_list_survey_responses
List the responses to one survey (ratings, follow-up text, contact, tags). Default: the last 30 days. GET /api/survey/{uuid}/responses.json.
textline_report_conversations
Reporting API: list a department's conversations filtered by created/updated time, resolved, archived or blocked, with total_records. To get the next page pass the returned next.search_uuid, next.page and next.page_size exactly (the same filters are kept). Then use textline_report_posts per conversation. GET /api/reporting/conversations.json.
textline_report_posts
Reporting API: list all posts (messages, whispers) of one conversation with creator, thread, first-response flags, filtered by created time, with total_records. To get the next page pass the returned next.search_uuid, next.page and next.page_size exactly. GET /api/reporting/conversation/{uuid}/posts.json.
textline_send_message
SENDS A REAL SMS/MMS to ONE contact from your Textline number — the customer receives it immediately and it cannot be unsent; it consumes message credits. Address it by conversation_uuid or by phone_number (+ optional department). Confirm the recipient and text with the user first. One recipient per call; no bulk sends. POST /api/conversation/{uuid}.json or POST /api/conversations.json.
textline_add_whisper
WRITE: add an internal whisper (a note only your agents see, never sent to the customer) to a conversation, by conversation_uuid or phone_number. POST /api/conversation/{uuid}.json or POST /api/conversations.json with a whisper.
textline_resolve_conversation
WRITE: mark a conversation resolved (closed), optionally with a disposition from textline_list_dispositions. Nothing is sent to the customer. POST /api/conversation/{uuid}/resolve.json.
textline_transfer_conversation
WRITE: assign a conversation to another agent of the same department, by agent UUID or email (one of them). Nothing is sent to the customer. POST /api/conversation/{uuid}/transfer.json.
textline_create_customer
WRITE: add a contact (customer) to the Textline address book. Sends nothing to the contact. POST /api/customers.json.
textline_update_customer
WRITE: update a contact's name, email, notes, tags (add, remove or replace) or custom fields (by custom-field UUID from textline_list_custom_fields). Overwrites the fields you pass; sends nothing to the contact. PUT /api/customer/{uuid}.json.

Textline MCP by usefulapi FAQ

How do I add Textline MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http textline https://textline.usefulapi.io/mcp