Skip to content
MCP server

Atlas

Atlas is a YAML-defined semantic layer for analytics — authored by humans, consumed by…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.0.2
Listing updated
5 days ago

About Atlas

Atlas is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Atlas is a YAML-defined semantic layer for analytics — authored by humans, consumed by AI agents.

Install

Run in a terminal

claude mcp add atlas --env ATLAS_DATASOURCE_URL='<ATLAS_DATASOURCE_URL>' -- npx -y @useatlas/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "atlas": {
      "command": "npx",
      "args": [
        "-y",
        "@useatlas/mcp"
      ],
      "env": {
        "ATLAS_DATASOURCE_URL": "<ATLAS_DATASOURCE_URL>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "atlas": {
      "command": "npx",
      "args": [
        "-y",
        "@useatlas/mcp"
      ],
      "env": {
        "ATLAS_DATASOURCE_URL": "<ATLAS_DATASOURCE_URL>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "atlas": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@useatlas/mcp"
      ],
      "env": {
        "ATLAS_DATASOURCE_URL": "<ATLAS_DATASOURCE_URL>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "atlas": {
      "command": "npx",
      "args": [
        "-y",
        "@useatlas/mcp"
      ],
      "env": {
        "ATLAS_DATASOURCE_URL": "<ATLAS_DATASOURCE_URL>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "atlas": {
      "command": "npx",
      "args": [
        "-y",
        "@useatlas/mcp"
      ],
      "env": {
        "ATLAS_DATASOURCE_URL": "<ATLAS_DATASOURCE_URL>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • ATLAS_DATASOURCE_URLAnalytics datasource URL (postgres, mysql, clickhouse, snowflake, duckdb, bigquery, salesforce). Optional — falls back to a bundled NovaMart SQLite demo when unset.
  • ATLAS_PROVIDERLLM provider: anthropic, openai, bedrock, ollama, openai-compatible, gateway. Optional — the MCP server does not call an LLM directly (the client does); set this only if you also run Atlas's chat or scheduler.
  • ATLAS_API_URLURL of a running Atlas API. Optional — defaults to http://localhost:3001. When set, the MCP server inherits the API's connections, semantic layer, and governance.

Pricing

Open source

Prices change. Check docs.useatlas.dev before you buy.

Atlas FAQ

Is Atlas free?

Yes. Atlas is open source, so you can use and self-host it for free.

How do I add Atlas to Claude Code?

Run this command in your terminal: claude mcp add atlas --env ATLAS_DATASOURCE_URL='<ATLAS_DATASOURCE_URL>' -- npx -y @useatlas/mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers