mcp-server · tago-io — Claude Code MCP server: setup
This MCP server connects an AI assistant to TagoIO accounts. Use it to inspect devices, data, dashboards, and analyses from a coding client.
claude mcp add --env TAGOIO_TOKEN=<TAGOIO_TOKEN> --env TAGOIO_API=<TAGOIO_API> --transport stdio tago-io-mcp-server -- npx -y @tago-io/mcp-serverWhat mcp-server does
mcp-server lets an assistant work with TagoIO resources through natural-language requests. It can inspect device activity, retrieve records, investigate failed analyses, and compare dashboard settings with the data a device sends.
The server also supports account changes: creating devices, drafting dashboards from a description, checking access policies, and handling analysis scripts. Destructive actions, credential rotation, and script uploads go through an assistant confirmation step. The local setup runs the @tago-io/mcp-server package with npx.
A TagoIO Profile Token is required for account access. Without TAGOIO_TOKEN, the server cannot authenticate; some configurations also provide TAGOIO_API.
What it helps with
- find devices that stopped sending data
- diagnose a failed analysis and verify a fix
- create a dashboard from a written layout
- trace a permission error to an access policy
- locate and remove old account files
Example prompts for the agent
- List devices that have stopped reporting and summarize their latest records.
- Inspect the failure in the
Daily Reportanalysis and explain how to correct it. - Create a dashboard for the cold-chain devices with a map and temperature chart.
How to install mcp-server
Platform CLI
claude mcp add --env TAGOIO_TOKEN=<TAGOIO_TOKEN> --env TAGOIO_API=<TAGOIO_API> --transport stdio tago-io-mcp-server -- npx -y @tago-io/mcp-serverReplace <…> with your own values
Platform CLI
codex mcp add tago-io-mcp-server --env TAGOIO_TOKEN=<TAGOIO_TOKEN> --env TAGOIO_API=<TAGOIO_API> -- npx -y @tago-io/mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"tago-io-mcp-server": {
"command": "npx",
"args": [
"-y",
"@tago-io/mcp-server"
],
"env": {
"TAGOIO_TOKEN": "<TAGOIO_TOKEN>",
"TAGOIO_API": "<TAGOIO_API>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"tago-io-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@tago-io/mcp-server"
],
"env": {
"TAGOIO_TOKEN": "<TAGOIO_TOKEN>",
"TAGOIO_API": "<TAGOIO_API>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e TAGOIO_TOKEN=<TAGOIO_TOKEN> -e TAGOIO_API=<TAGOIO_API> tago-io-mcp-server npx -y @tago-io/mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-server
How do I install mcp-server in Claude Code?
Create a TagoIO Profile Token, then run claude mcp add mcp-server -e TAGOIO_TOKEN=<TAGOIO_TOKEN> -- npx -y @tago-io/mcp-server.
What does mcp-server do?
It gives an AI assistant access to TagoIO devices, records, dashboards, and analyses. The assistant can inspect resources and apply account changes after confirmation for sensitive operations.
What credentials does mcp-server need?
The server needs a TagoIO Profile Token. Local configurations can also use the TAGOIO_API environment variable.
Similar MCP servers
All MCP servers for Agent setup: memory, context, orchestration →mcp-server by other authors comes first.
