# Konnektive MCP

> Konnektive MCP connects your AI agent to e-commerce data, letting you manage orders, query customer profiles, and audit transactions instantly. You can retrieve detailed order information, search the CRM for specific accounts, and track billing records—all without leaving your chat client.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** order-management, crm, transaction-auditing, payment-processing, customer-data

## Description

This connector gives your agent full visibility into your online shop's operations. Need to know if an order shipped or what campaign generated it? The agent handles that. It pulls up detailed customer profiles from the CRM, letting you check account status and purchase history on demand. You can search across payment transactions using filters to track down discrepancies, or list available products when a user asks about stock. Plus, you'll get access to system audit logs if something looks wrong. Since Vinkius hosts this MCP in their catalog, your agent talks directly to the core Konnektive systems, giving you reliable data right where you are working.

## Tools

### query_konnektive_orders
Runs filtered searches across all orders placed in Konnektive for reporting or status checks.

### get_order_details
Fetches comprehensive details for a single, specific order ID.

### query_konnektive_customers
Searches the customer database using filters to find multiple users based on criteria like name or email.

### get_customer_details
Retrieves specific details for a single, identified customer account.

### query_konnektive_transactions
Searches payment records using filters to verify transaction details and amounts.

### list_billing_campaigns
Gets an inventory of all active and past marketing campaigns used for billing purposes.

### list_konnektive_products
Lists every product available through Konnektive, useful for inventory checks.

### update_order_shipping_address
Changes the shipping address on a specific order after receiving the new, validated address data.

### list_fulfillment_houses
Returns a list of all physical fulfillment centers associated with the store.

### get_konnektive_audit_logs
Pulls system audit logs using provided filters to track activity across the Konnektive platform.

## Prompt Examples

**Prompt:** 
```
List all orders from yesterday
```

**Response:** 
```
Searching Konnektive for orders placed yesterday… I've found 150 orders. Total revenue: $4,500. 120 are 'Shipped', 30 are 'Pending'. Would you like to see the pending ones?
```

**Prompt:** 
```
Show details for order 'ORD-12345'
```

**Response:** 
```
Retrieved order 'ORD-12345'. Customer: John Doe. Items: 2x 'Premium Supplement'. Status: Shipped via FedEx. Shipping to: 123 Main St, NY. Would you like to track the package?
```

**Prompt:** 
```
Find customer with email 'jane@example.com'
```

**Response:** 
```
Searching CRM… Found Jane Smith (ID: 98765). She has placed 3 orders in the last 6 months with a total value of $250. Current status is 'Active'.
```

## Capabilities

### Customer Data Retrieval
Finds detailed records for specific customers or runs filtered searches across your entire user base.

### Order Status Management
Pulls full details on any order, including shipping status and billing information. You can also update the shipping address if needed.

### Financial Auditing
Queries payment transactions using filters to verify payments or reviews system logs for compliance checks.

### Inventory and Campaign Lookup
Lists all available products, active marketing campaigns, and fulfillment centers so your agent has the current business context.

## Use Cases

### Customer calls needing an address change
A customer calls because their package needs to go to a new corporate office. Instead of telling them to log into the portal, you ask your agent to run `get_order_details`, confirm the order ID, and then use `update_order_shipping_address` immediately.

### Investigating payment discrepancies
A billing analyst notices a discrepancy. They query Konnektive using `query_konnektive_transactions`, filtering by date range and amount, to pinpoint the exact transaction record that needs follow-up.

### Running end-of-month reports
A manager wants a report on all orders placed last month. They ask their agent to run `query_konnektive_orders`, applying date filters, which gives them the total volume and revenue instantly.

### Onboarding new fulfillment centers
The logistics team needs to know all available shipping points. They simply ask their agent to execute `list_fulfillment_houses` to get a current list for integration purposes.

## Benefits

- Saves time on status checks. Instead of switching between three tabs to check an order's shipment details, you get the full picture using `get_order_details` right away.
- Improves data accuracy during support calls. You can search and verify customer records using `query_konnektive_customers`, knowing exactly what account history your agent is pulling.
- Reduces billing disputes. If a client questions a charge, you run a targeted query with `query_konnektive_transactions` to prove where the money came from.
- Handles logistics changes instantly. Need to fix an address? You call `update_order_shipping_address`, and it updates the record directly without needing manual backend access.
- Provides full oversight. Running `get_konnektive_audit_logs` lets you see who changed what, and when they did it—critical for compliance checks.

## How It Works

The bottom line is: your agent uses the Konnektive MCP as a universal dashboard for all e-commerce data.

1. You tell your AI client exactly what data you need, like 'What were the transactions last week?'
2. The MCP translates that natural language request into specific API calls across Konnektive's services.
3. Your agent gets back structured data—a list of orders, customers, or logs—and presents it to you immediately.

## Frequently Asked Questions

**How do I check an order's status using get_order_details?**
You simply ask your agent for 'the details of Order ID XYZ.' The MCP retrieves the full record, including shipping info and billing data. It’s faster than checking the Konnektive portal.

**Can I search customers using query_konnektive_customers?**
Yes. You just need to tell your agent who you're looking for, and it runs a filtered search across all customer records in the CRM. It handles complex filtering logic.

**What is the use of query_konnektive_transactions?**
This tool lets you search payment history by date or amount. If a client says they were double-charged, this is where your agent finds proof using transaction filters.

**How do I update an address with update_order_shipping_address?**
You tell the agent: 'Change the shipping address for Order ID ABC to 456 New St.' The MCP executes the update call, modifying the record directly.

**What happens if my API credentials fail when calling `get_konnektive_audit_logs`?**
The system will return a 401 Unauthorized error. This means your connection needs attention; check the Konnektive dashboard immediately to verify that both your API Login ID and password are current and correct.

**How does the tool handle filtering multiple product categories using `list_konnektive_products`?**
The function accepts a JSON string for filters. You can specify arrays of SKU prefixes or product types to narrow down results across the entire catalog, keeping your data pulls highly specific.

**Are there rate limits when running complex searches using `query_konnektive_orders`?**
Yes, the API enforces standard rate limiting. If you need to pull a high volume of order data, chunk your requests into smaller batches or check Konnektive's documentation for their dedicated bulk endpoint.

**What specific information does `get_customer_details` provide beyond basic contact info?**
It pulls the complete customer profile, including a summary of their purchase history and calculated lifetime value. This gives your agent a full view of the client's engagement with Konnektive.

**Where do I find my API Login ID and Password?**
Login to your Konnektive CRM dashboard, go to the **Admin** or **Settings** section, and look for **API Credentials**.

**Can I process refunds with this server?**
The current version focuses on data retrieval and auditing. Financial modifications are currently restricted for security.

**Does this support all fulfillment houses?**
Yes, you can list all configured fulfillment houses using the `list_fulfillment_houses` tool.