Connect an AI agent with MCP

The Strovio MCP server, strovio-mcp, lets an MCP client list, upload, inspect and delete your Strovio files. It runs on your computer over stdio, started by the client with npx, and talks to https://strovio.xyz with your API key.

Prerequisites

Node.js 18 or later: node --version. Install from nodejs.org if missing.
A Strovio API key. See Create an account and an API key.
The package is published: npm view strovio-mcp version prints a version. If it prints 404 Not Found, the package is not published yet; use the REST API instead.

Environment

Variable	Required	Value
`STROVIO_API_KEY`	Yes	Your `sk_live_...` key
`STROVIO_API_URL`	No	Defaults to `https://strovio.xyz`. Origin only, no `/api/v1`.

Every client below stores the key in plain text in its own config file (Claude Code in ~/.claude.json, the others in the files named in their sections). Keep those files out of version control and readable only by you.

Claude Code

With the key already in STROVIO_API_KEY (so it does not land in your shell history), on macOS and Linux:

claude mcp add -s user strovio -e STROVIO_API_KEY="$STROVIO_API_KEY" -- npx -y strovio-mcp

Windows (native, not WSL), where npx must run through cmd /c:

claude mcp add -s user strovio -e STROVIO_API_KEY=$env:STROVIO_API_KEY -- cmd /c npx -y strovio-mcp

-s user makes it available in every project; leave it out to add it to the current project only. Options go before --. Check with claude mcp list; strovio should show as connected.

Claude Desktop

Open Settings, then Developer, then Edit Config. On Windows, use "command": "cmd" and "args": ["/c", "npx", "-y", "strovio-mcp"] if the server fails to start. The file is ~/Library/Application Support/Claude/claude_desktop_config.json on macOS and %APPDATA%\Claude\claude_desktop_config.json on Windows. Add:

{
  "mcpServers": {
    "strovio": {
      "command": "npx",
      "args": ["-y", "strovio-mcp"],
      "env": { "STROVIO_API_KEY": "sk_live_..." }
    }
  }
}

Restart Claude Desktop. The Strovio tools appear in the tools menu.

Cursor

Put the same mcpServers block in ~/.cursor/mcp.json for every project, or .cursor/mcp.json in one project. Do not commit a file that contains the key. Open Cursor Settings, then MCP, and check that strovio is enabled with five tools.

Codex

From a terminal on macOS or Linux:

codex mcp add strovio --env STROVIO_API_KEY="$STROVIO_API_KEY" -- npx -y strovio-mcp

On Windows, in PowerShell:

codex mcp add strovio --env STROVIO_API_KEY=$env:STROVIO_API_KEY -- cmd /c npx -y strovio-mcp

Or add to ~/.codex/config.toml (on Windows, %USERPROFILE%\.codex\config.toml):

[mcp_servers.strovio]
command = "npx"
args = ["-y", "strovio-mcp"]
env = { STROVIO_API_KEY = "sk_live_..." }

On Windows, use command = "cmd" and args = ["/c", "npx", "-y", "strovio-mcp"]. Start a new Codex session and run /mcp; strovio should list five tools.

Other MCP clients

Any client that can start a stdio server works. Command npx, arguments -y strovio-mcp, environment STROVIO_API_KEY.

Tools

Tool	Use it to	Arguments
`list_files`	Find files and their exact keys, newest first	`prefix` (optional text the key contains anywhere, so `reports/` also matches `old/reports/`), `limit` (optional, 1 to 100)
`upload_file`	Upload a file from the computer running the server, up to 50 MiB. Replaces a file at the same key.	`filePath` (required), `key` (required, for example `reports/q1.pdf`), `access` (`public` or `private`, default `private`)
`get_file`	Get details and a download URL. Private URLs last one hour.	`key` (required)
`file_exists`	Check whether a file exists without downloading it	`key` (required)
`delete_file`	Permanently delete a file	`key` (required)

Every tool returns JSON as text. Errors return isError: true with a message, the error code and a link to its fix.

upload_file reads filePath on the machine where the MCP server runs, so it suits local agents. The content type is set from the file extension.

Try it

Ask your agent: "List my Strovio files." Then: "Upload ./notes.txt to Strovio as agent-test/notes.txt, private, and give me a download link." Then: "Delete agent-test/notes.txt from Strovio."

Common errors

The server does not start, and its log says "API key is required": STROVIO_API_KEY is not in the server's env block. Clients do not pass your shell's variables to MCP servers unless configured to.
Invalid or missing API key (invalid_api_key ...): the key is mistyped or was deleted. Create a new one at strovio.xyz/developer.
npm error 404 Not Found - GET https://registry.npmjs.org/strovio-mcp: the package is not published yet. Use the REST API.
spawn npx ENOENT or "command not found": Node.js is not installed or not on the client's PATH. Install Node.js 18+, restart the client, and on Windows use the cmd /c form.
Upload body cannot be larger than 50 MiB through the SDK: use a multipart upload with the REST API.
List limit must be an integer from 1 to 100: pass a smaller limit.

Hosted MCP

There is no hosted (remote) Strovio MCP server yet, so browser-based agents such as ChatGPT cannot connect. Use the REST API from any agent that can make HTTP requests.