# TimelinesAI — how to use (mcp.ai)

Connect your TimelinesAI account and use 13 tools for communication straight from your AI agent. Connect with your own API key. TimelinesAI enables teams to manage and automate WhatsApp communications, integrating with various CRMs and tools to streamline workflows.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_timelinesai?ms=1787293440000`
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. `timelinesai_delete_file`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/timelinesai`
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/timelinesai/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/timelinesai/delete/file` — Tool to delete an uploaded file by its UID. Use after confirming the file is no longer needed.
  - body: { file_uid: string }
- `POST https://api.mcp.ai/api/timelinesai/delete/webhook` — Tool to delete a webhook subscription by its ID. Use when you need to remove an existing webhook after confirming the webhook ID. Example: "Delete the webhook with ID '9f6a8c3d-56b7-4a1e-8f2e-abcdef12
  - body: { webhook_id: string }
- `POST https://api.mcp.ai/api/timelinesai/get/chat/messages` — Tool to get messages from a specific chat in TimelinesAI. Use when you need to retrieve message history or recent messages from a chat. Example: "Get the last 20 messages from chat 'chat_123abc'."
  - body: { limit?: integer, offset?: integer, chat_id: string, after_message_id?: string, before_message_id?: string }
- `POST https://api.mcp.ai/api/timelinesai/get/chats` — Tool to get full or filtered list of all chats. Use when you need to browse or search chats with optional filters. Example: "List all unread chats assigned to me."
  - body: { limit?: integer, types?: string[], offset?: integer, search?: string, is_muted?: boolean, label_id?: string, has_label?: boolean, is_unread?: boolean, person_id?: string, sort_field?: string, assignee_id?: string, is_archived?: boolean, is_assigned?: boolean, is_followed?: boolean, created_since?: string, has_open_task?: boolean, integration_id?: string, sort_direction?: string, team_member_id?: string }
- `POST https://api.mcp.ai/api/timelinesai/get/file/details` — Tool to retrieve metadata and temporary download URL for an uploaded file. Use after uploading a file or when needing its URL.
  - body: { file_uid: string }
- `POST https://api.mcp.ai/api/timelinesai/get/webhook` — Retrieves detailed information about a specific webhook subscription by its ID. Use this action to: - Check webhook configuration (URL, event type, enabled status) - Monitor webhook health (error coun
  - body: { webhook_id: string }
- `POST https://api.mcp.ai/api/timelinesai/get/webhooks` — Retrieves all webhook subscriptions configured for the workspace. Webhooks notify external systems about events (e.g., 'message:new', 'chat:new') in real-time. Use this to view existing webhook config
  - body: { limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/timelinesai/get/whatsapp/accounts` — Tool to list all WhatsApp accounts connected to the workspace. Use after configuring WhatsApp integration to verify accounts.
- `POST https://api.mcp.ai/api/timelinesai/list/uploaded/files` — Tool to list files uploaded in your TimelinesAI workspace. Use when you need to retrieve all uploaded files.
- `POST https://api.mcp.ai/api/timelinesai/post/message` — Tool to send a WhatsApp text message to a phone number via TimelinesAI. Use this to send messages to any recipient phone number using one of your connected WhatsApp accounts as the sender. The message
  - body: { text: string, phone: string, whatsapp_account_phone: string }
- `POST https://api.mcp.ai/api/timelinesai/post/webhook` — Tool to create a new webhook subscription. Use when you have the event type and callback URL ready.
  - body: { url: string, secret?: string, event_type: string }
- `POST https://api.mcp.ai/api/timelinesai/put/webhook` — Tool to update an existing webhook subscription. Use after confirming the webhook ID when you need to change the URL, subscribed event types, or enable/disable a webhook.
  - body: { url: string, enabled?: boolean, event_type: string, webhook_id: string }
- `POST https://api.mcp.ai/api/timelinesai/send/message` — Send a WhatsApp message to an existing chat in TimelinesAI. Use this action when you have a chat ID from the Get Chats action and want to send a message to that conversation. For sending messages to n
  - body: { chat_id: string, message: string, message_type?: string }

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

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