server.json

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "io.github.GetActionSpace/mcp-context-server",
  "description": "MCP server providing persistent multimodal context storage for LLM agents.",
  "repository": {
    "url": "https://github.com/GetActionSpace/mcp-context-server",
    "source": "github"
  },
  "version": "2.2.2",
  "packages": [
    {
      "registryType": "pypi",
      "registryBaseUrl": "https://pypi.org",
      "identifier": "mcp-context-server",
      "version": "2.2.2",
      "transport": {
        "type": "stdio"
      },
      "environmentVariables": [
        {
          "description": "Log level",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "LOG_LEVEL"
        },
        {
          "description": "Storage backend type: sqlite (default) or postgresql",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "STORAGE_BACKEND"
        },
        {
          "description": "Maximum individual image size in megabytes",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "MAX_IMAGE_SIZE_MB"
        },
        {
          "description": "Maximum total request size in megabytes",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "MAX_TOTAL_SIZE_MB"
        },
        {
          "description": "Custom database file location path",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "DB_PATH"
        },
        {
          "description": "Maximum number of concurrent read connections in the pool",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POOL_MAX_READERS"
        },
        {
          "description": "Connection timeout in seconds",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POOL_CONNECTION_TIMEOUT_S"
        },
        {
          "description": "Close the SQLite writer connection after this many seconds without a write; the next write recreates it",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POOL_IDLE_TIMEOUT_S"
        },
        {
          "description": "Connection health check interval in seconds",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POOL_HEALTH_CHECK_INTERVAL_S"
        },
        {
          "description": "Total attempt budget for failed operations (minimum 1; 1 means one attempt, no retries)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "RETRY_MAX_RETRIES"
        },
        {
          "description": "Base delay in seconds between retry attempts",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "RETRY_BASE_DELAY_S"
        },
        {
          "description": "Maximum delay in seconds between retry attempts",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "RETRY_MAX_DELAY_S"
        },
        {
          "description": "Enable random jitter in retry delays",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "RETRY_JITTER"
        },
        {
          "description": "Exponential backoff multiplication factor for retries",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "RETRY_BACKOFF_FACTOR"
        },
        {
          "description": "Enable SQLite foreign key constraints",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "SQLITE_FOREIGN_KEYS"
        },
        {
          "description": "SQLite journal mode: DELETE, TRUNCATE, PERSIST, MEMORY, WAL or OFF (case-insensitive); any other value is rejected at startup",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "SQLITE_JOURNAL_MODE"
        },
        {
          "description": "SQLite synchronous mode: OFF, NORMAL, FULL, EXTRA or 0-3 (case-insensitive); any other value is rejected at startup",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "SQLITE_SYNCHRONOUS"
        },
        {
          "description": "SQLite temporary storage location: DEFAULT, FILE, MEMORY or 0-2 (case-insensitive); any other value is rejected at startup",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "SQLITE_TEMP_STORE"
        },
        {
          "description": "SQLite memory-mapped I/O size in bytes",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SQLITE_MMAP_SIZE"
        },
        {
          "description": "SQLite cache size (negative value for KB, positive for pages)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SQLITE_CACHE_SIZE"
        },
        {
          "description": "SQLite page size in bytes: a power of two between 512 and 65536; any other value is rejected at startup",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SQLITE_PAGE_SIZE"
        },
        {
          "description": "SQLite WAL autocheckpoint threshold in pages",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SQLITE_WAL_AUTOCHECKPOINT"
        },
        {
          "description": "SQLite busy timeout in milliseconds",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SQLITE_BUSY_TIMEOUT_MS"
        },
        {
          "description": "SQLite WAL checkpoint mode: PASSIVE, FULL, RESTART or TRUNCATE (case-insensitive); any other value is rejected at startup",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "SQLITE_WAL_CHECKPOINT"
        },
        {
          "description": "Server shutdown timeout in seconds",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SHUTDOWN_TIMEOUT_S"
        },
        {
          "description": "Test mode shutdown timeout in seconds",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SHUTDOWN_TIMEOUT_TEST_S"
        },
        {
          "description": "Queue operation timeout in seconds",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "QUEUE_TIMEOUT_S"
        },
        {
          "description": "Test mode queue timeout in seconds",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "QUEUE_TIMEOUT_TEST_S"
        },
        {
          "description": "Circuit breaker failure threshold before opening",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "CIRCUIT_BREAKER_FAILURE_THRESHOLD"
        },
        {
          "description": "Circuit breaker recovery timeout in seconds",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "CIRCUIT_BREAKER_RECOVERY_TIMEOUT_S"
        },
        {
          "description": "Maximum calls admitted per recovery window while the circuit breaker is half-open, and the number of consecutive successes that closes it",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "CIRCUIT_BREAKER_HALF_OPEN_MAX_CALLS"
        },
        {
          "description": "Complete PostgreSQL connection string (overrides individual settings if provided)",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "POSTGRESQL_CONNECTION_STRING"
        },
        {
          "description": "PostgreSQL server host address",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "POSTGRESQL_HOST"
        },
        {
          "description": "PostgreSQL server port number",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_PORT"
        },
        {
          "description": "PostgreSQL database username",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "POSTGRESQL_USER"
        },
        {
          "description": "PostgreSQL database password",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "POSTGRESQL_PASSWORD"
        },
        {
          "description": "PostgreSQL role that owns the tables. Schema setup and migrations connect with the request connection settings (POSTGRESQL_CONNECTION_STRING or the component fields) and this user in place of the request user; unset keeps the request user. Required when ENABLE_POSTGRESQL_RLS=true",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "POSTGRESQL_MIGRATION_USER"
        },
        {
          "description": "Password for POSTGRESQL_MIGRATION_USER, used in place of the request password on the schema setup and migration connection; unset keeps the request password",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "POSTGRESQL_MIGRATION_PASSWORD"
        },
        {
          "description": "PostgreSQL database name",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "POSTGRESQL_DATABASE"
        },
        {
          "description": "PostgreSQL connection pool minimum size",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_POOL_MIN"
        },
        {
          "description": "PostgreSQL connection pool maximum size",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_POOL_MAX"
        },
        {
          "description": "Per-session client cap of an external session-mode pooler (Supabase Session Pooler / Supavisor); advisory threshold for a startup MaxClientsInSessionMode warning when POSTGRESQL_POOL_MAX exceeds it (default 15)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_SESSION_POOLER_MAX_CLIENTS"
        },
        {
          "description": "PostgreSQL connection-pool acquire-wait timeout in seconds (default: 120.0, must be > 0). This is the maximum time a request waits to acquire a connection from the pool (passed per-call to pool.acquire), not the query execution timeout and not the connection establishment timeout (see POSTGRESQL_CONNECT_TIMEOUT_S). For embedding-load robustness, tune POSTGRESQL_POOL_MAX and POSTGRESQL_COMMAND_TIMEOUT_S.",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_POOL_TIMEOUT_S"
        },
        {
          "description": "PostgreSQL connection ESTABLISHMENT timeout in seconds (default: 60.0, the asyncpg default; must be > 0): TCP connect plus startup handshake for each new connection the pool or the pgvector pre-check opens. Distinct from POSTGRESQL_POOL_TIMEOUT_S, which bounds waiting for a free pooled connection, and must be strictly below it: asyncpg bounds the dial by the acquire deadline, so an equal or larger connect budget can never elapse and the pair is refused at startup.",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_CONNECT_TIMEOUT_S"
        },
        {
          "description": "PostgreSQL command execution timeout in seconds (must be > 0)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_COMMAND_TIMEOUT_S"
        },
        {
          "description": "Timeout in seconds for PostgreSQL migration operations (default: 300)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_MIGRATION_TIMEOUT_S"
        },
        {
          "description": "Close idle PostgreSQL connections after this many seconds (0 to disable, default: 300)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_MAX_INACTIVE_LIFETIME_S"
        },
        {
          "description": "Recycle PostgreSQL connections after this many queries (0 to disable, default: 10000)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_MAX_QUERIES"
        },
        {
          "description": "Seconds of idle time before sending first TCP keepalive probe (0 to disable, default: 15)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_TCP_KEEPALIVES_IDLE_S"
        },
        {
          "description": "Seconds between subsequent TCP keepalive probes (0 to disable, default: 5)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_TCP_KEEPALIVES_INTERVAL_S"
        },
        {
          "description": "Number of failed TCP keepalive probes before connection is considered dead (0 to disable, default: 3)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_TCP_KEEPALIVES_COUNT"
        },
        {
          "description": "asyncpg prepared statement cache size. Set to 0 for external pooler compatibility (PgBouncer transaction mode, Pgpool-II, etc.). Default: 100",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_STATEMENT_CACHE_SIZE"
        },
        {
          "description": "Maximum lifetime of cached prepared statements in seconds (default: 300). Has no effect when statement_cache_size=0",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_MAX_CACHED_STATEMENT_LIFETIME_S"
        },
        {
          "description": "Maximum size of statement to cache in bytes (default: 15360). Has no effect when statement_cache_size=0",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_MAX_CACHEABLE_STATEMENT_SIZE"
        },
        {
          "description": "PostgreSQL SSL mode (disable, allow, prefer, require, verify-ca, verify-full)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "POSTGRESQL_SSL_MODE"
        },
        {
          "description": "PostgreSQL schema name for table and index operations (default: public)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "POSTGRESQL_SCHEMA"
        },
        {
          "description": "Semantic search tool registration. Tri-state: auto (default), true, or false. auto registers the semantic_search_context tool when an embedding provider is available (and stays silent otherwise); true registers it when a provider is available, otherwise logs a warning and skips registration (it does not force the tool on without a provider); false skips registration. Embedding storage is provisioned by ENABLE_EMBEDDING_GENERATION, independently of this toggle.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ENABLE_SEMANTIC_SEARCH",
          "default": "auto"
        },
        {
          "description": "Enable embedding generation for stored context. Default true - server fails if dependencies not met. Set false to disable embeddings.",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "ENABLE_EMBEDDING_GENERATION"
        },
        {
          "description": "Ollama API host URL for embedding generation",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "OLLAMA_HOST"
        },
        {
          "description": "Automatically pull missing Ollama models on startup (default: true)",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "OLLAMA_AUTO_PULL"
        },
        {
          "description": "Timeout in seconds for pulling Ollama models (default: 900, range: 30-3600)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "OLLAMA_PULL_TIMEOUT_S"
        },
        {
          "description": "Ollama embedding truncation mode: false (default) returns error when context exceeded, true enables silent truncation",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "EMBEDDING_OLLAMA_TRUNCATE"
        },
        {
          "description": "Ollama embedding context window size in tokens (default: 4096, range: 512-2097152)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "EMBEDDING_OLLAMA_NUM_CTX"
        },
        {
          "description": "Embedding model name for semantic search",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "EMBEDDING_MODEL"
        },
        {
          "description": "Embedding vector dimensions",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "EMBEDDING_DIM"
        },
        {
          "description": "Timeout in seconds for one attempt of one embedding request: one batch of a document's chunks on the store/update path, one query on search (range: >0 to 3600)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "EMBEDDING_TIMEOUT_S"
        },
        {
          "description": "Maximum number of retry attempts for embedding generation",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "EMBEDDING_RETRY_MAX_ATTEMPTS"
        },
        {
          "description": "Base delay in seconds between retry attempts (with exponential backoff)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "EMBEDDING_RETRY_BASE_DELAY_S"
        },
        {
          "description": "Maximum concurrent embedding requests on the store/update path; a chunked document holds one slot per batch and releases it between batches (default: 3, range: 1-20)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "EMBEDDING_MAX_CONCURRENT"
        },
        {
          "description": "Chunks per embedding request when a chunked document is embedded: 'auto' (default) sizes each batch to take about EMBEDDING_BATCH_TARGET_S from the measured seconds per character of chunk text and the lengths of its chunks (1 to 64 chunks); an integer from 1 to 512 fixes the size",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "EMBEDDING_BATCH_SIZE"
        },
        {
          "description": "Wall time in seconds one embedding batch should take when EMBEDDING_BATCH_SIZE is 'auto' (default: 5.0, range: >0 to 3600)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "EMBEDDING_BATCH_TARGET_S"
        },
        {
          "description": "Instruction prefix prepended verbatim to the text embedded for search queries (semantic and hybrid search); document embeddings on the store/update path always stay bare. Unset or empty leaves query text unchanged. Recommended for instruct-aware models such as the default qwen3-embedding:0.6b; cloud models such as OpenAI text-embedding-3-small need no prefix.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "EMBEDDING_QUERY_INSTRUCTION"
        },
        {
          "description": "Enable summary generation for stored context. Default true - server fails if dependencies not met. Set false to disable summaries.",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "ENABLE_SUMMARY_GENERATION"
        },
        {
          "description": "Summary provider: ollama (default), openai, or anthropic",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "SUMMARY_PROVIDER"
        },
        {
          "description": "Summary generation model name (default: qwen3:0.6b)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "SUMMARY_MODEL"
        },
        {
          "description": "Maximum output tokens for summary generation (default: 4000, range: 50-16384). Increase if summaries are truncated by reasoning models",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SUMMARY_MAX_TOKENS"
        },
        {
          "description": "Timeout in seconds for summary generation API calls",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SUMMARY_TIMEOUT_S"
        },
        {
          "description": "Maximum number of retry attempts for summary generation",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SUMMARY_RETRY_MAX_ATTEMPTS"
        },
        {
          "description": "Base delay in seconds between retry attempts (with exponential backoff)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SUMMARY_RETRY_BASE_DELAY_S"
        },
        {
          "description": "Maximum concurrent summary generation operations (default: 2, range: 1-20)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SUMMARY_MAX_CONCURRENT"
        },
        {
          "description": "Custom summarization prompt. Overrides the built-in default. Used as system message for the LLM.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "SUMMARY_PROMPT"
        },
        {
          "description": "Minimum text content length in characters to trigger summary generation (default: 500, range: 0-10000). Set to 0 to always generate.",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SUMMARY_MIN_CONTENT_LENGTH"
        },
        {
          "description": "Ollama summary context window size in tokens (default: 32768, range: 512-2097152)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SUMMARY_OLLAMA_NUM_CTX"
        },
        {
          "description": "Ollama summary truncation mode: false (default) returns error when context exceeded, true enables silent truncation",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "SUMMARY_OLLAMA_TRUNCATE"
        },
        {
          "description": "Presence penalty sent with every Ollama summary call (0-2). Unset: a qwen3 model gets 1.5, the value its model card prescribes against endless repetition with reasoning off; any other model gets no penalty. An explicit value applies to whatever model is configured; 0 disables it",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SUMMARY_OLLAMA_PRESENCE_PENALTY"
        },
        {
          "description": "Reasoning effort level for OpenAI reasoning models (default: low). Valid values vary by generation: gpt-5: low, medium, high; gpt-5.1+: none, low, medium, high, xhigh. Default low is universally valid across all generations",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "SUMMARY_OPENAI_REASONING_EFFORT"
        },
        {
          "description": "Effort level for Anthropic Claude models (default: not sent / omitted). Valid values: max, high, medium, low. Controls inference effort (adaptive thinking)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "SUMMARY_ANTHROPIC_EFFORT"
        },
        {
          "description": "Anthropic API key for summary generation",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "ANTHROPIC_API_KEY"
        },
        {
          "description": "Full-text search tool registration. Tri-state: auto (default), true, or false. auto registers full-text search by default (FTS needs no extra dependencies); true forces registration; false skips it.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ENABLE_FTS",
          "default": "auto"
        },
        {
          "description": "Language for FTS stemming (e.g., english, german, french)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "FTS_LANGUAGE"
        },
        {
          "description": "Characters of context around each FTS match for reranking passage extraction (default: 750)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "FTS_RERANK_WINDOW_SIZE"
        },
        {
          "description": "Merge FTS match regions within this character distance (default: 100)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "FTS_RERANK_GAP_MERGE"
        },
        {
          "description": "Hybrid search tool registration (combines FTS and semantic search with RRF fusion). Tri-state: auto (default), true, or false. auto and true both register hybrid search when at least one of FTS or semantic search is available (otherwise a warning is logged and it is skipped, since hybrid has no underlying mode to fuse and true cannot force it on with neither); false skips it.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ENABLE_HYBRID_SEARCH",
          "default": "auto"
        },
        {
          "description": "grep_context tool registration (server-side literal/regex line-oriented search). Tri-state: auto (default; pure-Python matching, no extra dependencies), true, or false.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ENABLE_GREP_CONTEXT",
          "default": "auto"
        },
        {
          "description": "Hard ceiling applied to grep_context max_matches per request (default 1000).",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "GREP_MAX_MATCHES_CAP"
        },
        {
          "description": "Hard ceiling applied to grep_context context_lines per request (default 20).",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "GREP_MAX_CONTEXT_LINES"
        },
        {
          "description": "Hard ceiling on the number of entries the grep scan visits (default 1000).",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "GREP_MAX_ENTRIES_SCANNED"
        },
        {
          "description": "Approximate resident-memory cap (summed code-point length of fetched text) before a grep scan stops; the first entry that crosses the budget is still scanned (default 67108864).",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "GREP_AGGREGATE_BYTES_BUDGET"
        },
        {
          "description": "Per-entry timeout in seconds for is_regex=true matching (ReDoS guard; a timeout skips that entry, never aborts the read; default 5.0).",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "GREP_REGEX_TIMEOUT_S"
        },
        {
          "description": "Aggregate wall-clock budget in seconds across an entire is_regex=true scan (GREP_REGEX_TIMEOUT_S bounds one entry; this bounds the cumulative scan). When exceeded the scan stops and returns partial results with truncated=true, never aborting the read; default 30.0.",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "GREP_REGEX_TOTAL_TIMEOUT_S"
        },
        {
          "description": "Maximum grep_context pattern length in characters, advertised in the wire schema and re-checked in the tool body (compilation runs before any matching timeout, so an unbounded pattern could stall a request just to compile; default 32768).",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "GREP_MAX_PATTERN_CHARS"
        },
        {
          "description": "read_context_range tool registration (partial read by character or line range). Tri-state: auto (default; no extra dependencies), true, or false.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ENABLE_CONTEXT_RANGE",
          "default": "auto"
        },
        {
          "description": "plan_context_sync and list_ingest_state tool registration (corpus sync planning and stored ingest state). Tri-state: auto (default; no extra dependencies), true, or false.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ENABLE_CONTEXT_SYNC",
          "default": "auto"
        },
        {
          "description": "navigate_context tool registration (code-derived Markdown outline / index_tree). Tri-state: auto (default; pure-Python, no extra dependencies), true, or false.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ENABLE_CONTEXT_NAVIGATION",
          "default": "auto"
        },
        {
          "description": "Generate per-node LLM summaries for the navigate_context index_tree and provision the context_index_nodes table. Additive/never-raise: a node-summary failure never aborts a store. Default true.",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "ENABLE_INDEX_TREE_NODE_SUMMARIES",
          "default": "true"
        },
        {
          "description": "Override the per-node index_tree summary system prompt. Empty resolves to a dedicated short headline-style abstract prompt.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "INDEX_TREE_NODE_SUMMARY_PROMPT"
        },
        {
          "description": "Heading sections shorter than this (characters) skip per-node summary generation (0 = always). Default 500.",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "INDEX_TREE_NODE_SUMMARY_MIN_CONTENT_LENGTH"
        },
        {
          "description": "Per-node summary timeout in seconds; a timeout omits that node, never aborts the store. Default 240.",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "INDEX_TREE_NODE_SUMMARY_TIMEOUT_S"
        },
        {
          "description": "Output token budget of one per-node index_tree summary call (num_predict for Ollama, max_tokens for OpenAI and Anthropic). Default 120, sized for a 25-word headline; an answer cut off at this budget drops that node's summary, so a model that loops on one section never spends SUMMARY_MAX_TOKENS",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "INDEX_TREE_NODE_SUMMARY_MAX_TOKENS"
        },
        {
          "description": "Node-task fan-out cap for per-node index_tree summary coroutines; NOT a second model budget (summary-model concurrency is governed by SUMMARY_MAX_CONCURRENT). Default min(cpu_count, 4).",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "INDEX_TREE_NODE_SUMMARY_MAX_CONCURRENT"
        },
        {
          "description": "Maximum heading sections summarized per entry; bounds TOTAL per-node summary work (the shallowest and longest sections are summarized first). Default 200.",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "INDEX_TREE_NODE_SUMMARY_MAX_NODES"
        },
        {
          "description": "Aggregate wall-clock budget in seconds for the whole per-node summary pass of one entry; on expiry the pass keeps what it produced and never aborts the store. Default 600.",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "INDEX_TREE_NODE_SUMMARY_TOTAL_TIMEOUT_S"
        },
        {
          "description": "RRF smoothing constant for hybrid search (default 60)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "HYBRID_RRF_K"
        },
        {
          "description": "Multiplier for over-fetching results before RRF fusion (default: 2)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "HYBRID_RRF_OVERFETCH"
        },
        {
          "description": "Minimum significant query terms to switch hybrid FTS from AND to OR logic (default: 4)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "HYBRID_FTS_OR_THRESHOLD"
        },
        {
          "description": "Maximum character length for truncated text_content in search results (default: 300, range: 50-1000)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SEARCH_TRUNCATION_LENGTH"
        },
        {
          "description": "Whether get_context_by_ids includes the summary field in each returned entry. Tri-state: when false (default), the summary key is omitted entirely (consumers reading entry.get('summary') receive None -- the conventional Python signal for 'feature disabled'); when true with a stored non-empty summary, the value is returned verbatim; when true but the stored summary is NULL or empty, the value is normalized to an empty string '' (signaling 'feature on, no data yet'). The text_content field always contains the full untruncated text regardless of this toggle. Does not affect search tools, which always emit summary as a string.",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "GET_CONTEXT_BY_IDS_INCLUDE_SUMMARY"
        },
        {
          "description": "Enable text chunking for embedding generation (default: true)",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "ENABLE_CHUNKING"
        },
        {
          "description": "Target chunk size in characters (default: 1500)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "CHUNK_SIZE"
        },
        {
          "description": "Overlap between chunks in characters (default: 150)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "CHUNK_OVERLAP"
        },
        {
          "description": "Chunk score aggregation method: max (only 'max' supported in current version)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "CHUNK_AGGREGATION"
        },
        {
          "description": "Enable cross-encoder reranking of search results (default: true)",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "ENABLE_RERANKING"
        },
        {
          "description": "Reranking provider (default: flashrank)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "RERANKING_PROVIDER"
        },
        {
          "description": "Reranking model name (default: ms-marco-MiniLM-L-12-v2)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "RERANKING_MODEL"
        },
        {
          "description": "Maximum input length for reranking in tokens (default: 512)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "RERANKING_MAX_LENGTH"
        },
        {
          "description": "Directory for caching reranking models",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "RERANKING_CACHE_DIR"
        },
        {
          "description": "Estimated characters per token for passage size validation (default: 4.0, range: 2.0-8.0)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "RERANKING_CHARS_PER_TOKEN"
        },
        {
          "description": "ONNX Runtime intra-operation parallelism threads for reranking (default: 0 = auto-detect)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "RERANKING_INTRA_OP_THREADS"
        },
        {
          "description": "Enable ONNX Runtime CPU memory arena for reranking (default: false)",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "RERANKING_CPU_MEM_ARENA"
        },
        {
          "description": "Maximum passages per ONNX Runtime inference batch during reranking (default: 32)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "RERANKING_BATCH_SIZE"
        },
        {
          "description": "Embedding provider: ollama (default), openai, azure, huggingface, or voyage",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "EMBEDDING_PROVIDER"
        },
        {
          "description": "OpenAI API key for OpenAI embedding provider",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "OPENAI_API_KEY"
        },
        {
          "description": "Custom base URL for OpenAI-compatible APIs",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "OPENAI_API_BASE"
        },
        {
          "description": "OpenAI organization ID",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "OPENAI_ORGANIZATION"
        },
        {
          "description": "Azure OpenAI API key",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "AZURE_OPENAI_API_KEY"
        },
        {
          "description": "Azure OpenAI endpoint URL",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "AZURE_OPENAI_ENDPOINT"
        },
        {
          "description": "Azure OpenAI embedding deployment name",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME"
        },
        {
          "description": "Azure OpenAI API version (default: 2024-02-01)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "AZURE_OPENAI_API_VERSION"
        },
        {
          "description": "HuggingFace Hub API token for HuggingFace embedding provider",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "HUGGINGFACEHUB_API_TOKEN"
        },
        {
          "description": "Voyage AI API key for Voyage embedding provider",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "VOYAGE_API_KEY"
        },
        {
          "description": "Voyage AI truncation mode: false (default) returns error when context exceeded, true enables silent truncation",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "VOYAGE_TRUNCATION"
        },
        {
          "description": "Voyage AI batch size for embedding requests",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "VOYAGE_BATCH_SIZE"
        },
        {
          "description": "Enable LangSmith tracing",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "LANGSMITH_TRACING"
        },
        {
          "description": "LangSmith API key",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "LANGSMITH_API_KEY"
        },
        {
          "description": "LangSmith project name",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "LANGSMITH_PROJECT"
        },
        {
          "description": "LangSmith API endpoint URL",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "LANGSMITH_ENDPOINT"
        },
        {
          "description": "Comma-separated list of metadata fields to index (field:type format)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "METADATA_INDEXED_FIELDS"
        },
        {
          "description": "Index sync mode: strict (fail), auto (sync), warn (log), additive (default, add missing and rebuild drifted, never drop)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "METADATA_INDEX_SYNC_MODE"
        },
        {
          "description": "Transport mode: stdio for local, http for Docker/remote",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "MCP_TRANSPORT"
        },
        {
          "description": "HTTP bind address (use 0.0.0.0 for Docker)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "FASTMCP_HOST"
        },
        {
          "description": "HTTP port number",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "FASTMCP_PORT"
        },
        {
          "description": "Enable stateless HTTP mode for horizontal scaling. Enabled by default as the server has no stateful MCP features. Set to false only if you need server-side MCP session tracking.",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "FASTMCP_STATELESS_HTTP"
        },
        {
          "description": "Comma-separated list of tools to disable (e.g., delete_context,update_context)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "DISABLED_TOOLS"
        },
        {
          "description": "Bearer token for HTTP authentication (required when using SimpleTokenVerifier)",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "MCP_AUTH_TOKEN"
        },
        {
          "description": "Client ID that identifies simple_token requests to FastMCP. Not an owner identity: simple_token requests own entries as ACCESS_CONTROL_DEFAULT_PRINCIPAL",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "MCP_AUTH_CLIENT_ID"
        },
        {
          "description": "Authentication provider: none (default), simple_token, jwt",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "MCP_AUTH_PROVIDER"
        },
        {
          "description": "PEM-encoded public key (asymmetric algorithms) or shared secret (HS* algorithms) for JWT verification. Mutually exclusive with MCP_AUTH_JWT_JWKS_URI; exactly one is required when MCP_AUTH_PROVIDER=jwt",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "MCP_AUTH_JWT_PUBLIC_KEY"
        },
        {
          "description": "JWKS endpoint URI for JWT verification with automatic key rotation. Mutually exclusive with MCP_AUTH_JWT_PUBLIC_KEY; exactly one is required when MCP_AUTH_PROVIDER=jwt",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "MCP_AUTH_JWT_JWKS_URI"
        },
        {
          "description": "Expected issuer (iss) claim value for JWT verification. Unset skips issuer validation",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "MCP_AUTH_JWT_ISSUER"
        },
        {
          "description": "Expected audience (aud) claim value for JWT verification. Unset skips audience validation",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "MCP_AUTH_JWT_AUDIENCE"
        },
        {
          "description": "JWT signing algorithm to accept (default RS256). Supported: HS256/384/512, RS256/384/512, ES256/384/512, PS256/384/512, EdDSA, Ed25519, Ed448",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "MCP_AUTH_JWT_ALGORITHM"
        },
        {
          "description": "PEM-encoded public key (asymmetric algorithms) or shared secret (HS* algorithms) of a second, operator-held verifier that accepts only ACCESS_CONTROL_ANONYMOUS_PRINCIPAL, composed beside the JWKS verifier. Applies only with MCP_AUTH_JWT_JWKS_URI and requires ACCESS_CONTROL_ANONYMOUS_PRINCIPAL; a static-key deployment signs the anonymous token with its own MCP_AUTH_JWT_PUBLIC_KEY counterpart",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "MCP_AUTH_ANONYMOUS_JWT_PUBLIC_KEY"
        },
        {
          "description": "Signing algorithm the anonymous verifier accepts (default RS256; used with MCP_AUTH_ANONYMOUS_JWT_PUBLIC_KEY). Supported: HS256/384/512, RS256/384/512, ES256/384/512, PS256/384/512, EdDSA, Ed25519, Ed448",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "MCP_AUTH_ANONYMOUS_JWT_ALGORITHM"
        },
        {
          "description": "Claim carrying the caller group memberships (default groups). Supports dotted paths and full-URL claim keys",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "MCP_AUTH_GROUPS_CLAIM"
        },
        {
          "description": "Claim carrying the caller roles (default roles). Supports dotted paths and full-URL claim keys",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "MCP_AUTH_ROLES_CLAIM"
        },
        {
          "description": "Principal id stamped as owner_id for every request without a jwt identity: stdio transport and MCP_AUTH_PROVIDER none or simple_token. Also the owner backfilled onto rows that predate the access-control columns. Default local.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ACCESS_CONTROL_DEFAULT_PRINCIPAL",
          "default": "local"
        },
        {
          "description": "Visibility stamped on stored entries when the caller does not specify one: private (owner plus every grantee), public (everyone). Default private.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ACCESS_CONTROL_DEFAULT_VISIBILITY",
          "default": "private"
        },
        {
          "description": "Automatic group read grants on newly inserted entries: none (no automatic grants, default) or author_groups (every group of the writing principal receives a read grant, effective under the default private visibility).",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ACCESS_CONTROL_DEFAULT_GROUP_GRANTS",
          "default": "none"
        },
        {
          "description": "Role required to set visibility public. Unset (default) lets any owner publish; set to a role name to restrict publishing to callers whose verified roles claim carries that role.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ACCESS_CONTROL_PUBLISH_ROLE"
        },
        {
          "description": "Principal id of the read-only jwt subject, matched verbatim against the token sub claim: every write tool refuses it, its groups and roles are discarded, and its token must carry exp. Unset (default) makes no principal read-only, and a value that differs from the minted sub leaves that token an ordinary writable principal, so the startup log names the value. Must differ from ACCESS_CONTROL_DEFAULT_PRINCIPAL.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ACCESS_CONTROL_ANONYMOUS_PRINCIPAL"
        },
        {
          "description": "Also enforce the access model in PostgreSQL through row-level security. Requires STORAGE_BACKEND=postgresql and POSTGRESQL_MIGRATION_USER naming the role that owns the tables; requests must connect as a different role that is a member of POSTGRESQL_RLS_POLICY_ROLE and neither superuser nor BYPASSRLS. Default false.",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "ENABLE_POSTGRESQL_RLS",
          "default": "false"
        },
        {
          "description": "NOLOGIN PostgreSQL role the row-level security policies apply to. The operator creates it and grants it to the request login role; the server grants it the table privileges. 1-63 characters from a-z 0-9 _, not starting with a digit. Default mcp_context_request.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "POSTGRESQL_RLS_POLICY_ROLE",
          "default": "mcp_context_request"
        },
        {
          "description": "Custom server instructions text. Overrides built-in default. Set to empty string to disable.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "MCP_SERVER_INSTRUCTIONS"
        },
        {
          "description": "Enable TurboQuant embedding compression at storage time. Default true. When true (default), fp32 embeddings are replaced with bit-packed compressed payloads (~8x storage reduction at default bits=4). Set to false to opt out and keep fp32 storage.",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "ENABLE_EMBEDDING_COMPRESSION",
          "default": "true"
        },
        {
          "description": "Compression provider. Currently only 'turboquant' is supported.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "COMPRESSION_PROVIDER"
        },
        {
          "description": "Bits per coordinate for compression: 2 (16x), 3 (~11x), 4 (8x). Default 4. Lower bound 2 required by the inner-product variant.",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "COMPRESSION_BITS"
        },
        {
          "description": "Compression variant. 'ip' (default) uses Algorithm 2 with QJL for unbiased inner-product estimation. 'mse' uses Algorithm 1 (L2-optimal reconstruction).",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "COMPRESSION_VARIANT"
        },
        {
          "description": "Rotation matrix seed. Default 0. Pick any stable integer in [0, 4294967295] (the seed is packed into the compressed payload as an unsigned 32-bit field); the value is persisted in compression_metadata at first startup and treated as load-bearing thereafter (mismatching env vs DB raises ConfigurationError(78)).",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "COMPRESSION_SEED",
          "default": "0"
        },
        {
          "description": "Max concurrent compression encode workers dispatched to threads (the CPU-bound codec section is serialized by a process-wide BLAS-limits lock, so this bounds worker fan-out, not CPU parallelism). Separate from I/O-bound EMBEDDING_MAX_CONCURRENT and SUMMARY_MAX_CONCURRENT. Default min(cpu_count, 4).",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "COMPRESSION_MAX_CONCURRENT"
        }
      ]
    },
    {
      "registryType": "oci",
      "identifier": "ghcr.io/getactionspace/mcp-context-server:2.2.2",
      "runtimeHint": "docker",
      "transport": {
        "type": "streamable-http",
        "url": "http://localhost:8000/mcp"
      },
      "environmentVariables": [
        {
          "description": "Log level",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "LOG_LEVEL"
        },
        {
          "description": "Storage backend type: sqlite (default) or postgresql",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "STORAGE_BACKEND"
        },
        {
          "description": "Maximum individual image size in megabytes",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "MAX_IMAGE_SIZE_MB"
        },
        {
          "description": "Maximum total request size in megabytes",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "MAX_TOTAL_SIZE_MB"
        },
        {
          "description": "Custom database file location path",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "DB_PATH"
        },
        {
          "description": "Maximum number of concurrent read connections in the pool",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POOL_MAX_READERS"
        },
        {
          "description": "Connection timeout in seconds",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POOL_CONNECTION_TIMEOUT_S"
        },
        {
          "description": "Close the SQLite writer connection after this many seconds without a write; the next write recreates it",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POOL_IDLE_TIMEOUT_S"
        },
        {
          "description": "Connection health check interval in seconds",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POOL_HEALTH_CHECK_INTERVAL_S"
        },
        {
          "description": "Total attempt budget for failed operations (minimum 1; 1 means one attempt, no retries)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "RETRY_MAX_RETRIES"
        },
        {
          "description": "Base delay in seconds between retry attempts",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "RETRY_BASE_DELAY_S"
        },
        {
          "description": "Maximum delay in seconds between retry attempts",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "RETRY_MAX_DELAY_S"
        },
        {
          "description": "Enable random jitter in retry delays",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "RETRY_JITTER"
        },
        {
          "description": "Exponential backoff multiplication factor for retries",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "RETRY_BACKOFF_FACTOR"
        },
        {
          "description": "Enable SQLite foreign key constraints",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "SQLITE_FOREIGN_KEYS"
        },
        {
          "description": "SQLite journal mode: DELETE, TRUNCATE, PERSIST, MEMORY, WAL or OFF (case-insensitive); any other value is rejected at startup",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "SQLITE_JOURNAL_MODE"
        },
        {
          "description": "SQLite synchronous mode: OFF, NORMAL, FULL, EXTRA or 0-3 (case-insensitive); any other value is rejected at startup",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "SQLITE_SYNCHRONOUS"
        },
        {
          "description": "SQLite temporary storage location: DEFAULT, FILE, MEMORY or 0-2 (case-insensitive); any other value is rejected at startup",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "SQLITE_TEMP_STORE"
        },
        {
          "description": "SQLite memory-mapped I/O size in bytes",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SQLITE_MMAP_SIZE"
        },
        {
          "description": "SQLite cache size (negative value for KB, positive for pages)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SQLITE_CACHE_SIZE"
        },
        {
          "description": "SQLite page size in bytes: a power of two between 512 and 65536; any other value is rejected at startup",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SQLITE_PAGE_SIZE"
        },
        {
          "description": "SQLite WAL autocheckpoint threshold in pages",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SQLITE_WAL_AUTOCHECKPOINT"
        },
        {
          "description": "SQLite busy timeout in milliseconds",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SQLITE_BUSY_TIMEOUT_MS"
        },
        {
          "description": "SQLite WAL checkpoint mode: PASSIVE, FULL, RESTART or TRUNCATE (case-insensitive); any other value is rejected at startup",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "SQLITE_WAL_CHECKPOINT"
        },
        {
          "description": "Server shutdown timeout in seconds",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SHUTDOWN_TIMEOUT_S"
        },
        {
          "description": "Test mode shutdown timeout in seconds",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SHUTDOWN_TIMEOUT_TEST_S"
        },
        {
          "description": "Queue operation timeout in seconds",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "QUEUE_TIMEOUT_S"
        },
        {
          "description": "Test mode queue timeout in seconds",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "QUEUE_TIMEOUT_TEST_S"
        },
        {
          "description": "Circuit breaker failure threshold before opening",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "CIRCUIT_BREAKER_FAILURE_THRESHOLD"
        },
        {
          "description": "Circuit breaker recovery timeout in seconds",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "CIRCUIT_BREAKER_RECOVERY_TIMEOUT_S"
        },
        {
          "description": "Maximum calls admitted per recovery window while the circuit breaker is half-open, and the number of consecutive successes that closes it",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "CIRCUIT_BREAKER_HALF_OPEN_MAX_CALLS"
        },
        {
          "description": "Complete PostgreSQL connection string (overrides individual settings if provided)",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "POSTGRESQL_CONNECTION_STRING"
        },
        {
          "description": "PostgreSQL server host address",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "POSTGRESQL_HOST"
        },
        {
          "description": "PostgreSQL server port number",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_PORT"
        },
        {
          "description": "PostgreSQL database username",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "POSTGRESQL_USER"
        },
        {
          "description": "PostgreSQL database password",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "POSTGRESQL_PASSWORD"
        },
        {
          "description": "PostgreSQL role that owns the tables. Schema setup and migrations connect with the request connection settings (POSTGRESQL_CONNECTION_STRING or the component fields) and this user in place of the request user; unset keeps the request user. Required when ENABLE_POSTGRESQL_RLS=true",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "POSTGRESQL_MIGRATION_USER"
        },
        {
          "description": "Password for POSTGRESQL_MIGRATION_USER, used in place of the request password on the schema setup and migration connection; unset keeps the request password",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "POSTGRESQL_MIGRATION_PASSWORD"
        },
        {
          "description": "PostgreSQL database name",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "POSTGRESQL_DATABASE"
        },
        {
          "description": "PostgreSQL connection pool minimum size",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_POOL_MIN"
        },
        {
          "description": "PostgreSQL connection pool maximum size",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_POOL_MAX"
        },
        {
          "description": "Per-session client cap of an external session-mode pooler (Supabase Session Pooler / Supavisor); advisory threshold for a startup MaxClientsInSessionMode warning when POSTGRESQL_POOL_MAX exceeds it (default 15)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_SESSION_POOLER_MAX_CLIENTS"
        },
        {
          "description": "PostgreSQL connection-pool acquire-wait timeout in seconds (default: 120.0, must be > 0). This is the maximum time a request waits to acquire a connection from the pool (passed per-call to pool.acquire), not the query execution timeout and not the connection establishment timeout (see POSTGRESQL_CONNECT_TIMEOUT_S). For embedding-load robustness, tune POSTGRESQL_POOL_MAX and POSTGRESQL_COMMAND_TIMEOUT_S.",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_POOL_TIMEOUT_S"
        },
        {
          "description": "PostgreSQL connection ESTABLISHMENT timeout in seconds (default: 60.0, the asyncpg default; must be > 0): TCP connect plus startup handshake for each new connection the pool or the pgvector pre-check opens. Distinct from POSTGRESQL_POOL_TIMEOUT_S, which bounds waiting for a free pooled connection, and must be strictly below it: asyncpg bounds the dial by the acquire deadline, so an equal or larger connect budget can never elapse and the pair is refused at startup.",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_CONNECT_TIMEOUT_S"
        },
        {
          "description": "PostgreSQL command execution timeout in seconds (must be > 0)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_COMMAND_TIMEOUT_S"
        },
        {
          "description": "Timeout in seconds for PostgreSQL migration operations (default: 300)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_MIGRATION_TIMEOUT_S"
        },
        {
          "description": "Close idle PostgreSQL connections after this many seconds (0 to disable, default: 300)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_MAX_INACTIVE_LIFETIME_S"
        },
        {
          "description": "Recycle PostgreSQL connections after this many queries (0 to disable, default: 10000)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_MAX_QUERIES"
        },
        {
          "description": "Seconds of idle time before sending first TCP keepalive probe (0 to disable, default: 15)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_TCP_KEEPALIVES_IDLE_S"
        },
        {
          "description": "Seconds between subsequent TCP keepalive probes (0 to disable, default: 5)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_TCP_KEEPALIVES_INTERVAL_S"
        },
        {
          "description": "Number of failed TCP keepalive probes before connection is considered dead (0 to disable, default: 3)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_TCP_KEEPALIVES_COUNT"
        },
        {
          "description": "asyncpg prepared statement cache size. Set to 0 for external pooler compatibility (PgBouncer transaction mode, Pgpool-II, etc.). Default: 100",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_STATEMENT_CACHE_SIZE"
        },
        {
          "description": "Maximum lifetime of cached prepared statements in seconds (default: 300). Has no effect when statement_cache_size=0",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_MAX_CACHED_STATEMENT_LIFETIME_S"
        },
        {
          "description": "Maximum size of statement to cache in bytes (default: 15360). Has no effect when statement_cache_size=0",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "POSTGRESQL_MAX_CACHEABLE_STATEMENT_SIZE"
        },
        {
          "description": "PostgreSQL SSL mode (disable, allow, prefer, require, verify-ca, verify-full)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "POSTGRESQL_SSL_MODE"
        },
        {
          "description": "PostgreSQL schema name for table and index operations (default: public)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "POSTGRESQL_SCHEMA"
        },
        {
          "description": "Semantic search tool registration. Tri-state: auto (default), true, or false. auto registers the semantic_search_context tool when an embedding provider is available (and stays silent otherwise); true registers it when a provider is available, otherwise logs a warning and skips registration (it does not force the tool on without a provider); false skips registration. Embedding storage is provisioned by ENABLE_EMBEDDING_GENERATION, independently of this toggle.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ENABLE_SEMANTIC_SEARCH",
          "default": "auto"
        },
        {
          "description": "Enable embedding generation for stored context. Default true - server fails if dependencies not met. Set false to disable embeddings.",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "ENABLE_EMBEDDING_GENERATION"
        },
        {
          "description": "Ollama API host URL for embedding generation",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "OLLAMA_HOST"
        },
        {
          "description": "Automatically pull missing Ollama models on startup (default: true)",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "OLLAMA_AUTO_PULL"
        },
        {
          "description": "Timeout in seconds for pulling Ollama models (default: 900, range: 30-3600)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "OLLAMA_PULL_TIMEOUT_S"
        },
        {
          "description": "Ollama embedding truncation mode: false (default) returns error when context exceeded, true enables silent truncation",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "EMBEDDING_OLLAMA_TRUNCATE"
        },
        {
          "description": "Ollama embedding context window size in tokens (default: 4096, range: 512-2097152)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "EMBEDDING_OLLAMA_NUM_CTX"
        },
        {
          "description": "Embedding model name for semantic search",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "EMBEDDING_MODEL"
        },
        {
          "description": "Embedding vector dimensions",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "EMBEDDING_DIM"
        },
        {
          "description": "Timeout in seconds for one attempt of one embedding request: one batch of a document's chunks on the store/update path, one query on search (range: >0 to 3600)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "EMBEDDING_TIMEOUT_S"
        },
        {
          "description": "Maximum number of retry attempts for embedding generation",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "EMBEDDING_RETRY_MAX_ATTEMPTS"
        },
        {
          "description": "Base delay in seconds between retry attempts (with exponential backoff)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "EMBEDDING_RETRY_BASE_DELAY_S"
        },
        {
          "description": "Maximum concurrent embedding requests on the store/update path; a chunked document holds one slot per batch and releases it between batches (default: 3, range: 1-20)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "EMBEDDING_MAX_CONCURRENT"
        },
        {
          "description": "Chunks per embedding request when a chunked document is embedded: 'auto' (default) sizes each batch to take about EMBEDDING_BATCH_TARGET_S from the measured seconds per character of chunk text and the lengths of its chunks (1 to 64 chunks); an integer from 1 to 512 fixes the size",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "EMBEDDING_BATCH_SIZE"
        },
        {
          "description": "Wall time in seconds one embedding batch should take when EMBEDDING_BATCH_SIZE is 'auto' (default: 5.0, range: >0 to 3600)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "EMBEDDING_BATCH_TARGET_S"
        },
        {
          "description": "Instruction prefix prepended verbatim to the text embedded for search queries (semantic and hybrid search); document embeddings on the store/update path always stay bare. Unset or empty leaves query text unchanged. Recommended for instruct-aware models such as the default qwen3-embedding:0.6b; cloud models such as OpenAI text-embedding-3-small need no prefix.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "EMBEDDING_QUERY_INSTRUCTION"
        },
        {
          "description": "Enable summary generation for stored context. Default true - server fails if dependencies not met. Set false to disable summaries.",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "ENABLE_SUMMARY_GENERATION"
        },
        {
          "description": "Summary provider: ollama (default), openai, or anthropic",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "SUMMARY_PROVIDER"
        },
        {
          "description": "Summary generation model name (default: qwen3:0.6b)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "SUMMARY_MODEL"
        },
        {
          "description": "Maximum output tokens for summary generation (default: 4000, range: 50-16384). Increase if summaries are truncated by reasoning models",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SUMMARY_MAX_TOKENS"
        },
        {
          "description": "Timeout in seconds for summary generation API calls",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SUMMARY_TIMEOUT_S"
        },
        {
          "description": "Maximum number of retry attempts for summary generation",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SUMMARY_RETRY_MAX_ATTEMPTS"
        },
        {
          "description": "Base delay in seconds between retry attempts (with exponential backoff)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SUMMARY_RETRY_BASE_DELAY_S"
        },
        {
          "description": "Maximum concurrent summary generation operations (default: 2, range: 1-20)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SUMMARY_MAX_CONCURRENT"
        },
        {
          "description": "Custom summarization prompt. Overrides the built-in default. Used as system message for the LLM.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "SUMMARY_PROMPT"
        },
        {
          "description": "Minimum text content length in characters to trigger summary generation (default: 500, range: 0-10000). Set to 0 to always generate.",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SUMMARY_MIN_CONTENT_LENGTH"
        },
        {
          "description": "Ollama summary context window size in tokens (default: 32768, range: 512-2097152)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SUMMARY_OLLAMA_NUM_CTX"
        },
        {
          "description": "Ollama summary truncation mode: false (default) returns error when context exceeded, true enables silent truncation",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "SUMMARY_OLLAMA_TRUNCATE"
        },
        {
          "description": "Presence penalty sent with every Ollama summary call (0-2). Unset: a qwen3 model gets 1.5, the value its model card prescribes against endless repetition with reasoning off; any other model gets no penalty. An explicit value applies to whatever model is configured; 0 disables it",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SUMMARY_OLLAMA_PRESENCE_PENALTY"
        },
        {
          "description": "Reasoning effort level for OpenAI reasoning models (default: low). Valid values vary by generation: gpt-5: low, medium, high; gpt-5.1+: none, low, medium, high, xhigh. Default low is universally valid across all generations",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "SUMMARY_OPENAI_REASONING_EFFORT"
        },
        {
          "description": "Effort level for Anthropic Claude models (default: not sent / omitted). Valid values: max, high, medium, low. Controls inference effort (adaptive thinking)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "SUMMARY_ANTHROPIC_EFFORT"
        },
        {
          "description": "Anthropic API key for summary generation",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "ANTHROPIC_API_KEY"
        },
        {
          "description": "Full-text search tool registration. Tri-state: auto (default), true, or false. auto registers full-text search by default (FTS needs no extra dependencies); true forces registration; false skips it.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ENABLE_FTS",
          "default": "auto"
        },
        {
          "description": "Language for FTS stemming (e.g., english, german, french)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "FTS_LANGUAGE"
        },
        {
          "description": "Characters of context around each FTS match for reranking passage extraction (default: 750)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "FTS_RERANK_WINDOW_SIZE"
        },
        {
          "description": "Merge FTS match regions within this character distance (default: 100)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "FTS_RERANK_GAP_MERGE"
        },
        {
          "description": "Hybrid search tool registration (combines FTS and semantic search with RRF fusion). Tri-state: auto (default), true, or false. auto and true both register hybrid search when at least one of FTS or semantic search is available (otherwise a warning is logged and it is skipped, since hybrid has no underlying mode to fuse and true cannot force it on with neither); false skips it.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ENABLE_HYBRID_SEARCH",
          "default": "auto"
        },
        {
          "description": "grep_context tool registration (server-side literal/regex line-oriented search). Tri-state: auto (default; pure-Python matching, no extra dependencies), true, or false.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ENABLE_GREP_CONTEXT",
          "default": "auto"
        },
        {
          "description": "Hard ceiling applied to grep_context max_matches per request (default 1000).",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "GREP_MAX_MATCHES_CAP"
        },
        {
          "description": "Hard ceiling applied to grep_context context_lines per request (default 20).",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "GREP_MAX_CONTEXT_LINES"
        },
        {
          "description": "Hard ceiling on the number of entries the grep scan visits (default 1000).",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "GREP_MAX_ENTRIES_SCANNED"
        },
        {
          "description": "Approximate resident-memory cap (summed code-point length of fetched text) before a grep scan stops; the first entry that crosses the budget is still scanned (default 67108864).",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "GREP_AGGREGATE_BYTES_BUDGET"
        },
        {
          "description": "Per-entry timeout in seconds for is_regex=true matching (ReDoS guard; a timeout skips that entry, never aborts the read; default 5.0).",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "GREP_REGEX_TIMEOUT_S"
        },
        {
          "description": "Aggregate wall-clock budget in seconds across an entire is_regex=true scan (GREP_REGEX_TIMEOUT_S bounds one entry; this bounds the cumulative scan). When exceeded the scan stops and returns partial results with truncated=true, never aborting the read; default 30.0.",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "GREP_REGEX_TOTAL_TIMEOUT_S"
        },
        {
          "description": "Maximum grep_context pattern length in characters, advertised in the wire schema and re-checked in the tool body (compilation runs before any matching timeout, so an unbounded pattern could stall a request just to compile; default 32768).",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "GREP_MAX_PATTERN_CHARS"
        },
        {
          "description": "read_context_range tool registration (partial read by character or line range). Tri-state: auto (default; no extra dependencies), true, or false.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ENABLE_CONTEXT_RANGE",
          "default": "auto"
        },
        {
          "description": "plan_context_sync and list_ingest_state tool registration (corpus sync planning and stored ingest state). Tri-state: auto (default; no extra dependencies), true, or false.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ENABLE_CONTEXT_SYNC",
          "default": "auto"
        },
        {
          "description": "navigate_context tool registration (code-derived Markdown outline / index_tree). Tri-state: auto (default; pure-Python, no extra dependencies), true, or false.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ENABLE_CONTEXT_NAVIGATION",
          "default": "auto"
        },
        {
          "description": "Generate per-node LLM summaries for the navigate_context index_tree and provision the context_index_nodes table. Additive/never-raise: a node-summary failure never aborts a store. Default true.",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "ENABLE_INDEX_TREE_NODE_SUMMARIES",
          "default": "true"
        },
        {
          "description": "Override the per-node index_tree summary system prompt. Empty resolves to a dedicated short headline-style abstract prompt.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "INDEX_TREE_NODE_SUMMARY_PROMPT"
        },
        {
          "description": "Heading sections shorter than this (characters) skip per-node summary generation (0 = always). Default 500.",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "INDEX_TREE_NODE_SUMMARY_MIN_CONTENT_LENGTH"
        },
        {
          "description": "Per-node summary timeout in seconds; a timeout omits that node, never aborts the store. Default 240.",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "INDEX_TREE_NODE_SUMMARY_TIMEOUT_S"
        },
        {
          "description": "Output token budget of one per-node index_tree summary call (num_predict for Ollama, max_tokens for OpenAI and Anthropic). Default 120, sized for a 25-word headline; an answer cut off at this budget drops that node's summary, so a model that loops on one section never spends SUMMARY_MAX_TOKENS",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "INDEX_TREE_NODE_SUMMARY_MAX_TOKENS"
        },
        {
          "description": "Node-task fan-out cap for per-node index_tree summary coroutines; NOT a second model budget (summary-model concurrency is governed by SUMMARY_MAX_CONCURRENT). Default min(cpu_count, 4).",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "INDEX_TREE_NODE_SUMMARY_MAX_CONCURRENT"
        },
        {
          "description": "Maximum heading sections summarized per entry; bounds TOTAL per-node summary work (the shallowest and longest sections are summarized first). Default 200.",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "INDEX_TREE_NODE_SUMMARY_MAX_NODES"
        },
        {
          "description": "Aggregate wall-clock budget in seconds for the whole per-node summary pass of one entry; on expiry the pass keeps what it produced and never aborts the store. Default 600.",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "INDEX_TREE_NODE_SUMMARY_TOTAL_TIMEOUT_S"
        },
        {
          "description": "RRF smoothing constant for hybrid search (default 60)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "HYBRID_RRF_K"
        },
        {
          "description": "Multiplier for over-fetching results before RRF fusion (default: 2)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "HYBRID_RRF_OVERFETCH"
        },
        {
          "description": "Minimum significant query terms to switch hybrid FTS from AND to OR logic (default: 4)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "HYBRID_FTS_OR_THRESHOLD"
        },
        {
          "description": "Maximum character length for truncated text_content in search results (default: 300, range: 50-1000)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "SEARCH_TRUNCATION_LENGTH"
        },
        {
          "description": "Whether get_context_by_ids includes the summary field in each returned entry. Tri-state: when false (default), the summary key is omitted entirely (consumers reading entry.get('summary') receive None -- the conventional Python signal for 'feature disabled'); when true with a stored non-empty summary, the value is returned verbatim; when true but the stored summary is NULL or empty, the value is normalized to an empty string '' (signaling 'feature on, no data yet'). The text_content field always contains the full untruncated text regardless of this toggle. Does not affect search tools, which always emit summary as a string.",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "GET_CONTEXT_BY_IDS_INCLUDE_SUMMARY"
        },
        {
          "description": "Enable text chunking for embedding generation (default: true)",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "ENABLE_CHUNKING"
        },
        {
          "description": "Target chunk size in characters (default: 1500)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "CHUNK_SIZE"
        },
        {
          "description": "Overlap between chunks in characters (default: 150)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "CHUNK_OVERLAP"
        },
        {
          "description": "Chunk score aggregation method: max (only 'max' supported in current version)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "CHUNK_AGGREGATION"
        },
        {
          "description": "Enable cross-encoder reranking of search results (default: true)",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "ENABLE_RERANKING"
        },
        {
          "description": "Reranking provider (default: flashrank)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "RERANKING_PROVIDER"
        },
        {
          "description": "Reranking model name (default: ms-marco-MiniLM-L-12-v2)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "RERANKING_MODEL"
        },
        {
          "description": "Maximum input length for reranking in tokens (default: 512)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "RERANKING_MAX_LENGTH"
        },
        {
          "description": "Directory for caching reranking models",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "RERANKING_CACHE_DIR"
        },
        {
          "description": "Estimated characters per token for passage size validation (default: 4.0, range: 2.0-8.0)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "RERANKING_CHARS_PER_TOKEN"
        },
        {
          "description": "ONNX Runtime intra-operation parallelism threads for reranking (default: 0 = auto-detect)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "RERANKING_INTRA_OP_THREADS"
        },
        {
          "description": "Enable ONNX Runtime CPU memory arena for reranking (default: false)",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "RERANKING_CPU_MEM_ARENA"
        },
        {
          "description": "Maximum passages per ONNX Runtime inference batch during reranking (default: 32)",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "RERANKING_BATCH_SIZE"
        },
        {
          "description": "Embedding provider: ollama (default), openai, azure, huggingface, or voyage",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "EMBEDDING_PROVIDER"
        },
        {
          "description": "OpenAI API key for OpenAI embedding provider",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "OPENAI_API_KEY"
        },
        {
          "description": "Custom base URL for OpenAI-compatible APIs",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "OPENAI_API_BASE"
        },
        {
          "description": "OpenAI organization ID",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "OPENAI_ORGANIZATION"
        },
        {
          "description": "Azure OpenAI API key",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "AZURE_OPENAI_API_KEY"
        },
        {
          "description": "Azure OpenAI endpoint URL",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "AZURE_OPENAI_ENDPOINT"
        },
        {
          "description": "Azure OpenAI embedding deployment name",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME"
        },
        {
          "description": "Azure OpenAI API version (default: 2024-02-01)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "AZURE_OPENAI_API_VERSION"
        },
        {
          "description": "HuggingFace Hub API token for HuggingFace embedding provider",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "HUGGINGFACEHUB_API_TOKEN"
        },
        {
          "description": "Voyage AI API key for Voyage embedding provider",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "VOYAGE_API_KEY"
        },
        {
          "description": "Voyage AI truncation mode: false (default) returns error when context exceeded, true enables silent truncation",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "VOYAGE_TRUNCATION"
        },
        {
          "description": "Voyage AI batch size for embedding requests",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "VOYAGE_BATCH_SIZE"
        },
        {
          "description": "Enable LangSmith tracing",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "LANGSMITH_TRACING"
        },
        {
          "description": "LangSmith API key",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "LANGSMITH_API_KEY"
        },
        {
          "description": "LangSmith project name",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "LANGSMITH_PROJECT"
        },
        {
          "description": "LangSmith API endpoint URL",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "LANGSMITH_ENDPOINT"
        },
        {
          "description": "Comma-separated list of metadata fields to index (field:type format)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "METADATA_INDEXED_FIELDS"
        },
        {
          "description": "Index sync mode: strict (fail), auto (sync), warn (log), additive (default, add missing and rebuild drifted, never drop)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "METADATA_INDEX_SYNC_MODE"
        },
        {
          "description": "Transport mode: stdio for local, http for Docker/remote",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "MCP_TRANSPORT"
        },
        {
          "description": "HTTP bind address (use 0.0.0.0 for Docker)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "FASTMCP_HOST"
        },
        {
          "description": "HTTP port number",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "FASTMCP_PORT"
        },
        {
          "description": "Enable stateless HTTP mode for horizontal scaling. Enabled by default as the server has no stateful MCP features. Set to false only if you need server-side MCP session tracking.",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "FASTMCP_STATELESS_HTTP"
        },
        {
          "description": "Comma-separated list of tools to disable (e.g., delete_context,update_context)",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "DISABLED_TOOLS"
        },
        {
          "description": "Bearer token for HTTP authentication (required when using SimpleTokenVerifier)",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "MCP_AUTH_TOKEN"
        },
        {
          "description": "Client ID that identifies simple_token requests to FastMCP. Not an owner identity: simple_token requests own entries as ACCESS_CONTROL_DEFAULT_PRINCIPAL",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "MCP_AUTH_CLIENT_ID"
        },
        {
          "description": "Authentication provider: none (default), simple_token, jwt",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "MCP_AUTH_PROVIDER"
        },
        {
          "description": "PEM-encoded public key (asymmetric algorithms) or shared secret (HS* algorithms) for JWT verification. Mutually exclusive with MCP_AUTH_JWT_JWKS_URI; exactly one is required when MCP_AUTH_PROVIDER=jwt",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "MCP_AUTH_JWT_PUBLIC_KEY"
        },
        {
          "description": "JWKS endpoint URI for JWT verification with automatic key rotation. Mutually exclusive with MCP_AUTH_JWT_PUBLIC_KEY; exactly one is required when MCP_AUTH_PROVIDER=jwt",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "MCP_AUTH_JWT_JWKS_URI"
        },
        {
          "description": "Expected issuer (iss) claim value for JWT verification. Unset skips issuer validation",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "MCP_AUTH_JWT_ISSUER"
        },
        {
          "description": "Expected audience (aud) claim value for JWT verification. Unset skips audience validation",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "MCP_AUTH_JWT_AUDIENCE"
        },
        {
          "description": "JWT signing algorithm to accept (default RS256). Supported: HS256/384/512, RS256/384/512, ES256/384/512, PS256/384/512, EdDSA, Ed25519, Ed448",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "MCP_AUTH_JWT_ALGORITHM"
        },
        {
          "description": "PEM-encoded public key (asymmetric algorithms) or shared secret (HS* algorithms) of a second, operator-held verifier that accepts only ACCESS_CONTROL_ANONYMOUS_PRINCIPAL, composed beside the JWKS verifier. Applies only with MCP_AUTH_JWT_JWKS_URI and requires ACCESS_CONTROL_ANONYMOUS_PRINCIPAL; a static-key deployment signs the anonymous token with its own MCP_AUTH_JWT_PUBLIC_KEY counterpart",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "MCP_AUTH_ANONYMOUS_JWT_PUBLIC_KEY"
        },
        {
          "description": "Signing algorithm the anonymous verifier accepts (default RS256; used with MCP_AUTH_ANONYMOUS_JWT_PUBLIC_KEY). Supported: HS256/384/512, RS256/384/512, ES256/384/512, PS256/384/512, EdDSA, Ed25519, Ed448",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "MCP_AUTH_ANONYMOUS_JWT_ALGORITHM"
        },
        {
          "description": "Claim carrying the caller group memberships (default groups). Supports dotted paths and full-URL claim keys",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "MCP_AUTH_GROUPS_CLAIM"
        },
        {
          "description": "Claim carrying the caller roles (default roles). Supports dotted paths and full-URL claim keys",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "MCP_AUTH_ROLES_CLAIM"
        },
        {
          "description": "Principal id stamped as owner_id for every request without a jwt identity: stdio transport and MCP_AUTH_PROVIDER none or simple_token. Also the owner backfilled onto rows that predate the access-control columns. Default local.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ACCESS_CONTROL_DEFAULT_PRINCIPAL",
          "default": "local"
        },
        {
          "description": "Visibility stamped on stored entries when the caller does not specify one: private (owner plus every grantee), public (everyone). Default private.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ACCESS_CONTROL_DEFAULT_VISIBILITY",
          "default": "private"
        },
        {
          "description": "Automatic group read grants on newly inserted entries: none (no automatic grants, default) or author_groups (every group of the writing principal receives a read grant, effective under the default private visibility).",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ACCESS_CONTROL_DEFAULT_GROUP_GRANTS",
          "default": "none"
        },
        {
          "description": "Role required to set visibility public. Unset (default) lets any owner publish; set to a role name to restrict publishing to callers whose verified roles claim carries that role.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ACCESS_CONTROL_PUBLISH_ROLE"
        },
        {
          "description": "Principal id of the read-only jwt subject, matched verbatim against the token sub claim: every write tool refuses it, its groups and roles are discarded, and its token must carry exp. Unset (default) makes no principal read-only, and a value that differs from the minted sub leaves that token an ordinary writable principal, so the startup log names the value. Must differ from ACCESS_CONTROL_DEFAULT_PRINCIPAL.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "ACCESS_CONTROL_ANONYMOUS_PRINCIPAL"
        },
        {
          "description": "Also enforce the access model in PostgreSQL through row-level security. Requires STORAGE_BACKEND=postgresql and POSTGRESQL_MIGRATION_USER naming the role that owns the tables; requests must connect as a different role that is a member of POSTGRESQL_RLS_POLICY_ROLE and neither superuser nor BYPASSRLS. Default false.",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "ENABLE_POSTGRESQL_RLS",
          "default": "false"
        },
        {
          "description": "NOLOGIN PostgreSQL role the row-level security policies apply to. The operator creates it and grants it to the request login role; the server grants it the table privileges. 1-63 characters from a-z 0-9 _, not starting with a digit. Default mcp_context_request.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "POSTGRESQL_RLS_POLICY_ROLE",
          "default": "mcp_context_request"
        },
        {
          "description": "Custom server instructions text. Overrides built-in default. Set to empty string to disable.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "MCP_SERVER_INSTRUCTIONS"
        },
        {
          "description": "Enable TurboQuant embedding compression at storage time. Default true. When true (default), fp32 embeddings are replaced with bit-packed compressed payloads (~8x storage reduction at default bits=4). Set to false to opt out and keep fp32 storage.",
          "isRequired": false,
          "format": "boolean",
          "isSecret": false,
          "name": "ENABLE_EMBEDDING_COMPRESSION",
          "default": "true"
        },
        {
          "description": "Compression provider. Currently only 'turboquant' is supported.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "COMPRESSION_PROVIDER"
        },
        {
          "description": "Bits per coordinate for compression: 2 (16x), 3 (~11x), 4 (8x). Default 4. Lower bound 2 required by the inner-product variant.",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "COMPRESSION_BITS"
        },
        {
          "description": "Compression variant. 'ip' (default) uses Algorithm 2 with QJL for unbiased inner-product estimation. 'mse' uses Algorithm 1 (L2-optimal reconstruction).",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "COMPRESSION_VARIANT"
        },
        {
          "description": "Rotation matrix seed. Default 0. Pick any stable integer in [0, 4294967295] (the seed is packed into the compressed payload as an unsigned 32-bit field); the value is persisted in compression_metadata at first startup and treated as load-bearing thereafter (mismatching env vs DB raises ConfigurationError(78)).",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "COMPRESSION_SEED",
          "default": "0"
        },
        {
          "description": "Max concurrent compression encode workers dispatched to threads (the CPU-bound codec section is serialized by a process-wide BLAS-limits lock, so this bounds worker fan-out, not CPU parallelism). Separate from I/O-bound EMBEDDING_MAX_CONCURRENT and SUMMARY_MAX_CONCURRENT. Default min(cpu_count, 4).",
          "isRequired": false,
          "format": "number",
          "isSecret": false,
          "name": "COMPRESSION_MAX_CONCURRENT"
        }
      ]
    }
  ]
}