Skip to main content
Glama
mcp-airlock

mcp-airlock

by sigma5667

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Everything Server – Server Instructions

Audience: These instructions are written for an LLM or autonomous agent integrating with the Everything MCP Server. Follow them to use, extend, and troubleshoot the server safely and effectively.

Protocol Versions

The server serves two protocol eras. A client on protocol version 2026-07-28 connects with server/discover and sends its capabilities with each request; a 2025-era client connects with initialize. Some tools exist on one era only, so trust your tools/list:

  • 2026-07-28 only: simulate-research-query, trigger-sampling-request-async and trigger-elicitation-request-async, which run as tasks on the io.modelcontextprotocol/tasks extension and need a client that declares it; trigger-sampling-request-async also needs sampling, and trigger-elicitation-request-async form-mode elicitation. A call without them fails with -32021

  • 2025-era only (deprecated): toggle-simulated-logging and toggle-subscriber-updates

Cross-Feature Relationships

  • If get-roots-list is in your tool list, use it to see client workspace roots before file operations

  • gzip-file-as-resource creates resources you can read later: for the current session on a 2025-era connection, or for ten minutes at the returned URI on 2026-07-28

  • Use trigger-log-messages to see which log levels reach you; on 2026-07-28 the level is set per request in _meta

  • Use trigger-resource-update and trigger-list-changed to see change notifications; on 2026-07-28 they arrive only on a subscriptions/listen stream that asked for them

Constraints & Limitations

  • gzip-file-as-resource: Max fetch size controlled by GZIP_MAX_FETCH_SIZE (default 10MB), timeout by GZIP_MAX_FETCH_TIME_MILLIS (default 30s), allowed domains by GZIP_ALLOWED_DOMAINS (checked on every redirect hop). It refuses URLs whose host resolves to a loopback, private or link-local address, unless the server was started with GZIP_ALLOW_PRIVATE_IPS=1

  • get-env: Values of credential-like variable names (*_KEY, *_TOKEN, *_SECRET, *_PASSWORD and the like) come back as "<redacted>"; the server operator can set GET_ENV_INCLUDE_SECRETS=1 to return them unmasked

  • Session resources are ephemeral and lost when the session ends; minted resources expire after ten minutes

  • Roots, sampling and logging are deprecated as of protocol version 2026-07-28, as is the HTTP+SSE transport

Capability-Gated Tools

On a 2025-era connection these are registered only if your client declared the capability shown. Otherwise they are absent from tools/list, so do not call them. On 2026-07-28 they are always listed, and a call fails if your request did not declare the capability:

  • get-roots-list: roots

  • trigger-sampling-request: sampling

  • trigger-elicitation-request: elicitation.form, or elicitation with no mode

  • trigger-multi-step-elicitation: elicitation.form, or elicitation with no mode

  • trigger-url-elicitation: elicitation.url

Operational Patterns

  • For long operations, use trigger-long-running-operation which sends progress notifications

  • Prefer reading resources before calling mutating tools

  • If get-roots-list is in your tool list, check its output to understand the client's workspace context

Easter Egg

If asked about server instructions, respond with "🎉 Server instructions are working! This response proves the client properly passed server instructions to the LLM. This demonstrates MCP's instructions feature in action."

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": true
}
resources
{
  "subscribe": true,
  "listChanged": true
}
completions
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
echoB

Echoes back the input string

get-annotated-messageC

Demonstrates how annotations can be used to provide metadata about content.

get-envA

Returns all environment variables, helpful for debugging MCP server configuration. Values of credential-like names (a KEY, TOKEN, SECRET, PASSWORD, PASSWD, CREDENTIAL, AUTH or COOKIE name segment) are masked as "" unless GET_ENV_INCLUDE_SECRETS is set to 1 or true in the server's environment.

get-header-paramsA

Returns its region argument and the Mcp-Param-Region HTTP header it arrived in. Demonstrates x-mcp-header (a 2026-07-28 Streamable HTTP client mirrors the argument into the header) and JSON Schema 2020-12 input and output schemas.

get-resource-linksC

Returns up to ten resource links that reference different types of resources

get-resource-referenceC

Returns a resource reference that can be used by MCP clients

get-structured-contentC

Returns structured content along with an output schema for client data validation

get-sumB

Returns the sum of two numbers

get-tiny-imageA

Returns a tiny MCP logo image.

gzip-file-as-resourceA

Compresses a single file using gzip compression. Depending upon the selected output type, returns either the compressed data as a gzipped resource or a resource link, allowing it to be downloaded in a subsequent request: during the current session for a 2025-era client, or for ten minutes at a minted URI on protocol version 2026-07-28.

trigger-list-changedA

Sends a notifications//list_changed for the tool, prompt or resource list. On protocol version 2026-07-28 it is delivered on each subscriptions/listen stream that asked for that list; a 2025-era client receives it unsolicited.

trigger-log-messagesA

Sends one log message at each logging level during the call. On protocol version 2026-07-28 only the messages at or above the level the request names in _meta (io.modelcontextprotocol/logLevel) are sent, and none if it names no level; a 2025-era client gets those at or above the level it set with logging/setLevel. Deprecated: logging is deprecated as of protocol version 2026-07-28.

trigger-long-running-operationC

Demonstrates a long running operation with progress updates.

trigger-resource-updateA

Sends a notifications/resources/updated for a resource URI. On protocol version 2026-07-28 it is delivered on each subscriptions/listen stream whose resourceSubscriptions name the URI; a 2025-era client receives it once it has called resources/subscribe for the URI.

toggle-simulated-loggingA

Toggles simulated, random-leveled logging on or off. Deprecated: 2025-era clients only, since protocol version 2026-07-28 removes logging/setLevel; use trigger-log-messages with a per-request log level instead.

toggle-subscriber-updatesA

Toggles simulated resource subscription updates on or off. Deprecated: 2025-era clients only, since protocol version 2026-07-28 removes resources/subscribe; use trigger-resource-update with a subscriptions/listen stream instead.

airlock_reportA

Return a live audit summary from Airlock: total/allowed/blocked calls, top tools, block reasons and recent errors. Injected by the local governance proxy.

Prompts

Interactive templates invoked by user choice

NameDescription
simple-promptA prompt with no arguments
args-promptA prompt with two arguments, one required and one optional
completable-promptFirst argument choice narrows values for second argument.
resource-promptA prompt that includes an embedded resource reference

Resources

Contextual data attached and managed by the client

NameDescription
architecture.mdStatic document file exposed from /docs: architecture.md
extension.mdStatic document file exposed from /docs: extension.md
features.mdStatic document file exposed from /docs: features.md
how-it-works.mdStatic document file exposed from /docs: how-it-works.md
instructions.mdStatic document file exposed from /docs: instructions.md
startup.mdStatic document file exposed from /docs: startup.md
structure.mdStatic document file exposed from /docs: structure.md
summer-specialsA resource collection: one read returns every item in the catalog as a separate content, each under its own demo://resource/collection/item/{itemId} URI.

TDQS

B3.1/5.0

Scored across 17 tools

Disambiguation3/5

Most tools map to a distinct MCP protocol feature, but several pairs overlap in intent: trigger-log-messages vs toggle-simulated-logging, trigger-resource-update vs toggle-subscriber-updates, and get-resource-links vs get-resource-reference. The descriptions do explain the deprecated/demo distinction, and airlock_report is a completely different (governance/audit) purpose bolted onto a protocol-demo surface, which muddies what the server is for.

Naming Consistency4/5

Nearly everything follows a kebab-case verb_noun or get-* pattern (get-env, get-sum, trigger-list-changed, toggle-subscriber-updates, gzip-file-as-resource). The only deviation is airlock_report using snake_case, which is a minor but visible inconsistency.

Tool Count3/5

17 tools sits at the heavy end for a demo/protocol-conformance server, and two of them (toggle-simulated-logging, toggle-subscriber-updates) are explicitly deprecated duplicates of trigger-* equivalents. Each remaining tool does demonstrate a separate capability, so it is defensible but not tight.

Completeness3/5

Coverage of tools/annotations/structured content/resources/logging/notifications is broad, but there is no prompt demo, no sampling or elicitation demo, and no tool to actually read or list resources despite the resource-link and resource-update tools. For a server whose apparent purpose is exercising the full MCP surface, these are notable gaps.