@apify/mcpc 0.1.7 → 0.1.9

package/.claude/settings.local.json

@@ -97,7 +97,18 @@
       "Bash(E2E_ISOLATED_ALL=1 TESTS=\"human-output output-invariants\" ./test/e2e/run.sh:*)",
       "Bash(E2E_ISOLATED_ALL=1 TESTS=\"output-invariants human-output\" ./test/e2e/run.sh:*)",
       "Bash(npm publish:*)",
-      "Bash(MCPC_RELEASE=1 npm publish:*)"
+      "Bash(MCPC_RELEASE=1 npm publish:*)",
+      "WebFetch(domain:www.philschmid.de)",
+      "Bash(mcpc @apify close:*)",
+      "Bash(mcpc:*)",
+      "Bash(__NEW_LINE_be84ee31121f5014__ echo \"\")",
+      "Bash(MCPC_HOME_DIR=/tmp/mcpc-test-restart ./dist/cli/index.js:*)",
+      "Bash(./dist/cli/index.js:*)",
+      "Bash(./dist/cli/index.js @test-restart close:*)",
+      "Bash(MCPC_HOME_DIR=/tmp/mcpc-test-json node:*)",
+      "Bash(MCPC_HOME_DIR=/tmp/mcpc-test-json MCPC_VERBOSE=1 node:*)",
+      "Bash(MCPC_HOME_DIR=/tmp/mcpc-test-json DEBUG=* node:*)",
+      "Bash(MCPC_HOME_DIR=/tmp/mcpc-test-new node:*)"
     ]
   }
 }

package/.idea/workspace.xml

@@ -4,9 +4,8 @@
     <option name="autoReloadType" value="SELECTIVE" />
   </component>
   <component name="ChangeListManager">
-    <list default="true" id="84071bae-f051-424d-a0e4-1540170b1e94" name="Changes" comment="Docs">
-      <change beforePath="$PROJECT_DIR$/docs/TODOs.md" beforeDir="false" afterPath="$PROJECT_DIR$/docs/TODOs.md" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/cli/index.ts" beforeDir="false" afterPath="$PROJECT_DIR$/src/cli/index.ts" afterDir="false" />
+    <list default="true" id="84071bae-f051-424d-a0e4-1540170b1e94" name="Changes" comment="`tools-list` now shows only a compact list to support dynamic tool discovery, added --full option for full details">
+      <change beforePath="$PROJECT_DIR$/CHANGELOG.md" beforeDir="false" afterPath="$PROJECT_DIR$/CHANGELOG.md" afterDir="false" />
     </list>
     <option name="SHOW_DIALOG" value="false" />
     <option name="HIGHLIGHT_CONFLICTS" value="true" />
@@ -14,7 +13,7 @@
     <option name="LAST_RESOLUTION" value="IGNORE" />
   </component>
   <component name="EmbeddingIndexingInfo">
-    <option name="cachedIndexableFilesCount" value="118" />
+    <option name="cachedIndexableFilesCount" value="120" />
     <option name="fileBasedEmbeddingIndicesEnabled" value="true" />
   </component>
   <component name="Git.Settings">
@@ -82,9 +81,9 @@
       <recent name="$PROJECT_DIR$/docs" />
     </key>
     <key name="MoveFile.RECENT_KEYS">
+      <recent name="$PROJECT_DIR$/docs" />
       <recent name="$PROJECT_DIR$/docs/images" />
       <recent name="$PROJECT_DIR$/docs/examples" />
-      <recent name="$PROJECT_DIR$/docs" />
       <recent name="$PROJECT_DIR$/test/coverage" />
       <recent name="$PROJECT_DIR$/test/playground" />
     </key>
@@ -115,159 +114,7 @@
       <workItem from="1766435124813" duration="175094000" />
       <workItem from="1767121309931" duration="139790000" />
       <workItem from="1767397304824" duration="654000" />
-      <workItem from="1767400124038" duration="5456000" />
-    </task>
-    <task id="LOCAL-00301" summary="Writing">
-      <option name="closed" value="true" />
-      <created>1767256060393</created>
-      <option name="number" value="00301" />
-      <option name="presentableId" value="LOCAL-00301" />
-      <option name="project" value="LOCAL" />
-      <updated>1767256060393</updated>
-    </task>
-    <task id="LOCAL-00302" summary="Writing">
-      <option name="closed" value="true" />
-      <created>1767256636124</created>
-      <option name="number" value="00302" />
-      <option name="presentableId" value="LOCAL-00302" />
-      <option name="project" value="LOCAL" />
-      <updated>1767256636124</updated>
-    </task>
-    <task id="LOCAL-00303" summary="Tests">
-      <option name="closed" value="true" />
-      <created>1767256961080</created>
-      <option name="number" value="00303" />
-      <option name="presentableId" value="LOCAL-00303" />
-      <option name="project" value="LOCAL" />
-      <updated>1767256961080</updated>
-    </task>
-    <task id="LOCAL-00304" summary="Renamed &quot;session&quot; to &quot;connect&quot;, it's feels better">
-      <option name="closed" value="true" />
-      <created>1767257359213</created>
-      <option name="number" value="00304" />
-      <option name="presentableId" value="LOCAL-00304" />
-      <option name="project" value="LOCAL" />
-      <updated>1767257359213</updated>
-    </task>
-    <task id="LOCAL-00305" summary="Fixed --timeout">
-      <option name="closed" value="true" />
-      <created>1767258330178</created>
-      <option name="number" value="00305" />
-      <option name="presentableId" value="LOCAL-00305" />
-      <option name="project" value="LOCAL" />
-      <updated>1767258330178</updated>
-    </task>
-    <task id="LOCAL-00306" summary="Fixes">
-      <option name="closed" value="true" />
-      <created>1767258961101</created>
-      <option name="number" value="00306" />
-      <option name="presentableId" value="LOCAL-00306" />
-      <option name="project" value="LOCAL" />
-      <updated>1767258961101</updated>
-    </task>
-    <task id="LOCAL-00307" summary="Writing">
-      <option name="closed" value="true" />
-      <created>1767260069457</created>
-      <option name="number" value="00307" />
-      <option name="presentableId" value="LOCAL-00307" />
-      <option name="project" value="LOCAL" />
-      <updated>1767260069457</updated>
-    </task>
-    <task id="LOCAL-00308" summary="Cosmetic">
-      <option name="closed" value="true" />
-      <created>1767260684183</created>
-      <option name="number" value="00308" />
-      <option name="presentableId" value="LOCAL-00308" />
-      <option name="project" value="LOCAL" />
-      <updated>1767260684183</updated>
-    </task>
-    <task id="LOCAL-00309" summary="Implemented --proxy command">
-      <option name="closed" value="true" />
-      <created>1767260968448</created>
-      <option name="number" value="00309" />
-      <option name="presentableId" value="LOCAL-00309" />
-      <option name="project" value="LOCAL" />
-      <updated>1767260968448</updated>
-    </task>
-    <task id="LOCAL-00310" summary="Writing and tests">
-      <option name="closed" value="true" />
-      <created>1767262727887</created>
-      <option name="number" value="00310" />
-      <option name="presentableId" value="LOCAL-00310" />
-      <option name="project" value="LOCAL" />
-      <updated>1767262727887</updated>
-    </task>
-    <task id="LOCAL-00311" summary="Writing">
-      <option name="closed" value="true" />
-      <created>1767262976779</created>
-      <option name="number" value="00311" />
-      <option name="presentableId" value="LOCAL-00311" />
-      <option name="project" value="LOCAL" />
-      <updated>1767262976779</updated>
-    </task>
-    <task id="LOCAL-00312" summary="Tests and nits">
-      <option name="closed" value="true" />
-      <created>1767263177871</created>
-      <option name="number" value="00312" />
-      <option name="presentableId" value="LOCAL-00312" />
-      <option name="project" value="LOCAL" />
-      <updated>1767263177871</updated>
-    </task>
-    <task id="LOCAL-00313" summary="Final touches">
-      <option name="closed" value="true" />
-      <created>1767264480849</created>
-      <option name="number" value="00313" />
-      <option name="presentableId" value="LOCAL-00313" />
-      <option name="project" value="LOCAL" />
-      <updated>1767264480849</updated>
-    </task>
-    <task id="LOCAL-00314" summary="Final touches">
-      <option name="closed" value="true" />
-      <created>1767264631473</created>
-      <option name="number" value="00314" />
-      <option name="presentableId" value="LOCAL-00314" />
-      <option name="project" value="LOCAL" />
-      <updated>1767264631473</updated>
-    </task>
-    <task id="LOCAL-00315" summary="Final touches">
-      <option name="closed" value="true" />
-      <created>1767295534266</created>
-      <option name="number" value="00315" />
-      <option name="presentableId" value="LOCAL-00315" />
-      <option name="project" value="LOCAL" />
-      <updated>1767295534266</updated>
-    </task>
-    <task id="LOCAL-00316" summary="More tests">
-      <option name="closed" value="true" />
-      <created>1767300734831</created>
-      <option name="number" value="00316" />
-      <option name="presentableId" value="LOCAL-00316" />
-      <option name="project" value="LOCAL" />
-      <updated>1767300734831</updated>
-    </task>
-    <task id="LOCAL-00317" summary="Writing">
-      <option name="closed" value="true" />
-      <created>1767303169928</created>
-      <option name="number" value="00317" />
-      <option name="presentableId" value="LOCAL-00317" />
-      <option name="project" value="LOCAL" />
-      <updated>1767303169928</updated>
-    </task>
-    <task id="LOCAL-00318" summary="Writing">
-      <option name="closed" value="true" />
-      <created>1767304929607</created>
-      <option name="number" value="00318" />
-      <option name="presentableId" value="LOCAL-00318" />
-      <option name="project" value="LOCAL" />
-      <updated>1767304929607</updated>
-    </task>
-    <task id="LOCAL-00319" summary="Renamed &quot;dead&quot; to &quot;crashed&quot; session, final touches">
-      <option name="closed" value="true" />
-      <created>1767305903020</created>
-      <option name="number" value="00319" />
-      <option name="presentableId" value="LOCAL-00319" />
-      <option name="project" value="LOCAL" />
-      <updated>1767305903020</updated>
+      <workItem from="1767400124038" duration="78154000" />
     </task>
     <task id="LOCAL-00320" summary="Final touches">
       <option name="closed" value="true" />
@@ -509,7 +356,159 @@
       <option name="project" value="LOCAL" />
       <updated>1767467232772</updated>
     </task>
-    <option name="localTasksCounter" value="350" />
+    <task id="LOCAL-00350" summary="Docs">
+      <option name="closed" value="true" />
+      <created>1767495856786</created>
+      <option name="number" value="00350" />
+      <option name="presentableId" value="LOCAL-00350" />
+      <option name="project" value="LOCAL" />
+      <updated>1767495856786</updated>
+    </task>
+    <task id="LOCAL-00351" summary="Docs">
+      <option name="closed" value="true" />
+      <created>1767496287506</created>
+      <option name="number" value="00351" />
+      <option name="presentableId" value="LOCAL-00351" />
+      <option name="project" value="LOCAL" />
+      <updated>1767496287506</updated>
+    </task>
+    <task id="LOCAL-00352" summary="Docs">
+      <option name="closed" value="true" />
+      <created>1767501783702</created>
+      <option name="number" value="00352" />
+      <option name="presentableId" value="LOCAL-00352" />
+      <option name="project" value="LOCAL" />
+      <updated>1767501783702</updated>
+    </task>
+    <task id="LOCAL-00353" summary="Docs">
+      <option name="closed" value="true" />
+      <created>1767555748507</created>
+      <option name="number" value="00353" />
+      <option name="presentableId" value="LOCAL-00353" />
+      <option name="project" value="LOCAL" />
+      <updated>1767555748507</updated>
+    </task>
+    <task id="LOCAL-00354" summary="Docs">
+      <option name="closed" value="true" />
+      <created>1767561058376</created>
+      <option name="number" value="00354" />
+      <option name="presentableId" value="LOCAL-00354" />
+      <option name="project" value="LOCAL" />
+      <updated>1767561058377</updated>
+    </task>
+    <task id="LOCAL-00355" summary="Docs">
+      <option name="closed" value="true" />
+      <created>1767949515517</created>
+      <option name="number" value="00355" />
+      <option name="presentableId" value="LOCAL-00355" />
+      <option name="project" value="LOCAL" />
+      <updated>1767949515517</updated>
+    </task>
+    <task id="LOCAL-00356" summary="Docs">
+      <option name="closed" value="true" />
+      <created>1767950436457</created>
+      <option name="number" value="00356" />
+      <option name="presentableId" value="LOCAL-00356" />
+      <option name="project" value="LOCAL" />
+      <updated>1767950436457</updated>
+    </task>
+    <task id="LOCAL-00357" summary="Docs">
+      <option name="closed" value="true" />
+      <created>1768313561028</created>
+      <option name="number" value="00357" />
+      <option name="presentableId" value="LOCAL-00357" />
+      <option name="project" value="LOCAL" />
+      <updated>1768313561028</updated>
+    </task>
+    <task id="LOCAL-00358" summary="TS code mode draft">
+      <option name="closed" value="true" />
+      <created>1768313607831</created>
+      <option name="number" value="00358" />
+      <option name="presentableId" value="LOCAL-00358" />
+      <option name="project" value="LOCAL" />
+      <updated>1768313607831</updated>
+    </task>
+    <task id="LOCAL-00359" summary="Improved session expiration handling">
+      <option name="closed" value="true" />
+      <created>1768314790513</created>
+      <option name="number" value="00359" />
+      <option name="presentableId" value="LOCAL-00359" />
+      <option name="project" value="LOCAL" />
+      <updated>1768314790513</updated>
+    </task>
+    <task id="LOCAL-00360" summary="Fixed incorrect flagging of expired sessions as dead">
+      <option name="closed" value="true" />
+      <created>1768469231118</created>
+      <option name="number" value="00360" />
+      <option name="presentableId" value="LOCAL-00360" />
+      <option name="project" value="LOCAL" />
+      <updated>1768469231118</updated>
+    </task>
+    <task id="LOCAL-00361" summary="Copy">
+      <option name="closed" value="true" />
+      <created>1768470113068</created>
+      <option name="number" value="00361" />
+      <option name="presentableId" value="LOCAL-00361" />
+      <option name="project" value="LOCAL" />
+      <updated>1768470113068</updated>
+    </task>
+    <task id="LOCAL-00362" summary="Fixed help">
+      <option name="closed" value="true" />
+      <created>1768473976578</created>
+      <option name="number" value="00362" />
+      <option name="presentableId" value="LOCAL-00362" />
+      <option name="project" value="LOCAL" />
+      <updated>1768473976578</updated>
+    </task>
+    <task id="LOCAL-00363" summary="Nits">
+      <option name="closed" value="true" />
+      <created>1768474365832</created>
+      <option name="number" value="00363" />
+      <option name="presentableId" value="LOCAL-00363" />
+      <option name="project" value="LOCAL" />
+      <updated>1768474365832</updated>
+    </task>
+    <task id="LOCAL-00364" summary="Require explicit restart when server rejects MCP session ID&#10;&#10;Remove automatic reconnection when server rejects session ID during bridge restart. Session is now marked as 'expired' and user must explicitly run 'mcpc @session restart' to create a fresh session.">
+      <option name="closed" value="true" />
+      <created>1769003190833</created>
+      <option name="number" value="00364" />
+      <option name="presentableId" value="LOCAL-00364" />
+      <option name="project" value="LOCAL" />
+      <updated>1769003190833</updated>
+    </task>
+    <task id="LOCAL-00365" summary="Fixes">
+      <option name="closed" value="true" />
+      <created>1769003457187</created>
+      <option name="number" value="00365" />
+      <option name="presentableId" value="LOCAL-00365" />
+      <option name="project" value="LOCAL" />
+      <updated>1769003457187</updated>
+    </task>
+    <task id="LOCAL-00366" summary="Added changelog, better release process">
+      <option name="closed" value="true" />
+      <created>1769005694924</created>
+      <option name="number" value="00366" />
+      <option name="presentableId" value="LOCAL-00366" />
+      <option name="project" value="LOCAL" />
+      <updated>1769005694924</updated>
+    </task>
+    <task id="LOCAL-00367" summary="Updated package.json URLs">
+      <option name="closed" value="true" />
+      <created>1769505670158</created>
+      <option name="number" value="00367" />
+      <option name="presentableId" value="LOCAL-00367" />
+      <option name="project" value="LOCAL" />
+      <updated>1769505670158</updated>
+    </task>
+    <task id="LOCAL-00368" summary="`tools-list` now shows only a compact list to support dynamic tool discovery, added --full option for full details">
+      <option name="closed" value="true" />
+      <created>1770064327434</created>
+      <option name="number" value="00368" />
+      <option name="presentableId" value="LOCAL-00368" />
+      <option name="project" value="LOCAL" />
+      <updated>1770064327434</updated>
+    </task>
+    <option name="localTasksCounter" value="369" />
     <servers />
   </component>
   <component name="TypeScriptGeneratedFilesManager">
@@ -616,15 +615,6 @@
     </option>
   </component>
   <component name="VcsManagerConfiguration">
-    <MESSAGE value="Fixed handling --schema for outputSchema" />
-    <MESSAGE value="Tests" />
-    <MESSAGE value="Renamed &quot;session&quot; to &quot;connect&quot;, it's feels better" />
-    <MESSAGE value="Fixed --timeout" />
-    <MESSAGE value="Implemented --proxy command" />
-    <MESSAGE value="Writing and tests" />
-    <MESSAGE value="Tests and nits" />
-    <MESSAGE value="More tests" />
-    <MESSAGE value="Renamed &quot;dead&quot; to &quot;crashed&quot; session, final touches" />
     <MESSAGE value="Final touches" />
     <MESSAGE value="More final touches" />
     <MESSAGE value="Even more final touches" />
@@ -638,9 +628,18 @@
     <MESSAGE value="Cosmetic" />
     <MESSAGE value="New gif in README" />
     <MESSAGE value="Cosmetic improvements" />
+    <MESSAGE value="Docs" />
+    <MESSAGE value="TS code mode draft" />
+    <MESSAGE value="Improved session expiration handling" />
+    <MESSAGE value="Fixed incorrect flagging of expired sessions as dead" />
+    <MESSAGE value="Copy" />
+    <MESSAGE value="Fixed help" />
     <MESSAGE value="Nits" />
+    <MESSAGE value="Require explicit restart when server rejects MCP session ID&#10;&#10;Remove automatic reconnection when server rejects session ID during bridge restart. Session is now marked as 'expired' and user must explicitly run 'mcpc @session restart' to create a fresh session." />
     <MESSAGE value="Fixes" />
-    <MESSAGE value="Docs" />
-    <option name="LAST_COMMIT_MESSAGE" value="Docs" />
+    <MESSAGE value="Added changelog, better release process" />
+    <MESSAGE value="Updated package.json URLs" />
+    <MESSAGE value="`tools-list` now shows only a compact list to support dynamic tool discovery, added --full option for full details" />
+    <option name="LAST_COMMIT_MESSAGE" value="`tools-list` now shows only a compact list to support dynamic tool discovery, added --full option for full details" />
   </component>
 </project>

package/CHANGELOG.md

@@ -0,0 +1,97 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.9] - 2026-02-02
+
+### Added
+- Added CHANGELOG.md for tracking changes
+- Automated GitHub release creation in publish script
+
+### Changed
+- `tools-list` now shows a compact summary by default to support dynamic tool discovery
+- Added `--full` flag to `tools-list` for detailed tool information
+- Publish script now automatically updates CHANGELOG.md version on release
+
+## [0.1.8] - 2026-01-21
+
+### Changed
+- Session is now marked as expired (not auto-reconnected) when server rejects MCP session ID
+- Users must explicitly run `mcpc @session restart` to recover from expired sessions
+
+### Fixed
+- Fixed incorrect flagging of expired sessions as crashed
+- Fixed session expiration detection for various error message formats
+- Fixed help command output
+
+## [0.1.7] - 2026-01-03
+
+### Changed
+- Documentation improvements and updates
+- Various cosmetic improvements to CLI output
+
+### Fixed
+- Minor bug fixes
+
+## [0.1.6] - 2026-01-02
+
+### Added
+- Session notifications with timestamps for tracking list changes (`tools/list_changed`, `resources/list_changed`, `prompts/list_changed`)
+
+### Changed
+- Renamed `_meta` to `_mcpc` in JSON output for MCP spec conformance
+- Improved formatting of prompts output
+- Various cosmetic improvements
+
+### Fixed
+- Fixed proxy server issues
+- Fixed screenshot URL in README
+
+## [0.1.5] - 2026-01-01
+
+### Added
+- Implemented `--proxy` option for exposing sessions as local MCP servers
+- Added `mcpc @session restart` command
+
+### Changed
+- Renamed `session` command to `connect` for clarity
+- Renamed "dead" session status to "crashed" for clarity
+
+### Fixed
+- Fixed `--timeout` option handling
+
+## [0.1.4] - 2025-12-31
+
+### Added
+- Implemented `--schema` and `--schema-mode` options for tools
+- Added `mcpc @session restart` command
+
+### Changed
+- Renamed `tools-schema` command to `tools-get`
+- Improved formatting for prompts and tools output
+- Security review and improvements
+
+## [0.1.3] - 2025-12-29
+
+### Added
+- Initial public release
+- Support for Streamable HTTP and stdio transports
+- Session management with persistent bridge processes
+- OAuth 2.1 authentication with PKCE
+- Full MCP protocol support: tools, resources, prompts
+- Interactive shell mode
+- JSON output mode for scripting
+
+[Unreleased]: https://github.com/apify/mcpc/compare/v0.1.9...HEAD
+[0.1.9]: https://github.com/apify/mcpc/compare/v0.1.8...v0.1.9
+[0.1.8]: https://github.com/apify/mcpc/compare/v0.1.7...v0.1.8
+[0.1.7]: https://github.com/apify/mcpc/compare/v0.1.6...v0.1.7
+[0.1.6]: https://github.com/apify/mcpc/compare/v0.1.5...v0.1.6
+[0.1.5]: https://github.com/apify/mcpc/compare/v0.1.4...v0.1.5
+[0.1.4]: https://github.com/apify/mcpc/compare/v0.1.3...v0.1.4
+[0.1.3]: https://github.com/apify/mcpc/releases/tag/v0.1.3

package/README.md

@@ -10,13 +10,13 @@ After all, UNIX-compatible shell script is THE most universal coding language.
 ![mcpc screenshot](https://raw.githubusercontent.com/apify/mcpc/main/docs/images/mcpc-demo.gif)
 
 **Key features:**
-- 🌎 **Highly compatible** - Works with any MCP server over Streamable HTTP or stdio.
+- 🌎 **Compatible** - Works with any MCP server over Streamable HTTP or stdio.
 - 🔄 **Persistent sessions** - Keep multiple server connections alive simultaneously.
-- 🚀 **Zero setup** - Connect to remote servers instantly with just a URL.
 - 🔧 **Strong MCP support** - Instructions, tools, resources, prompts, dynamic discovery.
-- 🔌 **JSON output** - Easy integration with `jq`, scripts, and other CLI tools.
-- 🤖 **AI-friendly** - Designed for both function calling and code mode with sandboxing.
+- 🔌 **Code mode** - JSON output enables integration with CLI tools like `jq` and scripting.
+- 🤖 **AI sandboxing** - MCP proxy server to securely access authenticated sessions from AI-generated code.
 - 🔒 **Secure** - Full OAuth 2.1 support, OS keychain for credentials storage.
+- 🪶 **Lightweight** - Minimal dependencies, works on Mac/Win/Linux, doesn't use LLMs on its own.
 
 
 ## Table of contents
@@ -36,6 +36,7 @@ After all, UNIX-compatible shell script is THE most universal coding language.
 - [Security](#security)
 - [Errors](#errors)
 - [Development](#development)
+- [Related work](#related-work)
 - [License](#license)
 
 <!-- END doctoc generated TOC please keep comment here to allow auto update -->
@@ -101,7 +102,7 @@ Options:
   -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" if skipped)
+  --profile <name>              OAuth profile for the server ("default" if not provided)
   --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)
@@ -115,17 +116,17 @@ Targets:
   <config-entry>                Entry in MCP config file specified by --config (e.g. "fs")
   <server-url>                  Remote MCP server URL (e.g. "mcp.apify.com")
 
-Management commands (<target> missing):
-  login                         Create OAuth profile with credentials to access remote server
+Management commands:
+  login                         Create OAuth profile with credentials for remote server
   logout                        Remove OAuth profile for remote server
   connect @<session>            Connect to server and create named persistent session
-  restart @<session>            Kill and restart a session
-  close @<session>              Close a session
+  restart                       Kill and restart a session
+  close                         Close a session
 
-MCP commands (<target> provided):
+MCP server commands:
   help                          Show server info ("help" can be omitted)
   shell                         Open interactive shell
-  tools-list                    Send "tools/list" MCP request...
+  tools-list [--full]           Send "tools/list" MCP request...
   tools-get <tool-name>
   tools-call <tool-name> [arg1:=val1 arg2:=val2 ... | <args-json> | <stdin]
   prompts-list
@@ -138,12 +139,13 @@ MCP commands (<target> provided):
   resources-templates-list
   logging-set-level <level>
   ping
-
+  
+Run "mcpc" (without <target>) to show available sessions and profiles.
 ```
 
-### Management commands
+### General actions
 
-When `<target>` is missing, `mcpc` provides general management commands.
+When `<target>` is omitted, `mcpc` provides general actions:
 
 ```bash
 # List all sessions and OAuth profiles (also in JSON mode)
@@ -154,15 +156,13 @@ mcpc --json
 mcpc --help
 mcpc --version
 
-# Clean expired sessions and old log files
+# Clean expired sessions and old log files (see below for details)
 mcpc --clean
 ```
 
-For additional management commands, see [OAuth profiles](#oauth-profiles) and [Cleanup](#cleanup).
-
 ### Targets
 
-To connect to an MCP server, you need to specify a `<target>`, which can be one of (in order of precedence):
+To connect and interact with an MCP server, you need to specify a `<target>`, which can be one of (in this order of precedence):
 
 - **Entry in a config file** (e.g. `--config .vscode/mcp.json filesystem`) - see [Config file](#mcp-server-config-file)
 - **Remote MCP server URL** (e.g. `https://mcp.apify.com`)
@@ -178,7 +178,7 @@ connects, and enables you to interact with it.
 
 ### MCP commands
 
-Examples of sending MCP commands to various targets:
+When `<target>` is provided, `mcpc` sends MCP requests to the target server:
 
 ```bash
 # Server from config file (stdio)
@@ -754,10 +754,13 @@ and includes the `_mcpc` field with relevant server/session metadata.
 List, inspect, and call server-provided tools:
 
 ```bash
-# List available tools
+# List available tools (only names and attributes - useful for dynamic discovery)
 mcpc @apify tools-list
 
-# Get tool schema details
+# List available tools (full details including input/output args and description)
+mcpc @apify tools-list --full
+
+# Get tool schema with full details
 mcpc @apify tools-get search-actors
 
 # Call a tool with arguments
@@ -1057,11 +1060,26 @@ The main `mcpc` process doesn't save log files, but supports [verbose mode](#ver
 
 ## Development
 
-The initial version of `mcpc` was developed by [Jan Curn](https://x.com/jancurn) of [Apify](https://apify.com)
+The initial version of `mcpc` was developed and [launched by Jan Curn](https://x.com/jancurn/status/2007144080959291756) of [Apify](https://apify.com)
 with the help of Claude Code, during late nights over Christmas 2025 in North Beach, San Francisco.
 
 See [CONTRIBUTING](./CONTRIBUTING.md) for development setup, architecture overview, and contribution guidelines.
 
+## Related work
+
+- https://github.com/steipete/mcporter
+- https://github.com/philschmid/mcp-cli (https://www.philschmid.de/mcp-cli)
+- https://github.com/chrishayuk/mcp-cli
+- https://github.com/wong2/mcp-cli
+- https://github.com/f/mcptools
+- https://github.com/adhikasp/mcp-client-cli
+- https://github.com/mattzcarey/cloudflare-mcp 
+- https://github.com/TeamSparkAI/mcpGraph
+- https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-search-tool (https://x.com/trq212/status/2011523109871108570)
+- https://cursor.com/blog/dynamic-context-discovery
+- https://www.anthropic.com/engineering/code-execution-with-mcp
+- https://blog.cloudflare.com/code-mode/
+
 ## License
 
 Apache-2.0 - see [LICENSE](./LICENSE) for details.