@tago-io/mcp-server

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

• Installed Node.js 18+ (https://nodejs.org/en/download/)
• TagoIO account with valid profile token or analysis token
• Compatible AI platform or IDE (see Supported Platforms)

Installation

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-TOKEN",
        "TAGOIO_API": "https://api.us-e1.tago.io"
      }
    }
  }
}

Configuration Parameters:

• Replace YOUR-TOKEN with your TagoIO Profile token or an Analysis Token
  • Using an Analysis token is recommended for better security, as you can limit the token's permissions to only the resources you need. Your analysis must be set to run "External" so you can use the token.
  • Using a Profile token is going to instantly grant the MCP access to your entire profile, but it's not recommended for production environments.
• Update API endpoint to https://api.eu-w1.tago.io for European accounts

Platform-Specific Setup

Claude Desktop

• Download and install Claude Desktop
• Copy the MCP configuration above
• Send the prompt: "Hey Claude, install the following MCP Server" with the configuration
• Claude will automatically install and configure the server

One-Click Install for Development IDEs

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

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

Authentication

The MCP server requires a TagoIO Profile Token for authentication:

• Log into your TagoIO account
• Navigate to Account Settings → Profile Tokens
• Generate a new token with appropriate permissions
• 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 or analysis 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.