TagoIO

by tago-io

Not rated
GitHub

About

Interact with your TagoIO account to access devices, data, and platform resources for development and intelligent data analysis.

Details

Author
tago-io
Categories
Cloud Service, Other, Infrastructure, API

Setup

Install TagoIO in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/tago-io/mcp-server

Follow the installation instructions in the repository README, then restart your MCP client.

Work on your TagoIO account by asking. Your AI assistant reads your devices, data, dashboards, and analyses, and makes the changes you ask for, from your IDE or chat tool.
- Get a token.Generate a Profile Token inTagoIO Profile Settings.
- Add the server to your client.Use an install button above, or copy the config for your tool from
Client setup.
- Ask something.Try:"List my devices and tell me which ones stopped sending data this week."

Your client connects to the TagoIO hosted server athttps://mcp.ai.tago.io. You can alsorun the server yourself.

The server gives your assistant around 80 focused capabilities across your account. You describe the outcome, and it picks the tools. Some things that work well today:

- "Which devices haven't sent data in the last 7 days?"
- "Show me the last 50 records from Water Meter 12 and summarize the flow variable."
- "Create a device on my LoRaWAN network, then give me its token."

- "The Daily Report analysis failed last night. Read the console and tell me why."
- "Fix the bug you found, upload the script, and run it once to confirm."
- "A customer says their dashboard is empty. Log in as that user and check what they see."

- "Build a dashboard for my cold chain fleet: a map of the units, a temperature line chart for the last 24 hours, and a card for battery level."
- "This gauge shows no value. Compare its configuration to the variables the device actually sends."

- "My analysis gets a permission error writing to the Sites entity. What policy does it need?"
- "Show me every access policy that touches TagoRUN users."

- "How close am I to my data records limit this month?"
- "Find stored files older than a year and larger than 5 MB, then delete them."

- "Find the official example for parsing a Dragino LHT65 payload and adapt it to my device."

The server reads and writes. Deleting data, rotating credentials, and uploading scripts run through your assistant's confirmation flow, so you approve each change before it lands.

Each config below points at the hosted server. ReplaceYOUR-TAGOIO-TOKENwith your Profile Token.

Add to.vscode/mcp.jsonfor one project, or to User Settings for all of them. VS Code Insiders takes the same config, and Copilot reads the same file.

{ "servers": { "@tago-io/mcp": { "type": "http", "url": "https://mcp.ai.tago.io", "headers": { "Authorization": "Bearer ${input:tagoToken}" } } }, "inputs": [ { "type": "promptString", "id": "tagoToken", "description": "TagoIO Profile Token", "password": true } ] }
claude mcp add-json tagoio '{"type":"http","url":"https://mcp.ai.tago.io","headers":{"Authorization":"Bearer YOUR-TAGOIO-TOKEN"}}'
{ "mcpServers": { "@tago-io/mcp": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.ai.tago.io", "--header", "Authorization: Bearer YOUR-TAGOIO-TOKEN" ] } } }
{ "mcpServers": { "@tago-io/mcp": { "url": "https://mcp.ai.tago.io", "headers": { "Authorization": "Bearer YOUR-TAGOIO-TOKEN" } } } }
{ "mcpServers": { "@tago-io/mcp": { "serverUrl": "https://mcp.ai.tago.io", "headers": { "Authorization": "Bearer YOUR-TAGOIO-TOKEN" } } } }

OpenSettings>Tools>AI Assistant>Model Context Protocol (MCP), add a server, and paste:

{ "servers": { "@tago-io/mcp": { "url": "https://mcp.ai.tago.io", "requestInit": { "headers": { "Authorization": "Bearer YOUR-TAGOIO-TOKEN" } } } } }
{ "mcpServers": { "@tago-io/mcp": { "httpUrl": "https://mcp.ai.tago.io", "headers": { "Authorization": "Bearer YOUR-TAGOIO-TOKEN" } } } }
{ "mcpServers": { "@tago-io/mcp": { "url": "https://mcp.ai.tago.io", "headers": { "Authorization": "Bearer YOUR-TAGOIO-TOKEN" } } } }
{ "mcpServers": { "@tago-io/mcp": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.ai.tago.io", "--header", "Authorization: Bearer YOUR-TAGOIO-TOKEN" ] } } }

Connect through themcp-remotebridge, in.kiro/mcp.jsonat your project root.

{ "mcpServers": { "@tago-io/mcp": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.ai.tago.io", "--header", "Authorization: Bearer YOUR-TAGOIO-TOKEN" ] } } }

In Agent Builder or ChatGPT MCP settings:

- Server URL:https://mcp.ai.tago.io
- Protocol: Streamable HTTP
- Authentication:Authorization: Bearer YOUR-TAGOIO-TOKENheader

Requests go to US East by default. Set thex-tagoio-regionheader to reach a different endpoint:

For TagoDeploy, pass your instance's full API endpoint overhttps://. This works on the hosted server, so a dedicated instance needs the same one-line config as a public region.

Over STDIO there are no headers. SetTAGOIO_APIto your endpoint instead.

Run the server on your own machine for offline work, or when your network blocks outbound connections. InstallNode.js 22.12or newer, then:

npx -y @tago-io/mcp-server # STDIO, what desktop apps and IDEs expect npx -y @tago-io/mcp-server http # HTTP on port 3000

STDIO reads the token from the environment:

{ "mcpServers": { "@tago-io/mcp": { "command": "npx", "args": ["-y", "@tago-io/mcp-server"], "env": { "TAGOIO_TOKEN": "YOUR-TAGOIO-TOKEN" } } } }
claude mcp add @tago-io/mcp-server -e TAGOIO_TOKEN=YOUR-TAGOIO-TOKEN -- npx -y @tago-io/mcp-server

HTTP mode takes the token per request, so several people can share one server with their own credentials. Set the port withMCP_PORT, and checkGET /healthto confirm the server is up. To point any config in this README at your local server, swap the URL forhttp://localhost:3000. Runnpx -y @tago-io/mcp-server --helpfor the full option list.

Custom widgets are React components with a strict authoring contract: a provider wrapper, pinnednpm:dependencies, a// tailwindmarker. The server validates your code against that contract and reports what breaks it.

Thecustom widget skillteaches the contract itself, with worked examples. Install it for Claude Code:

# all projects mkdir -p ~/.claude/skills/custom-widget-development curl -fsSL https://raw.githubusercontent.com/tago-io/mcp-server/master/skills/custom-widget-development/SKILL.md \ -o ~/.claude/skills/custom-widget-development/SKILL.md # one project mkdir -p .claude/skills/custom-widget-development curl -fsSL https://raw.githubusercontent.com/tago-io/mcp-server/master/skills/custom-widget-development/SKILL.md \ -o .claude/skills/custom-widget-development/SKILL.md

For other clients, put the same file wherever that client loads skills or reusable prompts from.

The server strips your token from every result, error, script download, and console output before it reaches your assistant. Environment variable values, minted analysis tokens, and signed file URLs get the same treatment.

Some settings stay in the TagoIO admin: TagoRUN environment configuration, SSO and custom domains, test emails, and anonymous user creation.

It won't connect.Confirm the token is still valid and thathttps://mcp.ai.tago.iois reachable from your network. If your account lives in EU West, set thex-tagoio-regionheader.

Authentication error.Over HTTP the header readsBearer YOUR-TOKEN, with the space. Over STDIO the token goes inTAGOIO_TOKEN. If the format checks out, the token may lack permission for what you asked.

A request comes back empty.Two usual causes: the device has no data in the window you asked about, or your profile lacks access to that device.

The bridge fails(Claude Desktop, Warp, Kiro). Check for Node.js 22.12 or newer, then run the bridge by hand to read the real error:

npx -y mcp-remote https://mcp.ai.tago.io --header "Authorization: Bearer YOUR-TOKEN"

Every tool the server exposes, grouped by domain. Each one carries its own parameters, limits, and read or write annotation in the description your client reads.

Issues and pull requests are welcome. Agent instructions live inAGENTS.md.

Built by the TagoIO team. Need a hand? Check theTagoIO documentationor contact support.

Interact with the Flespi telematics platform API for fleet management, device tracking, and telemetry data processing.

Access the Cumulocity IoT platform to manage devices, measurements, and alarms.

Digi Remote Manager MCP allows users to connect Ai Agents to their Digi Remote Manager account for analyzing fleet data and help with troubleshooting.

Interact with Qlik Cloud applications and extract data from visualizations using the Qlik Cloud API.

Integrates with the Slide API for device and infrastructure management.

Interfaces with the Space Frontiers API, enabling language models to interact with its data sources.

Administer Tableau Cloud with AI-powered tools. This server offers complete API coverage, enterprise-grade logging, and a production-ready architecture.

MCP server that exposes Ubidots IoT data, entities, and aggregations for AI assistants.

A high-performance MCP server providing structured, real-time price data for AI hardware across global marketplaces, built with a focus on agent-native discovery over hardcoded endpoints.

Blynk's MCP server lets AI coding tools create device templates, manage devices, and read live sensor data on the Blynk IoT platform

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.