# Kontak MCP

> Kontak MCP automates customer communication and message auditing directly through your AI agent. It lets you manage contact books, send SMS messages, and retrieve full transaction histories for both sent and received calls. Connect it via Vinkius to access all your messaging data without logging into a separate platform.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** sms-marketing, call-logs, contact-management, outbound-messaging, unified-communications

## Description

This connection lets your agent handle the day-to-day grind of customer communications. You can ask it to look up specific contacts or list every message ever exchanged, whether that's an SMS or part of a call log. Need to reach out? Your agent sends the text for you using `send_outbound_sms`. The system also keeps track of everything via `get_kontak_audit_logs`, so you can monitor performance and check account settings whenever needed. It’s all about giving your client one central place to manage messaging data, pulling it all together through Vinkius's catalog.

## Tools

### list_kontak_messages
Lists every sent and received message record, providing an overview of communication history.

### get_message_details
Gets the specific content and metadata for one particular message by its ID.

### list_kontak_contacts
Retrieves a complete list of all saved contacts within the Kontak system.

### get_contact_details
Retrieves specific personal details for a single contact using their identifier.

### send_outbound_sms
Sends a new text message to a specified recipient phone number.

### list_kontak_templates
Browses and retrieves the names and content of available message templates.

### list_kontak_tags
Gets a list of all contact tags that can be applied to users.

### get_kontak_account_info
Fetches current account settings and general information about the Kontak service.

### list_kontak_webhooks
Lists all webhooks that are currently configured on the Kontak account for external notifications.

### get_kontak_audit_logs
Pulls a detailed history of system-level actions and events for auditing purposes.

## Prompt Examples

**Prompt:** 
```
List the last 5 messages from my Kontak account
```

**Response:** 
```
Retrieving your message history… I've found 5 recent SMS messages. The last one was sent to +1234567890 with the body 'Your appointment is confirmed'.
```

**Prompt:** 
```
Send an SMS to +1987654321 saying 'Hello from AI'
```

**Response:** 
```
Message sent successfully to +1987654321. Status: Delivered. ID: msg_abc123.
```

**Prompt:** 
```
Find contact named 'Robert'
```

**Response:** 
```
Found one match: Robert Smith (Phone: +1122334455). He is tagged as 'VIP Customer'. Would you like to see his full profile?
```

## Capabilities

### Manage Contact Records
Retrieve specific customer details or list entire contact groups from the address book.

### Send SMS Messages
Draft and send outbound text messages to customers directly through your chat client.

### Audit Communications History
List all sent and received messages, or pull detailed logs of account activity for compliance checks.

### Browse Message Templates
Access a library of pre-written message templates to ensure consistent communication style across campaigns.

### Check Account Status
Fetch current account metadata and webhook configurations for system monitoring.

## Use Cases

### Onboarding a New Client
A new account manager needs to know everything about a lead before calling. They prompt their agent: 'What is Robert's full profile, and what were the last three messages sent?' The agent uses `list_kontak_contacts` first, then calls `get_message_details` for each of the last three interactions.

### Post-Incident Review
The Ops team needs to prove exactly when a system failure occurred. They ask the agent to run `get_kontak_audit_logs`. The agent pulls and filters the necessary records, proving who did what and when.

### Running a Campaign
The marketing team wants to send an urgent update. Instead of manually typing, they ask the agent to use `list_kontak_templates` to select the right message, then execute the outreach using `send_outbound_sms`.

### Data Validation
The developer needs to confirm that their webhook endpoint is receiving data. They ask the agent to check `list_kontak_webhooks`, ensuring all necessary endpoints are configured before launching a new feature.

## Benefits

- Full visibility into customer interactions. Instead of jumping between tabs, you can ask the agent to run `list_kontak_messages` for a complete record of all communication.
- Streamlined outreach means your marketing team doesn't have to copy boilerplate text. Just tell the agent to use an available template and execute the send via `send_outbound_sms`.
- Stay compliant by automating audits. Need proof of activity? The tool for `get_kontak_audit_logs` gives you system-level records instantly, without manual log exports.
- Keep your address book current. Instead of guessing a customer's number, ask the agent to use `list_kontak_contacts` and get accurate contact data immediately.
- Monitor integrations easily. Need to know if an external system is working? Use `get_kontak_account_info` to check credentials and status without logging into the dashboard.

## How It Works

The bottom line is: Once configured, you just talk to your AI client and it does the heavy lifting with Kontak's API.

1. Subscribe to the Kontak MCP on Vinkius, then generate a Bearer Token from your Kontak API settings.
2. Enter that token into the configuration panel connected to your AI client.
3. Your agent now uses the available tools—like `list_kontak_contacts` or `send_outbound_sms`—to perform actions based on natural language commands.

## Frequently Asked Questions

**How do I find a customer's full message history using list_kontak_messages?**
The agent uses `list_kontak_messages` to retrieve the entire log. This gives you an overview of all exchanges, allowing you to pinpoint key dates and topics for your team.

**Can I send a message without knowing if the contact exists first?**
It's safer to check first. Use `list_kontak_contacts` or `get_contact_details` to confirm the number is active before running `send_outbound_sms`. This avoids failed sends.

**What should I use for compliance checks? Is it list_kontak_messages?**
No. For audit trails, you must use `get_kontak_audit_logs`. This tool records system-level actions and metadata changes, which is far more valuable than just message content.

**What if I need to know what templates are available before sending?**
You run `list_kontak_templates` first. This gives you a clean list of all pre-written messages, letting your agent select the correct one for your outreach.

**I want to segment users for a campaign; how do I use `list_kontak_tags`?**
The tool returns an exhaustive list of all tags applied across your account. Your agent can then cross-reference these tags with contact lists or messages to build precise filtering criteria for specific user groups.

**What kind of usage metrics and limits does `get_kontak_account_info` provide?**
This tool pulls your overall account metadata, including current API status and any configured rate limit information. It’s key for monitoring performance and ensuring your automation stays within usage caps.

**I found a message ID; how do I use `get_message_details` to verify its content?**
You supply the unique message ID, and the MCP returns the complete record for that single transaction. This includes timestamps, full body text, and the final delivery status code.

**How do I check which external systems are integrated using `list_kontak_webhooks`?**
This tool lists every webhook you’ve configured on your account. It lets your agent audit exactly where and how data is being pushed out to other connected services.

**How do I get a Kontak API Token?**
Visit your Kontak dashboard, navigate to the **API** or **Developer** section, and generate a new token.

**Does this support sending images via SMS?**
Currently, the server supports text-based SMS messages. MMS/Image support is planned for future updates.

**Can I see my call history?**
Yes, if call logs are enabled in your account, the `list_kontak_messages` tool will include them.