SquaredUp MCP server
Commit Nov 12, 2026Lets an AI client query and manage SquaredUp dashboards, knowledge graphs, data streams, KPIs, and workspaces.
Also known as squaredup/mcp, us
- Stars
- 3
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.2.1
- Last commit
- Nov 12, 2026
- License
- MIT
What is SquaredUp MCP?
SquaredUp lets an AI client query and manage SquaredUp dashboards, knowledge graphs, data streams, KPIs, and workspaces.
Summary generated from the project's README
About SquaredUp MCP server
SquaredUp provides a hosted MCP server that allows AI agents to interact directly with your SquaredUp organization. Developers can connect various clients like Claude Desktop, Cursor, VS Code, and GitHub Copilot CLI to manage dashboards, knowledge graphs, data streams, and KPIs. The server is organized by region, with specific endpoints for US and EU tenants to ensure data stays within the correct jurisdiction.
Setup is straightforward because it uses browser-based OAuth for authentication, meaning you do not need to manually manage API keys or tokens. Once connected, the get_skill tool enables agents to perform complex workflows such as cloning workspaces, managing integrations, handling user permissions, and configuring alerting channels. This integration turns your AI client into an active participant in your SquaredUp environment, capable of reading entity graphs and managing scheduled reports.
What you can do with it
- 1Manage organizational data assetsAsk your AI agent to query data streams or explore the entity graph within your SquaredUp tenant.
- 2Automate workspace administrationInstruct an agent to clone existing workspaces or manage user permissions and sharing settings.
Written from the project's README. Every use case is checked against a quote from it.
How to install SquaredUp MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall SquaredUp MCP in Claude Code
$ claude mcp add --transport http us https://mcp.squaredup.com/mcpInstall SquaredUp MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"us": {
"url": "https://mcp.squaredup.com/mcp"
}
}
}Install SquaredUp MCP in VS Code
.vscode/mcp.json
{
"servers": {
"us": {
"type": "http",
"url": "https://mcp.squaredup.com/mcp"
}
}
}Install SquaredUp MCP in VS Code CLI
$ code --add-mcp '{"name":"us","type":"http","url":"https://mcp.squaredup.com/mcp"}'Install SquaredUp MCP in Codex
$ codex mcp add us --url https://mcp.squaredup.com/mcpInstall SquaredUp MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.us] url = "https://mcp.squaredup.com/mcp"
Install SquaredUp MCP in Gemini CLI
$ gemini mcp add -s user --transport http us https://mcp.squaredup.com/mcpInstall SquaredUp MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"us": {
"url": "https://mcp.squaredup.com/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablesquaredup/mcp is public and reachablegithub.com/squaredup/mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/squaredup/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubSquaredUp 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_skilltool 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
| Agent | How to install |
|---|---|
| Claude Code | Plugin marketplace |
| Claude desktop and claude.ai | Plugin marketplace or custom connector |
| Cursor | One-click button |
| VS Code | One-click button or code --add-mcp |
| Codex | Plugin marketplace or codex mcp add |
| GitHub Copilot CLI | Plugin marketplace |
| Antigravity CLI | Plugin from this repo |
| Gemini CLI | gemini mcp add |
| ChatGPT | Custom MCP server |
| Copilot Studio | MCP tool in your agent |
| Other MCP clients | Server URL |
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.
| Region | Plugin | Server | Endpoint |
|---|---|---|---|
| US | us@squaredup |
squaredup-us |
https://mcp.squaredup.com/mcp |
| EU | eu@squaredup |
squaredup-eu |
https://eu.mcp.squaredup.com/mcp |
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
- Open Customize > Plugins, select Add marketplace, and enter
squaredup/mcp. - Find the plugin for your region (
usoreu) and select Add. - 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
- Open Customize > Connectors and select Add custom connector.
- Enter the server URL for your region (
https://mcp.squaredup.com/mcpfor US,https://eu.mcp.squaredup.com/mcpfor EU) and select Add. - 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
| Agent | US | EU |
|---|---|---|
| Cursor | ||
| VS Code |
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.
- Open your agent and, on the Build tab, select + next to Tools.
- In Add a tool, select + Add > Model Context Protocol (MCP).
- 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) orhttps://eu.mcp.squaredup.com/mcp(EU)
- Server name:
- 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.
- 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.
- Select Add.
Every SquaredUp tool is on by default. Copilot Studio works best with fewer tools, so select SquaredUp under Tools, turn off Allow all, choose just the tools your agent needs, and select Done. Try the agent on the Preview tab, e.g. ask it to list your SquaredUp workspaces.
To use the agent in Teams and Microsoft 365 Copilot, select + next to Channels, choose Teams + Microsoft 365, and select Add channel, then Publish. The tool's Authentication is End user account by default, so each user signs in with their own SquaredUp account the first time the agent calls a tool.
If you can't add the server, a Power Platform data policy may be blocking custom connectors. Ask your Power Platform admin to allow it.
Other MCP clients
Other MCP clients that support streamable HTTP and OAuth may work, but we've only tested the ones above. Point them at the server URL for your region: https://mcp.squaredup.com/mcp (US) or https://eu.mcp.squaredup.com/mcp (EU). If yours can't sign in, contact SquaredUp support.
Installed the skills with npx skills?
The skills used to be published from this repo for the skills CLI. They now come from the SquaredUp MCP server, so remove the old copies to stop them going stale:
npx skills remove squaredup/mcp -y # project install
npx skills remove squaredup/mcp -g -y # global install
Updating
/plugin marketplace update squaredup
Region plugins are version-pinned, so you receive updates when we publish a new version.
Repository layout
.claude-plugin/marketplace.json # marketplace "squaredup" -> us, eu
plugins/
us/ .mcp.json # squaredup-us -> mcp.squaredup.com
mcp_config.json # the same server for Antigravity
plugin.json, mcp.json # the same plugin in Agent Plugins format, for Copilot CLI and VS Code
server.json # MCP Registry entry (com.squaredup/us)
.m365-plugin/ # Microsoft 365 Copilot app package, zipped on release
eu/ .mcp.json # squaredup-eu -> eu.mcp.squaredup.com
mcp_config.json # the same server for Antigravity
plugin.json, mcp.json # the same plugin in Agent Plugins format, for Copilot CLI and VS Code
server.json # MCP Registry entry (com.squaredup/eu)
.m365-plugin/ # Microsoft 365 Copilot app package, zipped on release
Each region folder is a Claude Code plugin (.claude-plugin/plugin.json) and an Antigravity plugin (.antigravity-plugin/plugin.json). Antigravity can convert a Claude Code plugin on install, but it drops the server URL of an HTTP server, so the region folders carry their own mcp_config.json.
Each manifest has its own version, but US and EU must share it, and every manifest must point at its region's server URL. The Release workflow checks this on every push to main. See CHANGELOG.md for when to bump each one.
SquaredUp MCP questions
How do I add SquaredUp MCP to Claude Code?
Run claude mcp add --transport http us https://mcp.squaredup.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add SquaredUp MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I authenticate with the SquaredUp MCP server?
Authentication is handled via browser-based OAuth using your existing SquaredUp account, so there are no API keys or tokens to manage manually.
What specific tasks can the AI agent perform with this server?
The server provides built-in skills for exploring tenants, reading dashboards, querying data streams and the entity graph, managing KPIs, cloning workspaces, and handling permissions.
Do I need to install anything extra to use the built-in skills?
No, the skills are provided directly by the server itself.
How can I tell if my SquaredUp organization is in the US or EU region?
You can check the URL you use to sign in to SquaredUp; EU tenants use an 'eu.' host.