Expand description
Purpose: Serve ProjectAtlas repository intelligence over MCP.
Native MCP adapter for ProjectAtlas agent integrations.
Structsยง
- Atlas
File ๐Summary Params - MCP parameter payload for deterministic file summaries.
- Atlas
Files ๐Params - MCP parameter payload for ranked file lookup with optional absolute folder routing.
- Atlas
Health ๐Params - MCP parameter payload for bounded health finding lookup.
- Atlas
Health ๐Resolve Params - MCP parameter payload for resolving health findings.
- Atlas
Ignore ๐Mutation Params - MCP parameter payload for ignore mutations.
- Atlas
Init ๐Params - MCP parameter payload for initializing a project.
- Atlas
Lint ๐Params - MCP parameter payload for lint reports.
- Atlas
MapParams ๐ - MCP parameter payload for compatibility map exports.
- Atlas
McpConfig ๐Params - MCP parameter payload for generated MCP config documents.
- Atlas
Outline ๐Params - MCP parameter payload for outlining a file.
- Atlas
Parity ๐Params - MCP parameter payload for parity reports.
- Atlas
Project ๐Params - Optional active-project override accepted by MCP tools.
- Atlas
Purpose ๐Queue Params - MCP parameter payload for bounded task-scoped purpose curation.
- Atlas
Purpose ๐Review Item - MCP payload for one batch purpose review item.
- Atlas
Purpose ๐Review Params - MCP parameter payload for batch purpose review.
- Atlas
Purpose ๐SetParams - MCP parameter payload for setting purpose metadata.
- Atlas
Query ๐Params - MCP parameter payload for ranked node lookup.
- Atlas
Reset ๐Index Params - MCP parameter payload for runtime index cleanup.
- Atlas
Root ๐Params - MCP parameter payload for root diagnostics.
- Atlas
Root ๐SetParams - MCP parameter payload for binding a root.
- Atlas
Scan ๐Params - MCP parameter payload for scanning and symbol refresh.
- Atlas
Search ๐Params - MCP parameter payload for text search.
- Atlas
Session ๐Brief Params - MCP parameter payload for compact agent startup briefs.
- Atlas
SetProject ๐Path Params - MCP parameter payload for selecting the active project.
- Atlas
Slice ๐Params - MCP parameter payload for exact source slices.
- Atlas
Strip ๐Legacy Params - MCP parameter payload for legacy purpose cleanup.
- Atlas
Symbol ๐Relations Params - MCP parameters for legacy, detailed, or closed-analysis relation navigation.
- Atlas
Symbols ๐Params - MCP parameter payload for symbol and relation lookup.
- Atlas
Task ๐Params - MCP parameter payload for task-progress tools.
- Atlas
Token ๐Params - MCP parameter payload for token savings reports.
- Atlas
Watch ๐Once Params - MCP parameter payload for one-shot watcher refresh.
- McpAbsolute
Path ๐ - Canonical absolute path supplied to an MCP path-bearing tool.
- McpBackground
Resource ๐Envelope - Fixed worker partition shared by background indexing tasks in one MCP server.
- McpBrief
Blocker ๐ - One health blocker row for startup briefs.
- McpBrief
Blockers ๐ - Bounded health blocker section.
- McpBrief
Candidate ๐ - Bounded ranked candidate row for startup briefs.
- McpBrief
Limits ๐ - Effective startup brief row limits.
- McpBrief
Policy ๐ - Brief policy fields.
- McpBrief
Recommendation ๐ - One typed startup recommendation.
- McpCompact
Brief ๐Blockers - Compact blocker count; the recommendation carries the exact bounded health call.
- McpCompact
Brief ๐Candidate - Bounded compact ranked candidate row for task startup.
- McpCompact
Brief ๐Limits - Non-default limits and truncation state in the compact startup projection.
- McpCompact
Brief ๐Overview - Compact project counts for task startup.
- McpCompact
Brief ๐Project - Compact selected-project state for the startup path.
- McpCompact
Brief ๐Purpose Handoff - Compact host-owned purpose-curator handoff for startup briefs.
- McpCompact
Brief ๐Recommendation - One typed recommendation in the compact startup projection.
- McpCompact
Coverage ๐Digest - Adapter-local compact coverage projection that leaves shared serialization unchanged.
- McpCompact
Coverage ๐State Counts - Adapter-local sparse coverage counts for the explicit compact summary.
- McpCompact
Detailed ๐Relation Node - Adapter-local compact detailed-relation node without stable-key duplication.
- McpCompact
Detailed ๐Relation Report - Opt-in compact projection of one detailed relation page.
- McpCompact
Detailed ๐Relation Row - One compact detailed-relation row.
- McpCompact
Federated ๐Detailed Relation Report - Compact federated wrapper that preserves cross-root evidence and work.
- McpCompact
Logical ๐Relation - Compact relation facts required for trust and direct navigation.
- McpCompact
Relation ๐Continuation Arguments - Exact result-defining arguments required to resume a detailed relation page.
- McpCompact
Relation ๐Continuation Call - Existing MCP relation call that resumes one exact compact page.
- McpCompact
Relation ๐Occurrence - Compact source occurrence without another copy of the owning relation key.
- McpCompact
Session ๐Brief - Additive compact projection of the compatibility-preserving startup brief.
- McpError
Payload ๐ - Stable serialized schema for MCP error details.
- McpError
Response ๐ - Agent-facing error payload for failed MCP calls.
- McpFile
Summary ๐ - Compact projection used when an agent follows a default startup recommendation.
- McpFile
Summary ๐Payload - Explicit compact file-summary payload with actionable facts and redundant state removed.
- McpFile
Symbol ๐Summary - Compact symbol row that omits empty legacy fields.
- McpIndexed
Root ๐ - Role-typed indexed project root discovered by nearest-project routing.
- McpLint
Report ๐ - MCP response for lint reports.
- McpMap
Report ๐ - MCP response for compatibility map export.
- McpNext
Call ๐ - Direct MCP recovery selector.
- McpPrivacy
Policy ๐ - Privacy contract for capability/settings payloads.
- McpProject
State ๐ - Active
ProjectAtlasdatabase and configuration selected for MCP calls. - McpProject
State ๐Payload - Stable serialized schema for the selected MCP project.
- McpProject
State ๐Response - Agent-facing payload for the selected MCP project.
- McpPurpose
SetPayload ๐ - Stable serialized schema for an MCP purpose update.
- McpPurpose
SetResponse ๐ - Agent-facing payload for an MCP purpose update.
- McpRepo
Key ๐ - Repository-relative path key derived from a typed root/path conversion.
- McpRequest
Cancellation ๐Bridge - Bridge one RMCP request cancellation token into synchronous index work.
- McpResolved
Repo ๐Path - MCP path resolution result with selected-project audit state.
- McpScan
Policy ๐ - Scan policy fields relevant before source reads.
- McpSelected
Project ๐Capability - Selected project identity inside capability/settings payloads.
- McpSelected
Root ๐ - Role-typed selected root for MCP path routing.
- McpSession
Brief ๐ - Agent startup brief payload.
- McpSession
Capabilities ๐ - MCP-session capability/settings payload.
- McpSource
Token ๐Baseline Key - One bounded broad-source token baseline keyed to a complete generation.
- McpStartup
Policy ๐ - Startup policy fields for MCP sessions.
- McpTask
Cancel ๐Response - Task cancellation response.
- McpTask
Progress ๐ - Optional task progress fields.
- McpTask
Record ๐ - One MCP task-progress record.
- McpTask
Registry ๐ - Bounded in-memory registry for MCP task-progress records.
- McpTask
Start ๐Response - Immediate response for one accepted background indexing task.
- McpTask
Status ๐Response - Task status lookup response.
- McpTelemetry
Policy ๐ - Telemetry write policy for this MCP process.
- McpUsage
Intent ๐ - Deferred telemetry payload recorded only after a verified result is accepted.
- McpUsage
Project ๐Binding - Exact root/database/project identity where this MCP process recorded telemetry.
- McpUsage
Project ๐Runtime - Current telemetry identity for one exact selected project binding.
- McpUsage
Runtime ๐ - Mutable bounded telemetry lifecycles shared by all MCP server clones.
- Project
Atlas ๐McpServer - Native
ProjectAtlasMCP server backed by the same services as the CLI.
Enumsยง
- McpBrief
Recommendation ๐Kind - Startup recommendation kinds.
- McpCompact
Relation ๐Resolution - Resolution facts retained by the compact relation projection.
- McpConfig
Validation ๐ - Select whether project-state discovery validates configuration content immediately.
- McpIndex
Status ๐ - Selected index availability.
- McpPath
Scope ๐ - Absolute path routing scope.
- McpPolicy
State ๐ - Two-state policy enum serialized for MCP contracts.
- McpProject
Status ๐ - Status values for MCP project selection responses.
- McpTask
Cancel ๐Result - Task cancellation outcome.
- McpTask
Lookup ๐Status - Task lookup outcome.
- McpTask
Operation ๐ - MCP task operation kind.
- McpTask
State ๐ - MCP task lifecycle state.
- McpUsage
Baseline ๐ - Existing telemetry baseline variants retained across verified-read acceptance.
- Symbol
Relation ๐Stores - Store ownership selected by the existing relation tool request shape.
Constantsยง
- AMBIGUOUS_
NEAREST_ ๐PROJECT_ PATH_ ERROR - Error when lexical and canonical path routing disagree.
- COMPACT_
SESSION_ ๐BRIEF_ DEFAULT_ LIMIT - Default number of rows in an explicitly compact startup brief section.
- CURRENT_
DIR_ ๐ALIAS - Current-directory root alias.
- FOLDER_
NOT_ ๐INSIDE_ INDEXED_ PROJECT_ ERROR - Error when an absolute MCP folder path has no valid indexed project ancestor.
- MCP_
BACKGROUND_ ๐TASK_ SAFE_ CEILING - Maximum background indexing tasks admitted by one MCP server session.
- MCP_
BRIEF_ ๐ARG_ COMPACT - Compact-response argument key used by typed startup recommendations.
- MCP_
BRIEF_ ๐ARG_ FILE - Session-brief argument key for exact repository-relative files.
- MCP_
BRIEF_ ๐ARG_ LIMIT - Session-brief argument key for row limits.
- MCP_
BRIEF_ ๐ARG_ PATTERN - Session-brief argument key for indexed search patterns.
- MCP_
BRIEF_ ๐ARG_ PROJECT_ PATH - Session-brief argument key for per-call project roots.
- MCP_
BRIEF_ ๐ARG_ TASK - Session-brief argument key for host-owned purpose-curation tasks.
- MCP_
BRIEF_ ๐ARG_ VIEW - Session-brief argument key for relation view selection.
- MCP_
BRIEF_ ๐REASON_ FILESYSTEM_ UNTIL_ INDEX - Session-brief reason for filesystem fallback before an index exists.
- MCP_
BRIEF_ ๐REASON_ HEALTH_ BLOCKERS - Session-brief reason for health follow-up.
- MCP_
BRIEF_ ๐REASON_ NO_ FILE_ CANDIDATE - Session-brief reason for normal filesystem orientation in an indexed empty project.
- MCP_
BRIEF_ ๐REASON_ PURPOSE_ QUEUE - Session-brief reason for following an actionable purpose-curator handoff.
- MCP_
BRIEF_ ๐REASON_ RANKED_ FILE_ RELATIONS - Session-brief reason for following truncated graph evidence into detailed relations.
- MCP_
BRIEF_ ๐REASON_ RANKED_ FILE_ SUMMARY - Session-brief reason for following the selected file into its summary.
- MCP_
BRIEF_ ๐REASON_ SEARCH_ FALLBACK - Session-brief reason for searching when ranking found no directly navigable file.
- MCP_
BRIEF_ ๐REASON_ SELECTED_ INDEX_ MISSING - Session-brief reason for missing selected indexes.
- MCP_
BRIEF_ ๐TARGET_ FILESYSTEM_ TOOLS - Session-brief recommendation target for normal filesystem reads.
- MCP_
CANCELLATION_ ๐MONITOR_ START_ ERROR_ PREFIX - Prefix for cancellation-monitor startup failures.
- MCP_
CANCELLATION_ ๐MONITOR_ THREAD_ NAME - Request-local MCP cancellation monitor thread name.
- MCP_
DEFAULT_ ๐CONFIG_ SERVER_ NAME - Default MCP config server key.
- MCP_
ENV_ ๐CI - CI environment variable used by MCP map export safeguards.
- MCP_
ENV_ ๐GITHUB_ ACTIONS - GitHub Actions environment variable used by MCP map export safeguards.
- MCP_
ERROR_ ๐ANALYSIS_ VIEW_ REQUIRED - MCP validation error for analysis controls on another relation view.
- MCP_
ERROR_ ๐COMPACT_ DETAILED_ RELATION_ VIEW - MCP validation error for compact projection on a non-detailed relation view.
- MCP_
ERROR_ ๐COVERAGE_ FILTERS_ REQUIRE_ COVERAGE - Coverage-filter diagnostic for the default structural-health mode.
- MCP_
ERROR_ ๐COVERAGE_ LIMIT_ TOO_ LARGE_ PREFIX - Invalid coverage limit diagnostic prefix.
- MCP_
ERROR_ ๐COVERAGE_ START_ INDEX_ TOO_ LARGE_ PREFIX - Invalid coverage start-index diagnostic prefix.
- MCP_
ERROR_ ๐DETAILED_ RELATION_ DISAMBIGUATOR - MCP validation error for symbol disambiguators without a symbol.
- MCP_
ERROR_ ๐DETAILED_ RELATION_ FILE - MCP validation error for a detailed request without a file anchor.
- MCP_
ERROR_ ๐DETAILED_ RELATION_ LIMIT - MCP validation error for a relation limit outside the service range.
- MCP_
ERROR_ ๐DETAILED_ RELATION_ QUERY - MCP validation error for legacy query fields in detailed requests.
- MCP_
ERROR_ ๐DETAILED_ RELATION_ SYMBOL - MCP validation error for an empty detailed symbol anchor.
- MCP_
ERROR_ ๐FEDERATED_ RELATION_ VIEW - MCP validation error for federation on the legacy relation view.
- MCP_
ERROR_ ๐FOR_ PATH_ FRAGMENT - Ambiguous route diagnostic fragment.
- MCP_
ERROR_ ๐GUIDANCE_ FRAGMENT - Ambiguous route diagnostic fragment.
- MCP_
ERROR_ ๐IGNORE_ KIND_ REQUIRED - Required ignore kind diagnostic.
- MCP_
ERROR_ ๐IGNORE_ KIND_ REQUIRED_ FOR_ ADD - Required ignore kind diagnostic for mutation tools.
- MCP_
ERROR_ ๐INVALID_ HARNESS_ PREFIX - Invalid harness diagnostic prefix.
- MCP_
ERROR_ ๐INVALID_ HARNESS_ SUFFIX - Invalid harness diagnostic suffix.
- MCP_
ERROR_ ๐INVALID_ IGNORE_ KIND_ PREFIX - Invalid ignore kind diagnostic prefix.
- MCP_
ERROR_ ๐INVALID_ IGNORE_ KIND_ SUFFIX - Invalid ignore kind diagnostic suffix.
- MCP_
ERROR_ ๐INVALID_ PURPOSE_ LEVEL_ PREFIX - Invalid purpose lint level diagnostic prefix.
- MCP_
ERROR_ ๐INVALID_ PURPOSE_ LEVEL_ SUFFIX - Invalid purpose lint level diagnostic suffix.
- MCP_
ERROR_ ๐LEXICAL_ ROOT_ FRAGMENT - Ambiguous route diagnostic fragment.
- MCP_
ERROR_ ๐RESOLVED_ ROOT_ FRAGMENT - Ambiguous route diagnostic fragment.
- MCP_
ERROR_ ๐SERIALIZATION_ FALLBACK_ PREFIX - Prefix used only if structured MCP error serialization fails.
- MCP_
ERROR_ ๐SYMBOL_ RELATION_ VIEW - MCP validation error for an unsupported relation view.
- MCP_
ERROR_ ๐TRACE_ TARGET_ FILE_ REQUIRED - MCP validation error for a trace target without its owning file.
- MCP_
ERROR_ ๐TRACE_ TARGET_ KIND_ REQUIRED - MCP validation error for a symbol trace without a symbol-kind selector.
- MCP_
ERROR_ ๐TRACE_ TARGET_ REQUIRED - MCP validation error for symbol disambiguators without a trace symbol.
- MCP_
ERROR_ ๐TRACE_ TARGET_ SIGNATURE_ REQUIRED - MCP validation error for a symbol trace without a signature selector.
- MCP_
ERROR_ ๐UNSUPPORTED_ ANALYSIS_ MODE - MCP validation error for an unsupported closed relation-analysis mode.
- MCP_
ERROR_ ๐UNSUPPORTED_ ANALYSIS_ VCS - MCP validation error for an unsupported VCS impact selector.
- MCP_
ERROR_ ๐VCS_ BASE_ REQUIRED - MCP validation error for a revision-range selection without its base.
- MCP_
ERROR_ ๐VCS_ HEAD_ REQUIRED - MCP validation error for a revision-range selection without its head.
- MCP_
ERROR_ ๐VCS_ REVISION_ FIELDS - MCP validation error for revision fields outside revision-range selection.
- MCP_
EVENT_ ๐ATLAS_ FILES - MCP telemetry event for file calls.
- MCP_
EVENT_ ๐ATLAS_ FILE_ SUMMARY - MCP telemetry event for file-summary calls.
- MCP_
EVENT_ ๐ATLAS_ FOLDERS - MCP telemetry event for folder calls.
- MCP_
EVENT_ ๐ATLAS_ HEALTH - MCP telemetry event for health calls.
- MCP_
EVENT_ ๐ATLAS_ NEXT - MCP telemetry event for next-step recommendation calls.
- MCP_
EVENT_ ๐ATLAS_ OUTLINE - MCP telemetry event for outline calls.
- MCP_
EVENT_ ๐ATLAS_ OVERVIEW - MCP telemetry event for overview calls.
- MCP_
EVENT_ ๐ATLAS_ PURPOSE_ QUEUE - MCP telemetry event for purpose-queue calls.
- MCP_
EVENT_ ๐ATLAS_ SEARCH - MCP telemetry event for search calls.
- MCP_
EVENT_ ๐ATLAS_ SLICE - MCP telemetry event for slice calls.
- MCP_
EVENT_ ๐ATLAS_ SYMBOLS - MCP telemetry event for symbol calls.
- MCP_
EVENT_ ๐ATLAS_ SYMBOL_ RELATIONS - MCP telemetry event for symbol-relation calls.
- MCP_
FILE_ ๐SOURCE_ STATUS_ LIVE - Default source status omitted from compact file-summary payloads.
- MCP_
HARNESS_ ๐CLAUDE_ CODE - MCP harness token for Claude Code config.
- MCP_
HARNESS_ ๐CLAUDE_ CODE_ ALIAS - MCP alternate harness token for Claude Code config.
- MCP_
HARNESS_ ๐CODEX - MCP harness token for Codex config.
- MCP_
HARNESS_ ๐MCP_ JSON - MCP harness token for standard MCP JSON config.
- MCP_
HARNESS_ ๐MCP_ JSON_ ALIAS - MCP alternate harness token for standard MCP JSON config.
- MCP_
HARNESS_ ๐OPENCODE - MCP harness token for
OpenCodeconfig. - MCP_
IGNORE_ ๐KIND_ DIR_ NAME - MCP ignore kind token for directory names.
- MCP_
IGNORE_ ๐KIND_ DIR_ NAME_ ALIAS - MCP alternate ignore kind token for directory names.
- MCP_
IGNORE_ ๐KIND_ PATH_ PREFIX - MCP ignore kind token for path prefixes.
- MCP_
IGNORE_ ๐KIND_ PATH_ PREFIX_ ALIAS - MCP alternate ignore kind token for path prefixes.
- MCP_
INDEX_ ๐TASK_ ID_ PREFIX - Prefix for generated background index task identifiers.
- MCP_
INDEX_ ๐TASK_ LIMIT_ PREFIX - Prefix for active background task limit diagnostics.
- MCP_
INDEX_ ๐TASK_ LIMIT_ SUFFIX - Suffix for active background task limit diagnostics.
- MCP_
INDEX_ ๐WORKER_ NAME_ PREFIX - Prefix for named background index worker threads.
- MCP_
INDEX_ ๐WORKER_ PANIC_ ERROR - Terminal diagnostic when a background worker panics.
- MCP_
INDEX_ ๐WORKER_ SPAWN_ ERROR_ PREFIX - Prefix for background worker spawn failures.
- MCP_
MAP_ ๐SKIPPED_ IN_ CI_ REASON - Compatibility map skip reason in CI.
- MCP_
NO_ ๐ROOT_ PLACEHOLDER - Placeholder when no routed root is available for a diagnostic.
- MCP_
PAYLOAD_ ๐CHART - MCP payload key for optional chart strings.
- MCP_
PAYLOAD_ ๐CONFIG - MCP payload key for effective config reports.
- MCP_
PAYLOAD_ ๐GITIGNORE - MCP payload key for
.gitignoreinitialization reports. - MCP_
PAYLOAD_ ๐HEALTH_ RESOLUTION - MCP payload key for health-resolution reports.
- MCP_
PAYLOAD_ ๐IGNORE - MCP payload key for ignore policy reports.
- MCP_
PAYLOAD_ ๐INIT - MCP payload key for project initialization reports.
- MCP_
PAYLOAD_ ๐LEGACY_ PURPOSE_ MIGRATION - MCP payload key for legacy-purpose migration reports.
- MCP_
PAYLOAD_ ๐LINT - MCP payload key for lint reports.
- MCP_
PAYLOAD_ ๐MAP - MCP payload key for compatibility map reports.
- MCP_
PAYLOAD_ ๐MCP_ CONFIG - MCP payload key for generated MCP config reports.
- MCP_
PAYLOAD_ ๐NEXT - MCP payload key for next-step recommendation reports.
- MCP_
PAYLOAD_ ๐RESET_ INDEX - MCP payload key for reset-index reports.
- MCP_
PAYLOAD_ ๐SCAN - MCP payload key for scan reports.
- MCP_
PAYLOAD_ ๐SELECTED_ PROJECT - MCP payload key for selected-project audit metadata on routed reads.
- MCP_
PAYLOAD_ ๐SESSION_ BRIEF - MCP payload key for agent startup briefs.
- MCP_
PAYLOAD_ ๐SESSION_ CAPABILITIES - MCP session capability payload key.
- MCP_
PAYLOAD_ ๐SETTINGS - MCP payload key for settings reports.
- MCP_
PAYLOAD_ ๐SYMBOLS_ BUILD - MCP payload key for symbol-build reports.
- MCP_
PAYLOAD_ ๐SYMBOL_ RELATIONS - MCP payload key for detailed symbol-relation reports.
- MCP_
PAYLOAD_ ๐TASK_ CANCEL - MCP payload key for task cancellation responses.
- MCP_
PAYLOAD_ ๐TASK_ START - MCP payload key for accepted background tasks.
- MCP_
PAYLOAD_ ๐TASK_ STATUS - MCP payload key for task status lookups.
- MCP_
PAYLOAD_ ๐TOKEN_ SAVINGS - MCP payload key for token savings reports.
- MCP_
PAYLOAD_ ๐TOKEN_ TRENDS - MCP payload key for token trend reports.
- MCP_
PAYLOAD_ ๐WATCH - MCP payload key for watcher reports.
- MCP_
PROJECT_ ๐STATE_ LOCK_ POISONED - MCP error lock-poison message.
- MCP_
PURPOSE_ ๐LEVEL_ LOW - MCP purpose lint level token for low strictness.
- MCP_
PURPOSE_ ๐LEVEL_ MEDIUM - MCP purpose lint level token for medium strictness.
- MCP_
PURPOSE_ ๐LEVEL_ STRICT - MCP purpose lint level token for strict mode.
- MCP_
PURPOSE_ ๐TASK_ QUEUE - Default purpose-curation task used by direct queue requests.
- MCP_
PURPOSE_ ๐TASK_ SESSION_ STARTUP - Default purpose-curation task used by session startup briefs.
- MCP_
RELATION_ ๐ANALYSIS_ MODE_ ARCHITECTURE - Default closed relation-analysis mode.
- MCP_
RELATION_ ๐ANALYSIS_ MODE_ IMPACT - VCS impact relation-analysis mode.
- MCP_
RELATION_ ๐ANALYSIS_ MODE_ TRACE - Static trace relation-analysis mode.
- MCP_
RELATION_ ๐ANALYSIS_ VCS_ INDEX - Staged-index VCS impact selection.
- MCP_
RELATION_ ๐ANALYSIS_ VCS_ REVISION_ RANGE - Explicit revision-range VCS impact selection.
- MCP_
RELATION_ ๐ANALYSIS_ VCS_ WORKING_ TREE - Default working-tree VCS impact selection.
- MCP_
SERVER_ ๐INSTRUCTIONS - Agent-facing MCP server instructions.
- MCP_
SERVER_ ๐NAME ProjectAtlasMCP server display name.- MCP_
SETTINGS_ ๐RESPONSE_ LIMIT_ PREFIX - Prefix for an oversized settings-response diagnostic.
- MCP_
SETTINGS_ ๐RESPONSE_ LIMIT_ SEPARATOR - Separator for the observed and permitted settings-response byte counts.
- MCP_
SETTINGS_ ๐RESPONSE_ LIMIT_ SUFFIX - Suffix for an oversized settings-response diagnostic.
- MCP_
SETTINGS_ ๐RESPONSE_ MAX_ BYTES - Hard ceiling for the default agent-facing settings diagnostic.
- MCP_
SOURCE_ ๐TOKEN_ BASELINE_ LIMIT - Maximum generation/filter token baselines retained by one MCP process.
- MCP_
SYMBOL_ ๐RELATION_ CONFIDENCE_ DEFAULT - Default minimum confidence for detailed MCP symbol-relation requests.
- MCP_
SYMBOL_ ๐RELATION_ DIRECTION_ DEFAULT - Default direction for detailed MCP symbol-relation requests.
- MCP_
SYMBOL_ ๐RELATION_ RESOLUTION_ DEFAULT - Default resolution filter for detailed MCP symbol-relation requests.
- MCP_
SYMBOL_ ๐RELATION_ VIEW_ ANALYSIS - Additive closed analysis view on the existing relation route.
- MCP_
SYMBOL_ ๐RELATION_ VIEW_ DETAILED - Additive detailed MCP symbol-relation view name.
- MCP_
SYMBOL_ ๐RELATION_ VIEW_ LEGACY - Compatible MCP symbol-relation view name.
- MCP_
TASK_ ๐CONTRACT_ ID - Built-in task id that exposes the task-progress contract itself.
- MCP_
TASK_ ๐ERROR_ MAX_ CHARS - Maximum concise task failure text retained in the session registry.
- MCP_
TASK_ ๐PROGRESS_ ACCEPTED - Progress message recorded after task admission.
- MCP_
TASK_ ๐PROGRESS_ CANCELED - Progress message recorded after cooperative cancellation completes.
- MCP_
TASK_ ๐PROGRESS_ CANCELLATION_ REQUESTED - Progress message recorded after cancellation is requested.
- MCP_
TASK_ ๐PROGRESS_ COMPLETE - Progress message recorded after successful task completion.
- MCP_
TASK_ ๐PROGRESS_ CONTRACT_ MESSAGE - Built-in task-progress contract message.
- MCP_
TASK_ ๐PROGRESS_ FAILED - Progress message recorded after task failure.
- MCP_
TASK_ ๐PROGRESS_ RUNNING - Progress message recorded while task work is active.
- MCP_
TASK_ ๐REGISTRY_ CAPACITY - Bounded MCP task registry capacity.
- MCP_
TASK_ ๐REGISTRY_ LOCK_ POISONED - Task-registry synchronization failure diagnostic.
- MCP_
TELEMETRY_ ๐PROJECT_ BINDING_ LIMIT - Maximum distinct project bindings whose MCP telemetry can be sealed at shutdown.
- MCP_
TOOL_ ๐ATLAS_ CONFIG - MCP tool name for effective config reports.
- MCP_
TOOL_ ๐ATLAS_ FILES - MCP tool name for file ranking.
- MCP_
TOOL_ ๐ATLAS_ FILE_ SUMMARY - MCP tool name for file summaries.
- MCP_
TOOL_ ๐ATLAS_ FOLDERS - MCP tool name for folder ranking.
- MCP_
TOOL_ ๐ATLAS_ HEALTH - MCP tool name for health pages.
- MCP_
TOOL_ ๐ATLAS_ HEALTH_ RESOLVE - MCP tool name for health resolutions.
- MCP_
TOOL_ ๐ATLAS_ IGNORE_ ADD - MCP tool name for adding manual ignore entries.
- MCP_
TOOL_ ๐ATLAS_ IGNORE_ INIT_ GITIGNORE - MCP tool name for project
.gitignoreinitialization. - MCP_
TOOL_ ๐ATLAS_ IGNORE_ LIST - MCP tool name for ignore policy reports.
- MCP_
TOOL_ ๐ATLAS_ IGNORE_ REMOVE - MCP tool name for removing manual ignore entries.
- MCP_
TOOL_ ๐ATLAS_ INIT - MCP tool name for project initialization.
- MCP_
TOOL_ ๐ATLAS_ LINT - MCP tool name for lint reports.
- MCP_
TOOL_ ๐ATLAS_ MAP - MCP tool name for compatibility map exports.
- MCP_
TOOL_ ๐ATLAS_ MCP_ CONFIG - MCP tool name for generated MCP config documents.
- MCP_
TOOL_ ๐ATLAS_ NEXT - MCP tool name for next-step recommendations.
- MCP_
TOOL_ ๐ATLAS_ OUTLINE - MCP tool name for file outlines.
- MCP_
TOOL_ ๐ATLAS_ OVERVIEW - MCP tool name for repository overviews.
- MCP_
TOOL_ ๐ATLAS_ PARITY_ REPORT - MCP tool name for parity reports.
- MCP_
TOOL_ ๐ATLAS_ PURPOSE_ QUEUE - MCP tool name for purpose queue lookup.
- MCP_
TOOL_ ๐ATLAS_ PURPOSE_ REVIEW - MCP tool name for purpose reviews.
- MCP_
TOOL_ ๐ATLAS_ PURPOSE_ SET - MCP tool name for purpose updates.
- MCP_
TOOL_ ๐ATLAS_ RESET_ INDEX - MCP tool name for runtime index reset.
- MCP_
TOOL_ ๐ATLAS_ ROOT - MCP tool name for root diagnostics.
- MCP_
TOOL_ ๐ATLAS_ ROOT_ SET - MCP tool name for binding a project root.
- MCP_
TOOL_ ๐ATLAS_ RUNTIME_ INFO - MCP tool name for runtime identity reports.
- MCP_
TOOL_ ๐ATLAS_ SCAN - MCP tool name for repository scans.
- MCP_
TOOL_ ๐ATLAS_ SEARCH - MCP tool name for indexed search.
- MCP_
TOOL_ ๐ATLAS_ SESSION_ BRIEF - MCP tool name for compact agent startup briefs.
- MCP_
TOOL_ ๐ATLAS_ SETTINGS - MCP tool name for settings reports.
- MCP_
TOOL_ ๐ATLAS_ SET_ PROJECT_ PATH - MCP tool name for active project selection.
- MCP_
TOOL_ ๐ATLAS_ SLICE - MCP tool name for source slices.
- MCP_
TOOL_ ๐ATLAS_ STRIP_ LEGACY_ PURPOSE - MCP tool name for legacy purpose cleanup.
- MCP_
TOOL_ ๐ATLAS_ SYMBOLS - MCP tool name for symbol lookup.
- MCP_
TOOL_ ๐ATLAS_ SYMBOLS_ BUILD - MCP tool name for symbol builds.
- MCP_
TOOL_ ๐ATLAS_ SYMBOL_ RELATIONS - MCP tool name for symbol relation lookup.
- MCP_
TOOL_ ๐ATLAS_ TASK_ CANCEL - MCP tool name for task-progress cancellation.
- MCP_
TOOL_ ๐ATLAS_ TASK_ STATUS - MCP tool name for task-progress status lookup.
- MCP_
TOOL_ ๐ATLAS_ TOKEN_ REPORT - MCP tool name for token reports.
- MCP_
TOOL_ ๐ATLAS_ WATCH_ ONCE - MCP tool name for one-shot watcher refreshes.
- MCP_
TOOL_ ๐ATLAS_ WATCH_ STATUS - MCP tool name for watcher status.
- NODE_
LABEL_ ๐FILES - Node payload label for rendered file rows.
- NODE_
LABEL_ ๐FOLDERS - Node payload label for rendered folder rows.
- OUTSIDE_
SELECTED_ ๐PROJECT_ GUIDANCE - Recovery guidance when a path escapes the selected
ProjectAtlasroot. - PATH_
NOT_ ๐INSIDE_ INDEXED_ PROJECT_ ERROR - Error when an absolute MCP file path has no valid indexed project ancestor.
- PROJECTATLAS_
CONFIG_ ๐FILE_ NAME - Project-local nested config filename.
- PROJECTATLAS_
DB_ ๐FILE_ NAME ProjectAtlasSQLitedatabase filename.- PROJECTATLAS_
DIR_ ๐NAME ProjectAtlaslocal state directory name.- PROJECTATLAS_
FLAT_ ๐CONFIG_ FILE_ NAME - Project-local flat config filename.
- REQUIRED_
MCP_ ๐TOOL_ NAMES - MCP tools required for the agent-first repository-intelligence surface.
- SELECTED_
ROOT_ ๐ASSERTION_ GUIDANCE - Recovery guidance when a path names a subfolder rather than another selected root.
- SESSION_
BRIEF_ ๐DEFAULT_ LIMIT - Default number of rows in an agent startup brief section.
- SESSION_
BRIEF_ ๐MAX_ LIMIT - Maximum number of rows in an agent startup brief section.
- SEVERITY_
EXPECTED_ ๐FINAL_ SEPARATOR - Final separator for diagnostic lists of accepted severity names.
- SEVERITY_
EXPECTED_ ๐SEPARATOR - Separator for diagnostic lists of accepted severity names.
- START_
LINE_ ๐REQUIRED_ ERROR - Error when a line slice omits its start line.
- SYMBOL_
DISAMBIGUATOR_ ๐WITHOUT_ SYMBOL_ ERROR - Error when a symbol disambiguator is supplied without a symbol name.
- TOKEN_
CHART_ ๐THEME_ ERROR_ PREFIX - Token chart theme validation error prefix.
- TOKEN_
CHART_ ๐THEME_ ERROR_ SUFFIX - Token chart theme validation error suffix.
- TOKEN_
OVERVIEW_ ๐RESULT_ VARIANT_ MISMATCH - Internal mismatch when an overview request returns the trends variant.
- TOKEN_
TRENDS_ ๐RESULT_ VARIANT_ MISMATCH - Internal mismatch when a trend request returns the overview variant.
- TOKEN_
TREND_ ๐BENCHMARK_ ERROR - Validation error for benchmark evidence on token trend requests.
- TOKEN_
TREND_ ๐WINDOW_ ERROR_ SUFFIX - Token trend validation error suffix.
- WATCH_
STATUS_ ๐SCAN_ RECOMMENDATION - Watch-status recommendation when no index exists.
Functionsยง
- bounded_
task_ ๐error - Retain one concise task failure without letting diagnostics grow unbounded.
- compact_
file_ ๐symbols - Project nonempty symbol rows into their compact MCP representation.
- coverage_
query_ ๐from_ params - Convert explicit MCP coverage parameters into one typed bounded DB query.
- expected_
health_ ๐severity_ names - Render accepted health severity names for diagnostics.
- has_
coverage_ ๐filters - Return whether MCP parameters contain coverage-only filters.
- health_
query_ ๐from_ params - Convert MCP health parameters into a DB health query.
- is_
compact_ ๐brief_ default_ limit - Return whether a startup row limit is the compact projection default.
- is_
false ๐ - Return whether a serialized optional fact is false and can be omitted.
- is_true ๐
- Return whether a serialized invariant is true and can be omitted.
- is_
zero_ ๐u32 - Return whether a compact unsigned count is zero.
- is_
zero_ ๐u64 - Return whether a compact unsigned total is zero.
- mcp_
tool_ ๐route_ present - Return whether the generated RMCP router has a concrete tool route.
- mcp_
unix_ ๐time_ ms - Return current Unix time in milliseconds for MCP task status records.
- missing_
ancestor_ ๐error - Build the adapter error for an absolute selector without an inspectable ancestor.
- nonempty_
slice ๐ - Borrow non-empty rows into one optional compact section.
- nonempty_
str ๐ - Borrow non-empty text into one optional compact field.
- parse_
health_ ๐severity - Parse an MCP health severity filter.
- purpose_
queue_ ๐scope - Return the DB scope for MCP purpose queue parameters.
- relation_
analysis_ ๐controls_ present - Return whether any closed analysis-only control was supplied.
- relation_
analysis_ ๐trace_ target - Decode and validate the optional exact trace target.
- relation_
analysis_ ๐vcs - Decode and validate the optional VCS impact selector.
- required_
mcp_ ๐surface_ present - Return whether the generated RMCP router contains required tool families.
- run_
mcp_ ๐server - Run the official RMCP stdio server.
- task_
error_ ๐is_ canceled - Recognize cooperative cancellation through each typed adapter error layer.
- trimmed_
filter ๐ - Return a trimmed non-empty string parameter.