@portofcontext/pctx 0.3.0 → 0.4.1

package/CHANGELOG.md

@@ -9,15 +9,41 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
--
+### Changed
+
+### Fixed
+
+## [v0.4.1] - 2026-01-12
+
+### Added
+
+- Improve instrumentation
+- Optional `search_functions` in the python client to allow the LLM to search
+  for tools by name/description before deciding which tool to call.
+
+### Changed
+
+### Fixed
+## [v0.4.0] - 2025-12-31
+
+### Added
+
+- Stdio MCP server support for upstreams via `pctx.json` (`command`, `args`, `env`).
+- `pctx mcp add` now supports stdio MCP servers via `--command`, `--arg`, and `--env` flags.
+- `pctx mcp start --stdio` to serve the MCP interface over stdio.
+- Logger configuration now supports optional `file` field to write logs to a file.
 
 ### Changed
 
--
+- `pctx mcp add` now accepts either a URL (for HTTP servers) or `--command` (for stdio servers), making it a unified interface for adding all types of MCP servers.
+- Logger output behavior is now mode-aware to ensure stdio compatibility:
+  - `--stdio` mode without `logger.file`: logging is automatically disabled to keep stdout/stderr clean for JSON-RPC communication
+  - `--stdio` mode with `logger.file`: logs write to the specified file
+  - HTTP mode: logs write to stdout (default behavior)
 
 ### Fixed
 
--
+- Improved error handling for stdio config and MCP initialization failures.
 
 ## [v0.3.0] - 2025-12-16
 

package/README.md

@@ -30,9 +30,10 @@ npm i -g @portofcontext/pctx
 ```
 
 ## Core Functionality
+
 pctx can be run as a stateless HTTP server for Code Mode sessions or as a unified MCP server that exposes Code Mode functionality for registered upstream MCP servers.
 
-```bash 
+```bash
 # Start Code Mode for Python SDK
 pctx start
 
@@ -42,10 +43,13 @@ pctx mcp dev
 ```
 
 ## Python SDK
+
 Use the Python SDK if building agents in Python and want to run Code Mode with custom tools and/or MCP servers. The Python SDK is an HTTP client to the `pctx` server.
+
 ```bash
-uv pip install pctx-client
+pip install pctx-client
 ```
+
 ```python
 from pctx_client import Pctx, tool
 from agents import Agent # Use any Agent SDK
@@ -66,26 +70,33 @@ agent = Agent(
     tools=tools,
 )
 ```
-Complete Docs: [Python SDK Quickstart and Docs](./pctx-py/README.md)
+
+### Links
+
+- [Python SDK Quickstart and Docs](./pctx-py/README.md)
+- [Python API Reference](https://pctx.readthedocs.io/en/latest/)
 
 ## Node SDK
+
 Coming soon
 
 ## Unified MCP
-Use the unified MCP to run Code Mode with MCP servers and want to persist the authentication connections and you do not need to register local tools.
+
+Use the unified MCP to run Code Mode with MCP servers and want to persist the authentication connections and you do not need to use agent tools (non-mcp tools).
 
 ```bash
 # Initialize config for upstream mcp connections
 pctx mcp init
 
-# Connect to any MCP server
-pctx mcp add my-local-server http://localhost:3000/mcp
+# Add HTTP or stdio MCP servers
 pctx mcp add stripe https://mcp.stripe.com
+pctx mcp add memory --command "npx -y @modelcontextprotocol/server-memory"
 
-# Start the unified MCP server in dev mode
+# Start as HTTP server (dev mode with UI)
 pctx mcp dev
 
-# copy server url and connect to agents with --transport http
+# Or start as stdio MCP server
+pctx mcp start --stdio
 ```
 
 For complete CLI documentation, see [CLI.md](docs/CLI.md).
@@ -126,6 +137,7 @@ console.log(`Found ${orders.length} orders`);
 - **Secure authentication**: Source secrets from environment variables, system keychain, and external commands. See [Authentication Section](docs/config.md#authentication) in the CLI configuration docs for more details.
 
 ## Architecture
+
 <img width="1020" height="757" alt="Screenshot 2025-11-21 at 11 03 20 AM" src="./docs/pctx-architecture.svg" />
 
 ## Security
@@ -150,6 +162,11 @@ npm upgrade -g @portofcontext/pctx
 
 ```
 
+## Develop
+
+- For core dev: install rust and jump into `crates/`
+- Client SDK dev: find the README in the SDK
+
 ## Learn More
 
 - [Model Context Protocol (MCP)](https://modelcontextprotocol.io/)

package/npm-shrinkwrap.json

@@ -24,7 +24,7 @@
       "hasInstallScript": true,
       "license": "MIT",
       "name": "@portofcontext/pctx",
-      "version": "0.3.0"
+      "version": "0.4.1"
     },
     "node_modules/@isaacs/balanced-match": {
       "engines": {
@@ -897,5 +897,5 @@
     }
   },
   "requires": true,
-  "version": "0.3.0"
+  "version": "0.4.1"
 }

package/package.json

@@ -1,5 +1,5 @@
 {
-  "artifactDownloadUrl": "https://github.com/portofcontext/pctx/releases/download/v0.3.0",
+  "artifactDownloadUrl": "https://github.com/portofcontext/pctx/releases/download/v0.4.1",
   "bin": {
     "generate-cli-docs": "run-generate-cli-docs.js",
     "pctx": "run-pctx.js"
@@ -92,7 +92,7 @@
       "zipExt": ".tar.gz"
     }
   },
-  "version": "0.3.0",
+  "version": "0.4.1",
   "volta": {
     "node": "18.14.1",
     "npm": "9.5.0"