# Respond.io — how to use (mcp.ai)

Connect your Respond.io account and use 7 tools for customer support straight from your AI agent. Connect with your own API key. AI-powered customer conversation management software.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_respond_io?ms=1787291280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `respond_io_create_comment`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/respond_io`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/respond_io/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/respond_io/create/comment` — Tool to add a comment (internal note) to a contact's conversation. Use after verifying the contact identifier.
  - body: { text: string, identifier: string }
- `POST https://api.mcp.ai/api/respond_io/create/contact` — Creates a new contact in the respond.io workspace with the specified details. The contact is identified by email, phone number, or contact ID. Supports adding profile information, language preferences
  - body: { email?: string, phone?: string, language?: string, lastName?: string, firstName: string, identifier: string, profilePic?: string, countryCode?: string, custom_fields?: object[] }
- `POST https://api.mcp.ai/api/respond_io/create/space/tag` — Creates a new tag in the Respond.io workspace for organizing and categorizing contacts and conversations. Tags help with segmentation, filtering, and workflow automation. Each tag must have a unique n
  - body: { name: string, color_code?: string, description?: string }
- `POST https://api.mcp.ai/api/respond_io/get/message` — Tool to retrieve a specific message. Use when you need the details of a message sent to or received from a contact.
  - body: { messageId: integer, identifier: string }
- `POST https://api.mcp.ai/api/respond_io/list/channels` — Tool to retrieve a list of channels connected to the workspace. Use when you need to enumerate all messaging channels with pagination support.
  - body: { limit?: integer, cursorId?: integer }
- `POST https://api.mcp.ai/api/respond_io/list/users` — Tool to retrieve a list of users in the workspace. Use when you need to fetch all workspace users for auditing or assignment.
- `POST https://api.mcp.ai/api/respond_io/update/space/tag` — Updates an existing workspace tag by its current name. You can modify the tag's name, description, or emoji. Note: Color codes are not currently supported by the API and will be rejected if provided. 
  - body: { name?: string, emoji?: string, colorCode?: string, currentName: string, description?: string }

## Example prompts
- "What can I do in Respond.io?"
- "Show me a summary of my Respond.io account"

## More
- Page: https://mcp.ai/respond_io
- Agent spec (llms.txt): https://mcp.ai/respond_io/llms.txt
- Postman collection: https://mcp.ai/respond_io/postman.json