# Kitetags MCP

> Kitetags gives your AI agent control over high-fidelity asset tracking. It lets you manage physical smart tag portfolios, query real-time location data for tagged equipment, and organize assets into custom groups using natural conversation.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** asset-tracking, inventory-management, location-intelligence, iot-sensors, logistics, metadata-management

## Description

Need to keep track of hundreds of moving parts? This MCP connects your entire asset tracking infrastructure directly into your AI client. You stop manually checking dashboards or cross-referencing spreadsheets. Instead, you talk to your agent about your inventory—ask for a list of all active tags in 'Warehouse A,' and the agent gets it instantly. It lets you maintain a complete logistical overview by querying the last known location of any asset ID. You can also manage your entire organizational structure; for instance, checking which groups exist or creating new ones on demand. All this capability is managed through Vinkius, giving your AI client access to thousands of tools across multiple industries.

## Tools

### check_kitetags_status
Verifies the connection status between your agent and the Kitetags platform.

### create_group
Creates a new, labeled group for organizing related smart tags.

### create_tag
Registers a brand-new physical tag into the system inventory.

### delete_group
Removes an entire group structure from your tag directory.

### delete_tag
Removes a specific tag record from the system.

### get_tag_analytics
Fetches performance metrics and usage data for a specific smart tag.

### get_group
Retrieves full details and metadata for an existing group ID.

### get_tag
Gets all detailed information about a specific tag ID.

### list_group_tags
Lists all tags currently assigned to a designated group ID.

### list_groups
Retrieves a directory of every available tag group name and ID.

### list_tags
Lists all existing tags currently in the system inventory.

### search_tags
Searches across your entire tag database using keywords or criteria.

## Prompt Examples

**Prompt:** 
```
List all active smart tags in my Kitetags account.
```

**Response:** 
```
I've retrieved your tags. You currently have 50 active smart tags, including 'Asset #123' and 'Warehouse B'. Would you like the detailed high-fidelity location metadata for any of them?
```

**Prompt:** 
```
Show the last known location for tag ID 'tag_987'.
```

**Response:** 
```
Accessing location intelligence... Tag tag_987 was last seen at 'Main Distribution Center' at 2:00 PM today. I've retrieved the high-fidelity GPS metadata for your review. Need help monitoring the group status?
```

**Prompt:** 
```
List all tag groups and their current member counts.
```

**Response:** 
```
Group directory orchestrated! I've identified 5 active high-fidelity groups, including 'High Value' (20 tags) and 'Electronics'. I've retrieved the technical metadata and categories for you. Shall I check for unassigned tags?
```

## Capabilities

### Track Asset Location
Query the last known physical location and detailed technical metadata for any tagged asset.

### Manage Tag Inventory
Create, read, update, or delete individual smart tags within your system.

### Structure Asset Groups
List all existing tag groupings, create new organizational containers, and manage group assignments.

### Review Tag Analytics
Retrieve performance data and analytics specific to a given tag ID.

### Monitor System Health
Verify the connection status and overall volume of your tagging system's API.

## Use Cases

### Audit Compliance for a Client Site
The operations team needs to know which high-value equipment was last seen at the client site. They ask their agent to query the location of all tags in the 'Client Assets' group, allowing them to compile an immediate compliance report.

### Reorganizing Inventory Categories
The warehouse needs to separate old equipment from new inventory. Instead of manually moving records, they ask their agent to list all tags in 'Old Stock' and assign them to a newly created group called 'Disposal Queue,' using `list_group_tags` and `create_group`.

### Post-Incident Location Check
After an incident, the team needs immediate status updates. They ask their agent to get the last known location for a specific tag ID, receiving high-fidelity GPS metadata instantly.

## Benefits

- Instantly pull full tag summaries using `list_tags` or the agent's search function. You get a complete, structured overview of all physical assets without opening a dashboard.
- Pinpoint exact asset locations by querying the last known location for any ID. This provides high-fidelity GPS data crucial for live logistics planning.
- Build and refine your organizational structure using `list_groups` and `create_group`. You can maintain complex tag hierarchies directly through conversation with your agent.
- Monitor service health immediately. Use `check_kitetags_status` to verify the API connection, ensuring that mission-critical tracking data is always available when you need it.
- Manage inventory lifecycle using dedicated tools. You can create new assets via `create_tag`, or retire them safely with `delete_tag`, all in one workflow.

## How It Works

The bottom line is: Your AI client treats your asset database like another source of truth, accessible via simple conversation.

1. Subscribe to this MCP on Vinkius, then retrieve your unique API Key from your Kitetags account settings.
2. Direct your AI client (like Cursor or Claude) to use the connector. The agent validates connectivity using `check_kitetags_status`.
3. Ask your agent a question about assets, like 'Show me all tags in the 'High Value' group,' and it executes the necessary calls.

## Frequently Asked Questions

**How do I find my Kitetags API Key?**
Log in to your account, navigate to **Settings** > **API & Integrations**, and copy your unique Access Token.

**Can I see last known locations via AI?**
Yes! The `list_kitetags_tags` tool provides high-fidelity location metadata and timestamps for all your smart tags.

**How do I list my tag groups?**
Use the `list_kitetags_groups` tool to retrieve your complete high-fidelity directory along with the unique identifiers for all managed categories.

**What is the process for adding a new asset using the `create_tag` tool?**
You use `create_tag` to generate a brand-new smart tag record. You must provide all required metadata and specify which existing group the tag belongs to when calling this function.

**How do I check exactly what tags belong to a specific collection using `list_group_tags`?**
The `list_group_tags` tool retrieves every single tag currently assigned to a chosen group. This lets you quickly verify membership counts or identify any missing assets in that category.

**What kind of data does the `get_tag_analytics` tool provide?**
The `get_tag_analytics` function pulls usage metrics and historical data for a specific tag ID. It helps you track activity volume, location changes, or time since the last recorded use.

**If I need to confirm my API connection first, should I run `check_kitetags_status`?**
Running `check_kitetags_status` verifies your account's live link to Kitetags. It confirms the MCP agent can communicate with the service and execute operations successfully.

**What if I only know part of a tag's name? Can I use `search_tags`?**
Yes, the `search_tags` tool lets you find tags using keywords or partial names. This saves time when tracking assets across multiple groups without knowing the exact ID.