@portofcontext/pctx 0.1.4 → 0.2.1

package/CHANGELOG.md

@@ -13,16 +13,45 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Fixed
 
 
+## [v0.2.1] - 2025-11-25
+
+### Added
+
+- All tools return define `outputSchema` and return `structuredOutput` alongside the text content.
+
+### Fixed
+
+- `pctx add`
+  - Prefer env var over keychain auth in interactive upstream mcp adding
+- `pctx dev`
+  - Better error state reporting (e.g. invalid config, port already in use)
+  - Scroll out of bounds for tool details panel
+
+
+### Changed
+
+- Auth type `custom`, changed to `headers` to be more descriptive. `custom` retained as an alias for backwards compatibility
+
+## [v0.2.0] - 2025-11-19
+
+### Added
+
+- `pctx dev` command with Terminal UI to explore CodeMode interface and track requests when running PCTX locally
+- `logger` configuration in `pctx.json` (`pctx_config::logger::LoggerConfig`) that supports configuring stdout logging level, format, and colorization
+- `telemetry` configuration in `pctx.json` (`pctx_config::telemetry::TelemetryConfig`) that supports enabling exporters for traces and metrics
+  - `examples/telemetry` example docker compose setup for Tempo/Prometheus/Grafana to try out these new configs
+
 ## [v0.1.4] - 2025-11-14
 
 ### Added
+
 - nasa mcp server example with scripts for running/deploying pctx
 
 ### Fixed
+
 - ts code ignore syncing
 - remove slow intel mac runner
 
-
 ## [v0.1.3] - 2025-11-13
 
 ### Added
@@ -66,7 +95,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Initial public release
 
-[Unreleased]: https://github.com/portofcontext/pctx/compare/v0.1.4...HEAD
+[Unreleased]: https://github.com/portofcontext/pctx/compare/v0.2.0...HEAD
+[v0.2.0]: https://github.com/portofcontext/pctx/compare/v0.2.0
 [v0.1.4]: https://github.com/portofcontext/pctx/compare/v0.1.4
 [v0.1.3]: https://github.com/portofcontext/pctx/compare/v0.1.3
 [v0.1.2]: https://github.com/portofcontext/pctx/compare/v0.1.2

package/README.md

@@ -6,7 +6,6 @@
 
 [![NPM Version](https://img.shields.io/npm/v/%40portofcontext%2Fpctx)](https://www.npmjs.com/package/@portofcontext/pctx)
 [![Rust](https://img.shields.io/badge/rust-1.89%2B-blue.svg)](https://www.rust-lang.org)
-[![CI](https://github.com/portofcontext/pctx/workflows/CI/badge.svg)](https://github.com/portofcontext/pctx/actions)
 
 </div>
 
@@ -22,10 +21,10 @@ The open source framework to connect AI agents to tools and services with [code
 # Homebrew
 brew install portofcontext/tap/pctx
 
-# Curl
+# cURL
 curl --proto '=https' --tlsv1.2 -LsSf https://raw.githubusercontent.com/portofcontext/pctx/main/install.sh | sh
 
-# NPM
+# npm
 npm i -g @portofcontext/pctx
 ```
 
@@ -39,13 +38,18 @@ pctx init
 pctx add my-local-server http://localhost:3000/mcp
 pctx add stripe https://mcp.stripe.com
 
-# Start the unified MCP server
-pctx start
+# Start the unified MCP server in dev mode
+pctx dev
+
+# copy the pctx url and connect to agents with --transport http
 ```
 
 For complete CLI documentation, see [CLI.md](docs/CLI.md).
 For configuration options, see [Configuration Guide](docs/config.md).
 
+<img width="1020" height="757" alt="Screenshot 2025-11-21 at 11 03 20 AM" src="https://github.com/user-attachments/assets/d61be46d-5a4b-40fd-953a-7dc725266e63" />
+
+
 ## What is pctx?
 
 `pctx` sits between AI agents and MCP servers. It aggregates multiple upstream MCP servers, handles authentication, and exposes tools through a unified [Code Mode](#what-is-code-mode) interface. Instead of agents managing connections to individual MCP servers, they connect once to pctx.
@@ -75,7 +79,8 @@ console.log(`Found ${orders.length} orders`);
 
 - **Code Mode interface**: Tools exposed as TypeScript functions for efficient agent interaction. See [Code Mode Guide](docs/code-mode.md).
 - **Upstream MCP server aggregation**: Connect to multiple MCP servers through a single interface. See [Upstream MCP Servers Guide](docs/upstream-mcp-servers.md).
-- **Secure authentication**: OAuth, environment variables, system keychain, and external commands. See [Authentication Guide](docs/mcp-auth.md).
+- **Simple config with CLI**: Create the pctx.json config with a simple CLI. pctx.json manages auth, upstream MCPs, logging, and more. See [Config Guide](docs/config.md).
+- **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
 
@@ -124,6 +129,22 @@ console.log(`Found ${orders.length} orders`);
 - No filesystem, environment, network (beyond allowed hosts), or system access.
 - MCP clients are authenticated in pctx. LLMs can never see your auth.
 
+## Update
+
+Depending on the installation method (Homebrew/npm/cURL) the update method is different. Run `which pctx` if you are unsure what you used to install it.
+
+```bash
+# Homebrew update
+brew upgrade pctx
+
+# cURL update
+pctx-update
+
+# npm update
+npm upgrade -g @portofcontext/pctx
+
+```
+
 ## 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.1.4"
+      "version": "0.2.1"
     },
     "node_modules/@isaacs/balanced-match": {
       "engines": {
@@ -897,5 +897,5 @@
     }
   },
   "requires": true,
-  "version": "0.1.4"
+  "version": "0.2.1"
 }

package/package.json

@@ -1,5 +1,5 @@
 {
-  "artifactDownloadUrl": "https://github.com/portofcontext/pctx/releases/download/v0.1.4",
+  "artifactDownloadUrl": "https://github.com/portofcontext/pctx/releases/download/v0.2.1",
   "bin": {
     "generate-cli-docs": "run-generate-cli-docs.js",
     "pctx": "run-pctx.js"
@@ -68,7 +68,7 @@
       "zipExt": ".tar.gz"
     }
   },
-  "version": "0.1.4",
+  "version": "0.2.1",
   "volta": {
     "node": "18.14.1",
     "npm": "9.5.0"