> ## Documentation Index
> Fetch the complete documentation index at: https://docs.groovin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP tools

> The 17 tools your AI assistant gets. Each one is the same action as a REST route, with the same arguments and answer.

Each tool does exactly what its REST route does: same arguments, same answer, same effects. The **Details** link gives its arguments, its answer and what it really changes.

> [!WARNING]
>
> The way a tool is declared is a hint your assistant uses to decide when to ask you first. It does not replace reading [what each call really does](https://docs.groovin.ai/reference/side-effects.md). For example, `toggle_linkedin_sync` is declared as safe to repeat, yet turning sync off deletes the conversation notes in your CRM.

## LinkedIn

| Tool | What it does | Declared to your assistant as | Details |
| - | - | - | - |
| `list_linkedin_conversation_attendees` | See who you talk to on LinkedIn, most recent conversation first, with their profile details and whether they are already linked to your CRM. | Read-only | [List the people in your conversations](https://docs.groovin.ai/reference/api/list-conversation-attendees.md) |
| `get_linkedin_chat_messages` | Read the messages of one LinkedIn conversation, newest first. Get the `conversation_id` from the conversation list. | Read-only | [Read a conversation](https://docs.groovin.ai/reference/api/get-chat-messages.md) |
| `set_linkedin_chat_read_status` | Change the read state of one conversation in your LinkedIn inbox. | Write, safe to repeat | [Mark a conversation as read or unread](https://docs.groovin.ai/reference/api/set-chat-read-status.md) |
| `get_linkedin_profile` | Read one LinkedIn profile live: name, headline, location, current job and company. The answer can be passed straight to contact creation. | Write, safe to repeat | [Get a LinkedIn profile](https://docs.groovin.ai/reference/api/get-profile.md) |
| `send_linkedin_message` | Send one LinkedIn message from your account to one person or conversation. | Write, **never repeat blindly** | [Send a LinkedIn message](https://docs.groovin.ai/reference/api/send-message.md) |
| `send_linkedin_invitation` | Send one connection invitation from your account, with an optional note. | Write, **never repeat blindly** | [Send a LinkedIn invitation](https://docs.groovin.ai/reference/api/send-invitation.md) |
| `list_linkedin_relations` | See your 1st-degree connections, newest first. Filter by date or name. | Write, safe to repeat | [List your LinkedIn connections](https://docs.groovin.ai/reference/api/list-relations.md) |
| `list_linkedin_pending_invitations` | See the invitations waiting for an answer: the ones you sent, the ones you received, or both. | Write, safe to repeat | [List your pending invitations](https://docs.groovin.ai/reference/api/list-pending-invitations.md) |

## CRM contacts and companies

| Tool | What it does | Declared to your assistant as | Details |
| - | - | - | - |
| `lookup_crm_contacts` | For a list of LinkedIn people, find out who already exists in your CRM. Run this before creating contacts, to avoid duplicates. | Read-only | [Check who is already in your CRM](https://docs.groovin.ai/reference/api/lookup-contacts.md) |
| `create_crm_contacts` | Create contacts in your CRM from LinkedIn people, or link them to a contact that already exists. Companies are found or created along the way. | Write, safe to repeat | [Create CRM contacts](https://docs.groovin.ai/reference/api/create-contacts.md) |
| `list_synced_crm_contacts` | See the CRM contacts whose LinkedIn conversation is synced with Groovin, most recently synced first. | Read-only | [List your synced contacts](https://docs.groovin.ai/reference/api/list-synced-contacts.md) |
| `toggle_linkedin_sync` | Start or stop logging a person's LinkedIn conversation in your CRM, for a batch of contacts. | Write, safe to repeat | [Turn message sync on or off](https://docs.groovin.ai/reference/api/toggle-sync.md) |
| `find_linkedin_profile_url` | Find the LinkedIn URL of CRM contacts that have none, and save it on the contact. Groovin only saves a URL when the evidence is clear. | Write, safe to repeat | [Find missing LinkedIn URLs](https://docs.groovin.ai/reference/api/find-linkedin-urls.md) |
| `find_company_domains` | Find a company's web domain and save it on the CRM record. Send only a company name to try it out without writing anything. | Write, safe to repeat | [Find missing company domains](https://docs.groovin.ai/reference/api/find-company-domains.md) |

## LinkedIn connections import

| Tool | What it does | Declared to your assistant as | Details |
| - | - | - | - |
| `start_linkedin_connections_import` | Import your LinkedIn connections export (`Connections.csv`) into your CRM. A new file is always previewed first. | Write, safe to repeat | [Start a connections import](https://docs.groovin.ai/reference/api/start-connections-import.md) |
| `get_linkedin_connections_import` | See how an import is going, and read its rows. Without `import_id`, you get your most recent one. | Read-only | [Check a connections import](https://docs.groovin.ai/reference/api/get-connections-import.md) |
| `cancel_linkedin_connections_import` | Stop an import that is still running. It cannot be resumed where it left off. | Write, safe to repeat | [Stop a connections import](https://docs.groovin.ai/reference/api/cancel-connections-import.md) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.