In-app MCP server

The In-app MCP server lets AI agents on your computer, such as Claude Code or Cursor, work with Routix Dash on your iPhone or iPad over the local network. They get the same tools as the in-app agent: they can read your configuration, add and change sources and data pieces, write transformers, and check logs.

The agent uses its own AI model. Routix Dash does not send anything to an AI provider for it; the agent connects to the app directly.

What you need

Turn it on

Open the menu → AI settings → In-app MCP server, and turn on MCP server. It is off until you turn it on.

The line under the switch shows the state:

The server uses port 47302, and only that port. If another program already uses it, the app shows an error. To use a different port, tap Port.

Connect an agent

Tap Connect an agent. The screen lists the addresses of this device. Tap the one the agent's computer can reach, then choose:

The copied setups already contain the access token. A JSON setup looks like this:

{
  "mcpServers": {
    "routix-dash-ios": {
      "type": "http",
      "url": "http://192.168.1.20:47302/mcp",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Some clients can only run local commands. For them, use mcp-remote:

npx mcp-remote http://192.168.1.20:47302/mcp --allow-http --header "Authorization: Bearer <token>"

What agents can do

Changes from an agent apply and save right away, like your own edits. Before the first change of a session, the app saves a checkpoint named MCP: before agent edits. You find it in the history of the in-app agent, and the agent can restore it too. While the in-app agent is working, changes from MCP agents are refused; they can try again when it finishes.

At the end of its work the agent can add a short summary to that checkpoint. Tap the checkpoint and choose Summary to see what was done and which problems came up. If the agent writes none, the summary lists the changes it made.

Free plan limit

On Free, agents can read without limit: configuration, status, logs, and help. Changes to the configuration are limited to 25 edit sessions per device.

While the server is on, AI settings → In-app MCP server shows Remaining edit sessions: X of 25. When none are left, changes are refused. The agent gets the message "Free plan: all 25 MCP edit sessions are used. Pro removes the limit." Reading still works.

Pro has no edit limit.

Safety