SquaredUp (US)

SquaredUp MCP

The official SquaredUp marketplace for AI agents. Install a region plugin and your agent of choice can query and manage your SquaredUp organization - dashboards, the knowledge graph, data streams, KPIs, workspaces, and integrations - through SquaredUp's hosted MCP server.

What you get

• One MCP server for your region - browser OAuth, nothing to configure, no API keys to manage.
• Built-in skills - the server's get_skill tool guides your agent through real SquaredUp workflows: exploring a tenant, reading dashboards, querying data streams and the entity graph, working with KPIs, cloning workspaces, managing integrations, alerting and notification channels, permissions and sharing, scheduled reports, and managing users. There is nothing extra to install.

Choose your agent

Install for Claude Code

1. Add the marketplace

Run this once in any Claude Code session:

/plugin marketplace add squaredup/mcp

2. Install your region

Pick the plugin for the region your SquaredUp organization is hosted in:

/plugin install us@squaredup     # US

/plugin install eu@squaredup     # EU

The region plugin installs only your region's MCP server; the other region is never added.

Not sure which region you're on? Check the URL you use to sign in to SquaredUp - EU tenants use an eu. host.

3. Authenticate

Run /mcp, select your region's server, and sign in. Authentication is browser-based using your existing SquaredUp account - there are no tokens to copy. The first tool call will prompt you if you haven't signed in yet.

Organizations that span both regions

Install both region plugins:

/plugin install us@squaredup

/plugin install eu@squaredup

Both servers will be present. When a task is ambiguous, Claude will ask which region you mean before running any tools, then stick to that region's server for the rest of the task.

Install for Claude desktop and claude.ai

These steps are the same in the Claude desktop app and on claude.ai, with no config files to edit. Either way, the server is saved to your Claude account, so you can use it in chat and Cowork.

As a plugin

1. Open Customize > Plugins, select Add marketplace, and enter squaredup/mcp.
2. Find the plugin for your region (us or eu) and select Add.
3. Open the plugin's Connectors tab, add its server, and select Connect to sign in with your SquaredUp account.

The plugin also reaches Claude Code the next time you start a session signed in to the same account, so you don't need to install it there as well. To pick up new versions, select Check for updates on the marketplace or turn on Sync automatically.

As a custom connector

1. Open Customize > Connectors and select Add custom connector.
2. Enter the server URL for your region (https://mcp.squaredup.com/mcp for US, https://eu.mcp.squaredup.com/mcp for EU) and select Add.
3. Select Connect to sign in.

The Free plan allows one custom connector.

Team and Enterprise plans

Members can't add custom connectors themselves, so an Owner adds the server for the organization first. In Organization settings > Connectors, select Add, then Custom, choose Web if asked, and enter your region's server URL. Members then find it under Customize > Connectors with a Custom label and select Connect. The same applies to the plugin: if its Connectors tab shows the server as Not added, ask an Owner to add it.

Manual MCP configuration (no plugin)

If you'd rather wire the MCP server up directly, add the entry for your region to your Claude Code MCP config.

US:

{

"mcpServers": { "squaredup": { "type": "http", "url": "https://mcp.squaredup.com/mcp" } } }

EU:

{

"mcpServers": { "squaredup": { "type": "http", "url": "https://eu.mcp.squaredup.com/mcp" } } }

The OAuth flow is identical - the first tool call prompts you to sign in. Skills come from the server itself, so you get them with or without the plugin.

Install for other agents

Every option below adds only your region's MCP server. Skills come with the server, so there is nothing else to install. Sign in with your SquaredUp account in the browser when the agent first connects.

One click

VS Code also takes the server from the command line:

code --add-mcp '{"name":"squaredup-us","type":"http","url":"https://mcp.squaredup.com/mcp"}'

VS Code can also install this repo's plugins (an experimental setting). Add the marketplace to your settings, then search the Extensions view for @agentPlugins and install the plugin for your region:

"chat.plugins.marketplaces": ["squaredup/mcp"]

Command line

The commands below are for the US region. For EU, use eu@squaredup, squaredup-eu and https://eu.mcp.squaredup.com/mcp instead.

Codex

Codex reads this repo's marketplace as is:

codex plugin marketplace add squaredup/mcp

codex plugin add us@squaredup

The Codex IDE extension doesn't support plugins. Add the server directly instead; the CLI and the IDE extension share the same config:

codex mcp add squaredup-us --url https://mcp.squaredup.com/mcp

GitHub Copilot CLI

Copilot CLI also reads this repo's marketplace:

copilot plugin marketplace add squaredup/mcp

copilot plugin install us@squaredup

Antigravity CLI

Antigravity CLI installs the region plugin straight from this repo:

agy plugin install https://github.com/squaredup/mcp/tree/main/plugins/us

The plugin is named squaredup-us (squaredup-eu for EU). Install by the region's folder, not the repo root: the root URL installs both regions.

Gemini CLI

Gemini CLI has been replaced by Antigravity CLI for most accounts. If you still use it:

gemini mcp add --transport http squaredup-us https://mcp.squaredup.com/mcp

ChatGPT

In ChatGPT on the web, go to Plugins, select +, then Add custom MCP server. Paste the server URL for your region (https://mcp.squaredup.com/mcp for US, https://eu.mcp.squaredup.com/mcp for EU) and sign in when prompted. Whether you can add custom servers depends on your plan and workspace settings.

Copilot Studio

To use SquaredUp in an agent you build in Copilot Studio, add the server as an MCP tool. You need a Copilot Studio license; a trial can test the agent but can't publish it.

1. Open your agent and, on the Build tab, select + next to Tools.
2. In Add a tool, select + Add > Model Context Protocol (MCP).
3. Fill in the form:

• Server name: SquaredUp
• Server description: the agent uses this to decide when to call SquaredUp, e.g. Query and manage SquaredUp dashboards, data streams, the knowledge graph, and KPIs.
• Server URL: https://mcp.squaredup.com/mcp (US) or https://eu.mcp.squaredup.com/mcp (EU)

1. Under Authentication, choose OAuth 2.0 and leave Configuration type as Dynamic (with discovery). There is no client ID or secret to enter. Select Add.
2. In Select a connection, open the Connection list, select Create new connection, then Create. Sign in with your SquaredUp account in the pop-up and choose your organization if asked. If no pop-up appears, allow pop-ups for Copilot Studio and select Create again.
3. Selec