1.0.4 • Published 9 days ago

@tago-io/mcp-server v1.0.4

Weekly downloads
-
License
ISC
Repository
github
Last release
9 days ago

TagoIO | MCP Server

The TagoIO MCP Server enables AI models to interact directly with your TagoIO account, providing contextual access to devices, data, and platform resources for enhanced development workflows and intelligent data analysis.

Features

  • Device Management: Access device information, configurations, and real-time data
  • Data Analysis: Perform statistical operations (sums, averages, reports) on stored data
  • Platform Integration: Retrieve users, actions, analysis scripts, and account statistics
  • Code Generation: AI-powered TagoIO Analysis script generation with proper context
  • Development Support: Debug assistance and tag relationship analysis

Quick Start

Prerequisites

Installation

One-Click Install for Development IDEs

Install MCP Server

Install with NPX in VS Code Install with NPX in VS Code Insiders

Manual Configuration

Create or update your MCP configuration file:

{
  "mcpServers": {
    "@tago-io/mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tago-io/mcp-server"
      ],
      "env": {
        "TAGOIO_TOKEN": "YOUR-PROFILE-TOKEN",
        "TAGOIO_API": "https://api.us-e1.tago.io"
      }
    }
  }
}

Configuration Parameters:

  • Replace YOUR-PROFILE-TOKEN with your TagoIO profile token
  • Update API endpoint to https://api.eu-w1.tago.io for European accounts

Configuration File Locations

PlatformConfiguration Path
Cursor~/.cursor/mcp.json
Windsurf~/.codeium/windsurf/mcp_config.json
Cline~/.cline/mcp_config.json
Claude Desktop~/.claude/mcp_config.json

Platform-Specific Setup

Claude Desktop

  1. Download and install Claude Desktop
  2. Copy the MCP configuration above
  3. Send the prompt: "Hey Claude, install the following MCP Server" with the configuration
  4. Claude will automatically install and configure the server

Development IDEs

Place the configuration file in the appropriate location for your IDE and restart the application.

Supported Platforms

PlatformStatusInstallation Method
Cursor✅ SupportedOne-click install
Windsurf✅ SupportedManual configuration
Claude Desktop✅ SupportedManual configuration
VS Code✅ SupportedOne-click install
Cline✅ SupportedManual configuration

Authentication

The MCP server requires a TagoIO Profile Token for authentication:

  1. Log into your TagoIO account
  2. Navigate to Account SettingsProfile Tokens
  3. Generate a new token with appropriate permissions
  4. Replace YOUR-PROFILE-TOKEN in the configuration

Security Note: Keep your profile token secure and never commit it to version control.

API Endpoints

The server supports both US and European TagoIO instances:

  • US East: https://api.us-e1.tago.io (default)
  • EU West: https://api.eu-w1.tago.io

Troubleshooting

Common Issues

Connection Failed

  • Check your profile token validity
  • Ensure correct API endpoint for your region

Authentication Error

  • Confirm profile token has necessary permissions
  • Verify token format in configuration file

Data Access Issues

  • Check device permissions in your TagoIO account
  • Ensure devices have recent data available

License

This project is licensed under the MIT License - see the LICENSE file for details.


Need Help? Visit the TagoIO Documentation or contact our support team.

1.0.4

9 days ago

1.0.3

10 days ago

1.0.2

10 days ago

1.0.1

10 days ago

1.0.0

10 days ago