← back
connect via mcp
Atlas implements the Model Context Protocol (spec 2025-11-25) over Streamable HTTP, with OAuth 2.1 + Dynamic Client Registration for modern clients and a Bearer-token fallback for everything else.
endpoints
- MCP endpoint
https://atlas.studiomaui.dev/api/mcp- Server card
https://atlas.studiomaui.dev/.well-known/mcp/server-card.json- OAuth metadata
https://atlas.studiomaui.dev/.well-known/oauth-authorization-server
two ways to authenticate
OAuth (recommended)
Modern clients (Cursor, ChatGPT, Claude Code) auto-register and walk you through the consent flow. No token to copy.
Personal access token
For clients that prefer a static Bearer token. Issue one in /settings (sign in first).
client setup
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows). Quit and restart Claude after saving.
{
"mcpServers": {
"atlas": {
"type": "http",
"url": "https://atlas.studiomaui.dev/api/mcp",
"headers": {
"Authorization": "Bearer atlas_pat_YOUR_TOKEN_HERE"
}
}
}
}what your AI can do
submit_idea— publish the current conversation (or a clean pitch) to Atlas. Returns the public URL.search_ideas— semantic search to check whether anyone has already explored a topic before going deep.resources/atlas://ideas/recent— pull the last 50 ideas as raw context.resources/atlas://ideas/{id}— single idea by id (resource template).
security
- · OAuth 2.1 with mandatory PKCE (S256). No client secrets stored.
- · Tokens scoped to one Atlas user account.
- · Source chats private by default — opt in to publish per idea.
- · Rate limit 60 calls/min per token.
- · Every call logged in
mcp_callsaudit table. - · Revoke any token from /settings or via the
/api/oauth/revokeendpoint (RFC 7009).
spec compliance
- · MCP spec 2025-11-25 (Streamable HTTP transport)
- · OAuth 2.1 + RFC 7591 (Dynamic Client Registration)
- · RFC 8414 (OAuth Authorization Server Metadata)
- · RFC 9728 (OAuth Protected Resource Metadata)
- · RFC 7009 (Token Revocation)
- · SEP-1649 server-card.json + SEP-1960 .well-known/mcp manifest
Trouble connecting? Open an issue at github.com/MauryaHG/atlas.