@tago-io/mcp-server v1.0.4
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
- TagoIO account with valid profile token
- Compatible AI platform or IDE (see Supported Platforms)
Installation
One-Click Install for Development IDEs
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
Platform | Configuration 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
- 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
Development IDEs
Place the configuration file in the appropriate location for your IDE and restart the application.
Supported Platforms
Platform | Status | Installation Method |
---|---|---|
Cursor | ✅ Supported | One-click install |
Windsurf | ✅ Supported | Manual configuration |
Claude Desktop | ✅ Supported | Manual configuration |
VS Code | ✅ Supported | One-click install |
Cline | ✅ Supported | Manual configuration |
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 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.