@apify/mcpc 0.1.5 → 0.1.6

package/.claude/settings.local.json

@@ -86,7 +86,14 @@
       "Bash(xargs:*)",
       "Bash(TESTS=\"failover expired\" ./test/e2e/run.sh:*)",
       "Bash(npm run build:readme:*)",
-      "Bash(npx markdown-link-check:*)"
+      "Bash(npx markdown-link-check:*)",
+      "Bash(markdown-link-check:*)",
+      "Bash(git -C /Users/jancurn/Projects/mcpc remote:*)",
+      "Bash(TESTS=sessions/notifications ./test/e2e/run.sh:*)",
+      "Bash(E2E_ISOLATED_ALL=1 TESTS=sessions/notifications ./test/e2e/run.sh:*)",
+      "Bash(TESTS=sessions/notifications E2E_ISOLATED_ALL=1 ./test/e2e/run.sh:*)",
+      "Bash(E2E_ISOLATED_ALL=1 ./test/e2e/run.sh:*)",
+      "Bash(E2E_ISOLATED_ALL=1 TESTS=proxy ./test/e2e/run.sh:*)"
     ]
   }
 }

package/.idea/workspace.xml

@@ -4,7 +4,9 @@
     <option name="autoReloadType" value="SELECTIVE" />
   </component>
   <component name="ChangeListManager">
-    <list default="true" id="84071bae-f051-424d-a0e4-1540170b1e94" name="Changes" comment="More final touches" />
+    <list default="true" id="84071bae-f051-424d-a0e4-1540170b1e94" name="Changes" comment="Cosmetic">
+      <change beforePath="$PROJECT_DIR$/scripts/publish.sh" beforeDir="false" afterPath="$PROJECT_DIR$/scripts/publish.sh" afterDir="false" />
+    </list>
     <option name="SHOW_DIALOG" value="false" />
     <option name="HIGHLIGHT_CONFLICTS" value="true" />
     <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
@@ -79,8 +81,8 @@
       <recent name="$PROJECT_DIR$/docs" />
     </key>
     <key name="MoveFile.RECENT_KEYS">
-      <recent name="$PROJECT_DIR$/docs/images" />
       <recent name="$PROJECT_DIR$/docs/examples" />
+      <recent name="$PROJECT_DIR$/docs/images" />
       <recent name="$PROJECT_DIR$/docs" />
       <recent name="$PROJECT_DIR$/test/coverage" />
       <recent name="$PROJECT_DIR$/test/playground" />
@@ -110,151 +112,7 @@
       <workItem from="1765408613036" duration="57637000" />
       <workItem from="1766127655477" duration="67632000" />
       <workItem from="1766435124813" duration="175094000" />
-      <workItem from="1767121309931" duration="110385000" />
-    </task>
-    <task id="LOCAL-00273" summary="Fixes and testing">
-      <option name="closed" value="true" />
-      <created>1767166696824</created>
-      <option name="number" value="00273" />
-      <option name="presentableId" value="LOCAL-00273" />
-      <option name="project" value="LOCAL" />
-      <updated>1767166696824</updated>
-    </task>
-    <task id="LOCAL-00274" summary="Fixes and testing">
-      <option name="closed" value="true" />
-      <created>1767167128899</created>
-      <option name="number" value="00274" />
-      <option name="presentableId" value="LOCAL-00274" />
-      <option name="project" value="LOCAL" />
-      <updated>1767167128899</updated>
-    </task>
-    <task id="LOCAL-00275" summary="Fixes and testing">
-      <option name="closed" value="true" />
-      <created>1767169384572</created>
-      <option name="number" value="00275" />
-      <option name="presentableId" value="LOCAL-00275" />
-      <option name="project" value="LOCAL" />
-      <updated>1767169384572</updated>
-    </task>
-    <task id="LOCAL-00276" summary="Texts">
-      <option name="closed" value="true" />
-      <created>1767171334540</created>
-      <option name="number" value="00276" />
-      <option name="presentableId" value="LOCAL-00276" />
-      <option name="project" value="LOCAL" />
-      <updated>1767171334540</updated>
-    </task>
-    <task id="LOCAL-00277" summary="Lint">
-      <option name="closed" value="true" />
-      <created>1767171513765</created>
-      <option name="number" value="00277" />
-      <option name="presentableId" value="LOCAL-00277" />
-      <option name="project" value="LOCAL" />
-      <updated>1767171513765</updated>
-    </task>
-    <task id="LOCAL-00278" summary="Improvements">
-      <option name="closed" value="true" />
-      <created>1767172393111</created>
-      <option name="number" value="00278" />
-      <option name="presentableId" value="LOCAL-00278" />
-      <option name="project" value="LOCAL" />
-      <updated>1767172393111</updated>
-    </task>
-    <task id="LOCAL-00279" summary="Fix">
-      <option name="closed" value="true" />
-      <created>1767209992232</created>
-      <option name="number" value="00279" />
-      <option name="presentableId" value="LOCAL-00279" />
-      <option name="project" value="LOCAL" />
-      <updated>1767209992232</updated>
-    </task>
-    <task id="LOCAL-00280" summary="Improved server details output">
-      <option name="closed" value="true" />
-      <created>1767213239200</created>
-      <option name="number" value="00280" />
-      <option name="presentableId" value="LOCAL-00280" />
-      <option name="project" value="LOCAL" />
-      <updated>1767213239200</updated>
-    </task>
-    <task id="LOCAL-00281" summary="Fixes">
-      <option name="closed" value="true" />
-      <created>1767215424308</created>
-      <option name="number" value="00281" />
-      <option name="presentableId" value="LOCAL-00281" />
-      <option name="project" value="LOCAL" />
-      <updated>1767215424308</updated>
-    </task>
-    <task id="LOCAL-00282" summary="Fixes">
-      <option name="closed" value="true" />
-      <created>1767215859466</created>
-      <option name="number" value="00282" />
-      <option name="presentableId" value="LOCAL-00282" />
-      <option name="project" value="LOCAL" />
-      <updated>1767215859466</updated>
-    </task>
-    <task id="LOCAL-00283" summary="Fixes of tests">
-      <option name="closed" value="true" />
-      <created>1767216626423</created>
-      <option name="number" value="00283" />
-      <option name="presentableId" value="LOCAL-00283" />
-      <option name="project" value="LOCAL" />
-      <updated>1767216626423</updated>
-    </task>
-    <task id="LOCAL-00284" summary="Fixes from tests">
-      <option name="closed" value="true" />
-      <created>1767220006202</created>
-      <option name="number" value="00284" />
-      <option name="presentableId" value="LOCAL-00284" />
-      <option name="project" value="LOCAL" />
-      <updated>1767220006203</updated>
-    </task>
-    <task id="LOCAL-00285" summary="Fixes from/of tests">
-      <option name="closed" value="true" />
-      <created>1767227252479</created>
-      <option name="number" value="00285" />
-      <option name="presentableId" value="LOCAL-00285" />
-      <option name="project" value="LOCAL" />
-      <updated>1767227252479</updated>
-    </task>
-    <task id="LOCAL-00286" summary="Writing">
-      <option name="closed" value="true" />
-      <created>1767229207094</created>
-      <option name="number" value="00286" />
-      <option name="presentableId" value="LOCAL-00286" />
-      <option name="project" value="LOCAL" />
-      <updated>1767229207094</updated>
-    </task>
-    <task id="LOCAL-00287" summary="Writing">
-      <option name="closed" value="true" />
-      <created>1767229385596</created>
-      <option name="number" value="00287" />
-      <option name="presentableId" value="LOCAL-00287" />
-      <option name="project" value="LOCAL" />
-      <updated>1767229385596</updated>
-    </task>
-    <task id="LOCAL-00288" summary="Writing">
-      <option name="closed" value="true" />
-      <created>1767232209658</created>
-      <option name="number" value="00288" />
-      <option name="presentableId" value="LOCAL-00288" />
-      <option name="project" value="LOCAL" />
-      <updated>1767232209658</updated>
-    </task>
-    <task id="LOCAL-00289" summary="Writing">
-      <option name="closed" value="true" />
-      <created>1767233383364</created>
-      <option name="number" value="00289" />
-      <option name="presentableId" value="LOCAL-00289" />
-      <option name="project" value="LOCAL" />
-      <updated>1767233383364</updated>
-    </task>
-    <task id="LOCAL-00290" summary="Writing">
-      <option name="closed" value="true" />
-      <created>1767236572704</created>
-      <option name="number" value="00290" />
-      <option name="presentableId" value="LOCAL-00290" />
-      <option name="project" value="LOCAL" />
-      <updated>1767236572704</updated>
+      <workItem from="1767121309931" duration="134235000" />
     </task>
     <task id="LOCAL-00291" summary="Writing">
       <option name="closed" value="true" />
@@ -504,7 +362,151 @@
       <option name="project" value="LOCAL" />
       <updated>1767308550740</updated>
     </task>
-    <option name="localTasksCounter" value="322" />
+    <task id="LOCAL-00322" summary="Writing">
+      <option name="closed" value="true" />
+      <created>1767309101418</created>
+      <option name="number" value="00322" />
+      <option name="presentableId" value="LOCAL-00322" />
+      <option name="project" value="LOCAL" />
+      <updated>1767309101418</updated>
+    </task>
+    <task id="LOCAL-00323" summary="Even more final touches">
+      <option name="closed" value="true" />
+      <created>1767310688463</created>
+      <option name="number" value="00323" />
+      <option name="presentableId" value="LOCAL-00323" />
+      <option name="project" value="LOCAL" />
+      <updated>1767310688463</updated>
+    </task>
+    <task id="LOCAL-00324" summary="Even more final touches">
+      <option name="closed" value="true" />
+      <created>1767310736155</created>
+      <option name="number" value="00324" />
+      <option name="presentableId" value="LOCAL-00324" />
+      <option name="project" value="LOCAL" />
+      <updated>1767310736155</updated>
+    </task>
+    <task id="LOCAL-00325" summary="Fixed screenshot URL">
+      <option name="closed" value="true" />
+      <created>1767311229429</created>
+      <option name="number" value="00325" />
+      <option name="presentableId" value="LOCAL-00325" />
+      <option name="project" value="LOCAL" />
+      <updated>1767311229430</updated>
+    </task>
+    <task id="LOCAL-00326" summary="Writing">
+      <option name="closed" value="true" />
+      <created>1767313279766</created>
+      <option name="number" value="00326" />
+      <option name="presentableId" value="LOCAL-00326" />
+      <option name="project" value="LOCAL" />
+      <updated>1767313279766</updated>
+    </task>
+    <task id="LOCAL-00327" summary="Better formatting of prompts, cosmetic improvements">
+      <option name="closed" value="true" />
+      <created>1767316851694</created>
+      <option name="number" value="00327" />
+      <option name="presentableId" value="LOCAL-00327" />
+      <option name="project" value="LOCAL" />
+      <updated>1767316851695</updated>
+    </task>
+    <task id="LOCAL-00328" summary="Added Session.notifications with timestamps for list changes tracking">
+      <option name="closed" value="true" />
+      <created>1767327019221</created>
+      <option name="number" value="00328" />
+      <option name="presentableId" value="LOCAL-00328" />
+      <option name="project" value="LOCAL" />
+      <updated>1767327019221</updated>
+    </task>
+    <task id="LOCAL-00329" summary="Renamed _meta to _mcpc, it conforms the MCP specs and is clearer">
+      <option name="closed" value="true" />
+      <created>1767337283710</created>
+      <option name="number" value="00329" />
+      <option name="presentableId" value="LOCAL-00329" />
+      <option name="project" value="LOCAL" />
+      <updated>1767337283710</updated>
+    </task>
+    <task id="LOCAL-00330" summary="Writing">
+      <option name="closed" value="true" />
+      <created>1767338278243</created>
+      <option name="number" value="00330" />
+      <option name="presentableId" value="LOCAL-00330" />
+      <option name="project" value="LOCAL" />
+      <updated>1767338278243</updated>
+    </task>
+    <task id="LOCAL-00331" summary="Writing">
+      <option name="closed" value="true" />
+      <created>1767339807556</created>
+      <option name="number" value="00331" />
+      <option name="presentableId" value="LOCAL-00331" />
+      <option name="project" value="LOCAL" />
+      <updated>1767339807556</updated>
+    </task>
+    <task id="LOCAL-00332" summary="Writing">
+      <option name="closed" value="true" />
+      <created>1767339937034</created>
+      <option name="number" value="00332" />
+      <option name="presentableId" value="LOCAL-00332" />
+      <option name="project" value="LOCAL" />
+      <updated>1767339937034</updated>
+    </task>
+    <task id="LOCAL-00333" summary="Writing">
+      <option name="closed" value="true" />
+      <created>1767342339122</created>
+      <option name="number" value="00333" />
+      <option name="presentableId" value="LOCAL-00333" />
+      <option name="project" value="LOCAL" />
+      <updated>1767342339122</updated>
+    </task>
+    <task id="LOCAL-00334" summary="Writing">
+      <option name="closed" value="true" />
+      <created>1767342626072</created>
+      <option name="number" value="00334" />
+      <option name="presentableId" value="LOCAL-00334" />
+      <option name="project" value="LOCAL" />
+      <updated>1767342626072</updated>
+    </task>
+    <task id="LOCAL-00335" summary="Fixes">
+      <option name="closed" value="true" />
+      <created>1767348069509</created>
+      <option name="number" value="00335" />
+      <option name="presentableId" value="LOCAL-00335" />
+      <option name="project" value="LOCAL" />
+      <updated>1767348069509</updated>
+    </task>
+    <task id="LOCAL-00336" summary="Fixes">
+      <option name="closed" value="true" />
+      <created>1767348531654</created>
+      <option name="number" value="00336" />
+      <option name="presentableId" value="LOCAL-00336" />
+      <option name="project" value="LOCAL" />
+      <updated>1767348531655</updated>
+    </task>
+    <task id="LOCAL-00337" summary="Fixes of proxy">
+      <option name="closed" value="true" />
+      <created>1767349281892</created>
+      <option name="number" value="00337" />
+      <option name="presentableId" value="LOCAL-00337" />
+      <option name="project" value="LOCAL" />
+      <updated>1767349281892</updated>
+    </task>
+    <task id="LOCAL-00338" summary="Cosmetic">
+      <option name="closed" value="true" />
+      <created>1767373372770</created>
+      <option name="number" value="00338" />
+      <option name="presentableId" value="LOCAL-00338" />
+      <option name="project" value="LOCAL" />
+      <updated>1767373372770</updated>
+    </task>
+    <task id="LOCAL-00339" summary="Cosmetic">
+      <option name="closed" value="true" />
+      <created>1767373712185</created>
+      <option name="number" value="00339" />
+      <option name="presentableId" value="LOCAL-00339" />
+      <option name="project" value="LOCAL" />
+      <updated>1767373712185</updated>
+    </task>
+    <option name="localTasksCounter" value="340" />
     <servers />
   </component>
   <component name="TypeScriptGeneratedFilesManager">
@@ -585,13 +587,6 @@
     </option>
   </component>
   <component name="VcsManagerConfiguration">
-    <MESSAGE value="Lint" />
-    <MESSAGE value="Improvements" />
-    <MESSAGE value="Fix" />
-    <MESSAGE value="Improved server details output" />
-    <MESSAGE value="Fixes of tests" />
-    <MESSAGE value="Fixes from tests" />
-    <MESSAGE value="Fixes from/of tests" />
     <MESSAGE value="Small fixes" />
     <MESSAGE value="Fixes from testing" />
     <MESSAGE value="Got rid of --args-files and --args, added stdin for tool/prompt args" />
@@ -600,16 +595,23 @@
     <MESSAGE value="Tests" />
     <MESSAGE value="Renamed &quot;session&quot; to &quot;connect&quot;, it's feels better" />
     <MESSAGE value="Fixed --timeout" />
-    <MESSAGE value="Fixes" />
-    <MESSAGE value="Cosmetic" />
     <MESSAGE value="Implemented --proxy command" />
     <MESSAGE value="Writing and tests" />
     <MESSAGE value="Tests and nits" />
     <MESSAGE value="More tests" />
-    <MESSAGE value="Writing" />
     <MESSAGE value="Renamed &quot;dead&quot; to &quot;crashed&quot; session, final touches" />
     <MESSAGE value="Final touches" />
     <MESSAGE value="More final touches" />
-    <option name="LAST_COMMIT_MESSAGE" value="More final touches" />
+    <MESSAGE value="Even more final touches" />
+    <MESSAGE value="Fixed screenshot URL" />
+    <MESSAGE value="Better formatting of prompts, cosmetic improvements" />
+    <MESSAGE value="Added Session.notifications with timestamps for list changes tracking" />
+    <MESSAGE value="Renamed _meta to _mcpc, it conforms the MCP specs and is more clear" />
+    <MESSAGE value="Renamed _meta to _mcpc, it conforms the MCP specs and is clearer" />
+    <MESSAGE value="Writing" />
+    <MESSAGE value="Fixes" />
+    <MESSAGE value="Fixes of proxy" />
+    <MESSAGE value="Cosmetic" />
+    <option name="LAST_COMMIT_MESSAGE" value="Cosmetic" />
   </component>
 </project>

package/README.md

@@ -3,19 +3,11 @@
 `mcpc` is a CLI for the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/)
 that maps MCP operations to intuitive commands for interactive shell use, scripts, and AI coding agents.
 
-`mcpc` can connect to any MCP server over Streamable HTTP or stdio transports,
-securely authenticate via OAuth and store credentials,
-and maintain persistent sessions to multiple servers.
-It supports all major MCP features, including tools, resources, prompts, asynchronous tasks, and notifications.
+`mcpc` is useful for inspecting MCP servers, scripting,
+and enabling AI coding agents to use MCP ["code mode"](#ai-agents) in shell.
+After all, UNIX-compatible shell script is THE most universal coding language.
 
-`mcpc` is useful for manual testing of MCP servers, scripting,
-and enabling AI coding agents to use MCP in ["code mode"](https://www.anthropic.com/engineering/code-execution-with-mcp)
-for better accuracy and lower token usage compared to traditional tool function calling.
-After all, UNIX-compatible shell script is THE most universal coding language, for people and LLMs alike.
-
-Note that `mcpc` does not invoke LLMs itself; that's the job of the higher layer.
-
-![mcpc screenshot](./docs/images/mcpc-screenshot.png)
+![mcpc screenshot](https://raw.githubusercontent.com/apify/mcpc/main/docs/images/mcpc-screenshot.png)
 
 **Key features:**
 - 🌎 **Highly compatible** - Works with any MCP server over Streamable HTTP or stdio.
@@ -38,7 +30,7 @@ Note that `mcpc` does not invoke LLMs itself; that's the job of the higher layer
 - [Sessions](#sessions)
 - [Authentication](#authentication)
 - [MCP proxy](#mcp-proxy)
-- [Automation](#automation)
+- [AI agents](#ai-agents)
 - [MCP support](#mcp-support)
 - [Configuration](#configuration)
 - [Security](#security)
@@ -104,20 +96,19 @@ Usage: mcpc [options] <target> [command]
 Universal command-line client for the Model Context Protocol (MCP).
 
 Options:
-  -j, --json             Output in JSON format for scripting
-  -c, --config <file>    Path to MCP config JSON file (e.g. ".vscode/mcp.json")
-  -H, --header <header>  HTTP header for remote MCP server (can be repeated)
-  -v, --version          Output the version number
-  --verbose              Enable debug logging
-  --profile <name>       OAuth authentication profile to use (default:
-                         "default")
-  --schema <file>        Validate tool/prompt schema against expected schema
-  --schema-mode <mode>   Schema validation mode: strict, compatible (default),
-                         ignore
-  --timeout <seconds>    Request timeout in seconds (default: 300)
-  --clean[=types]        Clean up mcpc data (types: sessions, logs, profiles,
-                         all)
-  -h, --help             Display general help
+  -j, --json                    Output in JSON format for scripting
+  -c, --config <file>           Path to MCP config JSON file (e.g. ".vscode/mcp.json")
+  -H, --header <header>         HTTP header for remote MCP server (can be repeated)
+  -v, --version                 Output the version number
+  --verbose                     Enable debug logging
+  --profile <name>              OAuth profile for the server (default: "default")
+  --schema <file>               Validate tool/prompt schema against expected schema
+  --schema-mode <mode>          Schema validation mode: strict, compatible (default), ignore
+  --timeout <seconds>           Request timeout in seconds (default: 300)
+  --proxy <[host:]port>         Start proxy MCP server (with "connect" command)
+  --proxy-bearer-token <token>  Require bearer token for proxy server
+  --clean[=types]               Clean up mcpc data (types: sessions, logs, profiles, all)
+  -h, --help                    Display general help
 
 Targets:
   @<session>             Named persistent session (e.g. "@apify")
@@ -503,10 +494,10 @@ mcpc mcp.apify.com\?tools=docs tools-list
 
 ## MCP proxy
 
-For stronger isolation, `mcpc` can expose an MCP session under new local proxy MCP server using the `--proxy` option.
+For stronger isolation, `mcpc` can expose an MCP session under a new local proxy MCP server using the `--proxy` option.
 The proxy forwards all MCP requests to the upstream server but **never exposes the original authentication tokens** to the client.
 This is useful when you want to give someone or something MCP access without revealing your credentials.
-See also [AI sandbox access](#ai-sandbox-access).
+See also [AI sandboxes](#ai-sandboxes).
 
 ```bash
 # Human authenticates to a remote server
@@ -566,9 +557,42 @@ mcpc
 ```
 
 
-## Automation
+## AI agents
+
+`mcpc` is designed for CLI-enabled AI agents like Claude Code or Codex CLI, supporting both
+interactive **tool calling** and **[code mode](https://www.anthropic.com/engineering/code-execution-with-mcp)**.
+
+**Tool calling mode** - Agents call `mcpc` commands to dynamically explore and interact with MCP servers,
+using the default text output. This is similar to how MCP connectors in ChatGPT or Claude work,
+but CLI gives you more flexibility and longer operation timeouts.
+
+```bash
+# Discover available tools
+mcpc @server tools-list
+
+# Get tool schema
+mcpc @server tools-get search
+
+# Call a tool
+mcpc @server tools-call search query:="hello world"
+```
+
+**Code mode** - Once agents understand the server's capabilities, they can write shell scripts
+that compose multiple `mcpc` commands with `--json` output. This can be
+[more accurate](https://www.anthropic.com/engineering/code-execution-with-mcp)
+and use fewer tokens than tool calling for complex workflows.
+
+```bash
+# AI-generated script using --json for structured data
+mcpc --json @apify tools-call search-actors keywords:="scraper" \
+  | jq '.content[0].text | fromjson | .items[0].id' \
+  | xargs -I {} mcpc @apify tools-call get-actor actorId:="{}"
+```
+
+With [schema validation](#schema-validation), agents can ensure stability of integrations and faster failure recovery.
+Agents, make no harm!
 
-`mcpc` is designed for automation: shell scripting, schema validation for stable behavior, and AI agent integration.
+See an [example](./docs/examples/company-lookup.sh) of an AI-generated shell script.
 
 ### Scripting
 
@@ -587,9 +611,11 @@ for tool in $(mcpc --json @server tools-list | jq -r '.[].name'); do
 done
 ```
 
+For a complete example script, see [`docs/examples/company-lookup.sh`](./docs/examples/company-lookup.sh).
+
 ### Schema validation
 
-Validate tool/prompt schemas to detect breaking changes early:
+Validate tool/prompt schemas using the `--schema` option to detect breaking changes early:
 
 ```bash
 # Save expected schema
@@ -599,41 +625,17 @@ mcpc --json @apify tools-get search-actors > expected.json
 mcpc @apify tools-call search-actors --schema expected.json keywords:="test"
 ```
 
-Schema modes (`--schema-mode`):
-- `compatible` (default) - New optional fields OK, required fields must match. Output schema validated (new output fields OK, removed fields cause error).
-- `strict` - Exact match required for all fields, types, and descriptions
-- `ignore` - Skip validation
-
+Available schema validation modes (`--schema-mode`):
+- `compatible` (default)
+  - Input schema: new optional fields OK, required fields must have the same type.
+  - Output schema: new fields OK, removed required fields cause error.
+- `strict` - Both input and output schemas must match exactly, including all fields, types, and descriptions
+- `ignore` - Skip validation completely (YOLO)
 
-### AI agents
-
-`mcpc` is designed for use by AI agents, in both interactive MCP tool calling mode
-and "[code mode](https://blog.cloudflare.com/code-mode/)".
-
-- **Tool calling mode** - CLI-based AI agents can dynamically explore and interact with the MCP server, thanks to the default Markdown-ish output.
-  Similar to MCP connectors in ChatGPT or Claude, but via CLI and with much longer command timeouts.  
-- **Code mode** - AI coding agents can write and execute shell [scripts](#scripting) composing multiple MCP server operations,
-  thanks to the `--json` output mode and access to MCP server schemas.
-  For well-defined workflow scenarios, this approach can be [more accurate](https://www.anthropic.com/engineering/code-execution-with-mcp)
-  and use fewer tokens.
-
-AI agents can discover and use tools via shell commands:
-
-```bash
-mcpc @server tools-list
-mcpc --json @server tools-get search | jq '.inputSchema'
-mcpc @server tools-call search query:="hello world"
-```
-
-and then generate shell scripts to execute sequences of actions,
-with `--schema` checks to ensure stability of integrations and faster failure recovery.
-Agents, make no harm!
-
-#### AI sandbox access
+### AI sandboxes
 
 To ensure AI coding agents don't perform destructive actions or leak credentials,
-it's always a good idea to run them in a code sandbox
-with limited access to your resources.
+it's always a good idea to run them in a code sandbox with limited access to your resources.
 
 The [proxy MCP server](#mcp-proxy) feature provides a security boundary for AI agents:
 
@@ -651,7 +653,7 @@ Local stdio servers will still have access to your local system, and HTTP server
 and both can easily perform destructive actions or leak credentials on their own, or let MCP clients do such actions.
 **Always use only trusted local and remote MCP servers and limit their access to the necessary minimum.**
 
-#### Agent skills
+### Agent skills
 
 To help Claude Code use `mcpc`, you can install this [Claude skill](./docs/claude-skill/README.md):
 
@@ -678,7 +680,7 @@ To help Claude Code use `mcpc`, you can install this [Claude skill](./docs/claud
 
 The bridge process manages the full MCP session lifecycle:
 - Performs initialization handshake (`initialize` → `initialized`)
-- Negotiates protocol version (currently `2025-11-25`) and capabilities
+- Negotiates protocol version and capabilities
 - Fetches server-provided `instructions`
 - Maintains persistent HTTP connections with bidirectional streaming, or stdio bidirectional pipe to subprocess
 - Handles `MCP-Protocol-Version` and `MCP-Session-Id` headers automatically
@@ -718,15 +720,18 @@ mcpc @apify --json
 
 In [JSON mode](#json-mode), the resulting object adheres
 to [`InitializeResult`](https://modelcontextprotocol.io/specification/latest/schema#initializeresult) object schema,
-and `mcpc` includes additional `_meta` fields to provide server metadata.
+and includes the `_mcpc` field with relevant server/session metadata.
 
 ```json
 {
-  "_meta": {
+  "_mcpc": {
     "sessionName": "@apify",
     "profileName": "default",
     "server": {
       "url": "https://mcp.apify.com"
+    },
+    "notifications": {
+      "tools": { "listChangedAt": "2026-01-01T00:42:58.049Z" }
     }
   },
   "protocolVersion": "2025-06-18",
@@ -801,8 +806,10 @@ mcpc @apify resources-templates-list
 
 When connected via a [session](#sessions), `mcpc` automatically handles `list_changed`
 notifications for tools, resources, and prompts.
-The bridge process updates the session record so the caller can detect and react on these notifications.
+The bridge process tracks when each notification type was last received.
 In [shell mode](#interactive-shell), notifications are displayed in real-time.
+The timestamps are available in JSON output of `mcpc <target> --json` under the `_mcpc.notifications`
+field - see [Server instructions](#server-instructions).
 
 #### Server logs
 
@@ -969,7 +976,7 @@ mcpc --clean=all           # Delete all sessions, profiles, logs, and sockets
 
 ## Security
 
-`mcpc` follows [MCP security best practices](https://modelcontextprotocol.io/specification/2025-11-25/basic/security_best_practices).
+`mcpc` follows [MCP security best practices](https://modelcontextprotocol.io/specification/latest/basic/security_best_practices).
 MCP enables arbitrary tool execution and data access - treat servers like you treat shells:
 
 - Use least-privilege tokens/headers
@@ -995,7 +1002,7 @@ MCP enables arbitrary tool execution and data access - treat servers like you tr
 
 ### AI security
 
-See [AI sandbox access](#ai-sandbox-access) for details.
+See [AI sandboxes](#ai-sandboxes) for details.
 
 ## Errors
 
@@ -1050,10 +1057,10 @@ The main `mcpc` process doesn't save log files, but supports [verbose mode](#ver
 
 ## Development
 
-`mcpc` was built by [Jan Curn](https://x.com/jancurn) of [Apify](https://apify.com) with the help of Claude Code during the late nights of Xmas 
-2025 in North Beach, San Francisco.
+The initial version of `mcpc` was developed by [Jan Curn](https://x.com/jancurn) of [Apify](https://apify.com)
+with the help of Claude Code, during late nights over Christmas 2025 in North Beach, San Francisco.
 
-See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup, architecture overview, and contribution guidelines.
+See [CONTRIBUTING](./CONTRIBUTING.md) for development setup, architecture overview, and contribution guidelines.
 
 ## License