mcp-airlock
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
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-asyncandtrigger-elicitation-request-async, which run as tasks on theio.modelcontextprotocol/tasksextension and need a client that declares it;trigger-sampling-request-asyncalso needssampling, andtrigger-elicitation-request-asyncform-modeelicitation. A call without them fails with-320212025-era only (deprecated):
toggle-simulated-loggingandtoggle-subscriber-updates
Cross-Feature Relationships
If
get-roots-listis in your tool list, use it to see client workspace roots before file operationsgzip-file-as-resourcecreates 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-28Use
trigger-log-messagesto see which log levels reach you; on 2026-07-28 the level is set per request in_metaUse
trigger-resource-updateandtrigger-list-changedto see change notifications; on 2026-07-28 they arrive only on asubscriptions/listenstream that asked for them
Constraints & Limitations
gzip-file-as-resource: Max fetch size controlled byGZIP_MAX_FETCH_SIZE(default 10MB), timeout byGZIP_MAX_FETCH_TIME_MILLIS(default 30s), allowed domains byGZIP_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 withGZIP_ALLOW_PRIVATE_IPS=1get-env: Values of credential-like variable names (*_KEY,*_TOKEN,*_SECRET,*_PASSWORDand the like) come back as"<redacted>"; the server operator can setGET_ENV_INCLUDE_SECRETS=1to return them unmaskedSession 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:rootstrigger-sampling-request:samplingtrigger-elicitation-request:elicitation.form, orelicitationwith no modetrigger-multi-step-elicitation:elicitation.form, orelicitationwith no modetrigger-url-elicitation:elicitation.url
Operational Patterns
For long operations, use
trigger-long-running-operationwhich sends progress notificationsPrefer reading resources before calling mutating tools
If
get-roots-listis 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
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"subscribe": true,
"listChanged": true
} |
| completions | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
| simple-prompt | A prompt with no arguments |
| args-prompt | A prompt with two arguments, one required and one optional |
| completable-prompt | First argument choice narrows values for second argument. |
| resource-prompt | A prompt that includes an embedded resource reference |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| architecture.md | Static document file exposed from /docs: architecture.md |
| extension.md | Static document file exposed from /docs: extension.md |
| features.md | Static document file exposed from /docs: features.md |
| how-it-works.md | Static document file exposed from /docs: how-it-works.md |
| instructions.md | Static document file exposed from /docs: instructions.md |
| startup.md | Static document file exposed from /docs: startup.md |
| structure.md | Static document file exposed from /docs: structure.md |
| summer-specials | A 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
Scored across 17 tools
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.
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.
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.
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.