@atlascompiler/mcp
Advanced tools
Official Model Context Protocol (MCP) server for Atlas - Deterministic Zero-LLM Web Compiler
The official Model Context Protocol (MCP) server for Atlas.
Connects AI coding assistants, agents, and LLMs (Cursor, Claude Desktop, Windsurf, ChatGPT, MCP Inspector) directly to Atlas's zero-LLM web compilation pipeline. Provides deterministic, clean markdown extraction, site topology discovery, batch compilation, and bounded crawling without LLM hallucinations or context bloat.
2026-07-28 protocol era with native prompt caching hints (cacheHints: { ttlMs, cacheScope }) and asynchronous task tracking via io.modelcontextprotocol/tasks.npx @atlascompiler/mcp or configure directly into desktop IDEs.POST /mcp for remote clients and web agents.--api-key, -k) with exit code 1 to eliminate secret exposure in ps aux and process inspection.WHERE workspace_id = ?1 AND id = ?2) on all atlas:// resources.Origin blocking prevents browser-based cross-origin drive-by attacks.atlas-egress for zero-trust SSRF protection.Run the 1-click interactive setup wizard to validate your API key and automatically configure your desktop editors (Claude Desktop, Cursor, VS Code, Windsurf):
# Interactive mode (prompts for scope: Global, Project, or Both):
npx -y @atlascompiler/mcp init
# Or preselect scope directly via CLI flags:
npx -y @atlascompiler/mcp init --global # User-level (Claude, ~/.cursor, Windsurf)
npx -y @atlascompiler/mcp init --project # Repo-level (.cursor/mcp.json, .vscode/mcp.json)
npx -y @atlascompiler/mcp init --both # Both user-level and project-level
npx -y @atlascompiler/mcp init --skip-editors # Save credentials only
The wizard:
atlas_...).~/.atlas/credentials.json (POSIX 0600 permissions).mcpServers) from VS Code workspace format (servers).Once configured via init, you can run the MCP server with zero flags or environment variables:
npx -y @atlascompiler/mcp
In automated pipelines, containerized environments, or ephemeral workers, supply credentials via the ATLAS_API_KEY environment variable:
export ATLAS_API_KEY="atlas_your_api_key_here"
npx -y @atlascompiler/mcp
Security Note: Passing API keys via CLI flags (
--api-keyor-k) is strictly prohibited and blocked by the CLI to avoid process table inspection leaks. Always useinitor theATLAS_API_KEYenvironment variable.
| Command | Description |
|---|---|
npx @atlascompiler/mcp | Start stdio MCP server for Claude, Cursor, and other MCP clients. |
npx @atlascompiler/mcp init | Interactive credential setup wizard, editor config, and Agent Skill install. |
npx @atlascompiler/mcp init --global | Setup credentials and configure user-level editors (Claude, ~/.cursor, Windsurf). |
npx @atlascompiler/mcp init --project | Setup credentials and configure repo-level editors (.cursor, .vscode). |
npx @atlascompiler/mcp skill | Install canonical Atlas Agent Skill into project (.agents/skills/atlas/SKILL.md). |
npx @atlascompiler/mcp skill --global | Install canonical Atlas Agent Skill globally (~/.agents/skills/atlas/SKILL.md). |
npx @atlascompiler/mcp whoami | Inspect active credentials and resolution source (env vs ~/.atlas/credentials.json). |
npx @atlascompiler/mcp logout | Clear saved credentials from ~/.atlas/credentials.json. |
npx @atlascompiler/mcp --help | Show command line usage. |
Atlas publishes an official Agent Skill for AI coding agents (Claude Code, Cursor, Antigravity, Windsurf) providing progressive disclosure playbooks for web compilation, scraping, mapping, crawling, and batch extraction.
@atlascompiler/mcp CLI (Fastest)# In your current project:
npx -y @atlascompiler/mcp skill
# Or globally for all projects:
npx -y @atlascompiler/mcp skill --global
npx skills)# Via domain discovery (RFC 8615):
npx skills add atlas-compiler.com
# Or via GitHub repository:
npx skills add redcliffe0003/Atlas
curl -fsSL https://atlas-compiler.com/skill.md -o .agents/skills/atlas/SKILL.md
Because @atlascompiler/mcp resolves credentials directly from ~/.atlas/credentials.json, your editor configuration files never need hardcoded API keys!
Add the server to your Cursor MCP settings (~/.cursor/mcp.json for global, or .cursor/mcp.json in your repository for project scope):
{
"mcpServers": {
"atlas": {
"command": "npx",
"args": ["-y", "@atlascompiler/mcp"]
}
}
}
Add the server to your project's .vscode/mcp.json:
{
"servers": {
"atlas": {
"command": "npx",
"args": ["-y", "@atlascompiler/mcp"]
}
}
}
Note: VS Code expects the root key
"servers", whereas Cursor, Claude Desktop, and Windsurf use"mcpServers". Theatlas-mcp initwizard automatically applies the correct format for each editor target.
Add the server to your Claude Desktop configuration:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json~/.config/Claude/claude_desktop_config.json{
"mcpServers": {
"atlas": {
"command": "npx",
"args": ["-y", "@atlascompiler/mcp"]
}
}
}
Add the server to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"atlas": {
"command": "npx",
"args": ["-y", "@atlascompiler/mcp"]
}
}
}
POST /mcp)For remote agents or the official MCP Inspector:
https://api.atlas-compiler.com/mcpAuthorization: Bearer atlas_YOUR_API_KEY_HEREContent-Type: application/jsonAccept: application/jsonGET /.well-known/oauth-protected-resource.atlas_compileCompile any web page into a structured, high-density markdown document optimized for LLM reasoning.
{
url: string; // Required: Absolute HTTP/HTTPS URL
format?: 'markdown' | 'semantic'; // 'semantic' includes heading boundaries & section IDs
max_output_chars?: number; // Maximum characters to return in the tool response (default: 25000)
include_toc?: boolean; // Prepend a structured Table of Contents (default: true)
force_fresh?: boolean; // Bypass CDN and cache layers (default: false)
}
Example Agent Invocation:
"Compile the Stripe payment intents documentation at
https://docs.stripe.com/api/payment_intentsand show me the API parameters."
atlas_scrapeFast, lightweight single-page extraction when deep compilation isn't required.
{
url: string; // Required: Absolute HTTP/HTTPS URL
formats?: Array<'markdown' | 'links' | 'text'>; // Formats to extract (default: ['markdown'])
max_output_chars?: number; // Capping threshold (default: 20000)
timeout_ms?: number; // Maximum fetch timeout (default: 15000)
}
Example Agent Invocation:
"Scrape the main text and links from
https://news.ycombinator.com."
atlas_mapDiscover site topology, sitemaps, and reachable URLs on a target domain without downloading page bodies.
{
url: string; // Required: Root URL or domain
limit?: number; // Maximum URLs to return (1-500, default: 100)
include_subdomains?: boolean; // Follow subdomains (default: false)
sitemap?: 'include' | 'only' | 'ignore'; // Sitemap handling strategy (default: 'include')
}
Example Agent Invocation:
"Map the documentation pages on
https://docs.github.comso we know what guides are available."
atlas_batch_compileCompile multiple pages in parallel (up to 20 URLs) with per-document success/failure aggregation.
{
urls: string[]; // Required: Array of 1 to 20 URLs
format?: 'markdown' | 'semantic'; // Content format
max_output_chars_per_page?: number; // Character cap per document (default: 15000)
}
Example Agent Invocation:
"Compile these 3 release note pages simultaneously:
['https://site.com/v1', 'https://site.com/v2', 'https://site.com/v3']."
atlas_crawlBounded crawl of a website starting from a seed URL with link discovery, depth limits, and path filtering.
{
url: string; // Required: Seed URL to begin crawling
max_pages?: number; // Maximum pages to process (1-20, default: 10)
max_depth?: number; // Maximum link hops (1-3, default: 2)
include_paths?: string[]; // URL path substrings to require (e.g. ['/docs/', '/guides/'])
exclude_paths?: string[]; // URL path substrings to skip (e.g. ['/changelog/', '/blog/'])
}
Example Agent Invocation:
"Crawl up to 10 pages in
/docs/starting fromhttps://example.com/docs/welcome."
atlas://)The server exposes deterministic resource URIs that allow AI agents to retrieve full document contents on demand without polluting tool call logs:
| Resource URI Template | Description |
|---|---|
atlas://compilations/{id} | Complete compiled markdown document corresponding to compilation {id}. |
atlas://compilations/{id}/sections/{section_id} | Specific heading section or slice from compilation {id}. |
atlas://crawls/{id} | Full crawl manifest, discovered URLs, HTTP status codes, and artifact pointers. |
All resource reads enforce workspace tenant isolation (WHERE workspace_id = ?1 AND id = ?2). Cross-tenant access fails closed with ATLAS_RESOURCE_NOT_FOUND to eliminate data leakage.
You can also embed and customize @atlascompiler/mcp inside your own Node.js or TypeScript applications:
import { createAtlasMcpServer } from '@atlascompiler/mcp';
import { StdioServerTransport } from '@modelcontextprotocol/server';
const server = createAtlasMcpServer({
context: {
apiKey: process.env.ATLAS_API_KEY,
baseUrl: 'https://api.atlas-compiler.com',
},
});
const transport = new StdioServerTransport();
await server.connect(transport);
const server = createAtlasMcpServer({
scrapeExecutor: async (args) => ({
url: args.url,
markdown: '# Mock Content',
status: 200,
}),
});
| Variable | Required | Default | Description |
|---|---|---|---|
ATLAS_API_KEY | Yes | — | Your Atlas workspace API key (atlas_...). |
ATLAS_BASE_URL | No | https://api.atlas-compiler.com | Base URL of the Atlas API or self-hosted backend. |
# Install dependencies
pnpm install
# Run unit and conformance tests (Vitest)
pnpm test
# Check types
pnpm typecheck
# Check code formatting & linting (Biome)
pnpm lint
# Build ESM & TypeScript declaration bundle
pnpm build
MIT © Atlas Compiler
FAQs
Official Model Context Protocol (MCP) server for Atlas - Deterministic Zero-LLM Web Compiler and Scraper for AI Agents
The npm package @atlascompiler/mcp receives a total of 276 weekly downloads. As such, @atlascompiler/mcp popularity was classified as not popular.
We found that @atlascompiler/mcp demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Threat Research
Malicious Firefox extensions mimic Phantom, Jupiter, and Bitget wallets to steal recovery phrases and private keys, with one fetching its payload remotely.
Product
Socket Threat Intel now shows which malware campaigns were blocked or detected in your organization, with links to scans and Firewall events.
Security News
Fixes for eMudhra and Brotli are out. Getting them everywhere they’re needed means tracking down bundled libraries, runtimes, and certificate stores.