pctx
pctx is the execution layer for agentic tool calls. It auto-converts agent tools and MCP servers into code that runs in secure sandboxes for token-efficient workflows.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/portofcontext/pctx with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/portofcontext/pctx'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/portofcontext--pctx)HTML
<a href="/listings/portofcontext--pctx"><img src="/api/listings/portofcontext--pctx/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
# Homebrew brew install portofcontext/tap/pctx # cURL curl --proto '=https' --tlsv1.2 -LsSf https://raw.githubusercontent.com/portofcontext/pctx/main/install.sh | sh # npm npm i -g @portofcontext/pctx
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 177 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <div align="center">
- <img src=".github/assets/logo.png" alt="PCTX Logo" style="height: 128px">
- <h1>pctx</h1>
- [](https://portofcontext.com)
- [](https://www.npmjs.com/package/@portofcontext/pctx)
- [](https://www.rust-lang.org)
- [](https://pctx.readthedocs.io/en/latest/)
- </div>
- <div align="center">
- The open source framework to connect AI agents to tools and mcp with [Code Mode](#what-is-code-mode)
- </div>
- <div align="center">
- <br>
- <sub>— T R U S T E D B Y —</sub>
- <br><br>
- <a href="https://goose-docs.ai/docs/guides/managing-tools/code-mode/"><picture><source media="(prefers-color-scheme: dark)" srcset=".github/assets/block-logo-white.png"><img src=".github/assets/block-logo.png" alt="Block" height="22"></picture></a> <a href="https://www.sentient.xyz"><picture><source media="(prefers-color-scheme: dark)" srcset=".github/assets/sentient-logo-white.svg"><img src=".github/assets/sentient-logo.svg" alt="Sentient" height="22"></picture></a>
- </div>
- ## Install
- ```bash
- # Homebrew
- brew install portofcontext/tap/pctx
- # cURL
- curl --proto '=https' --tlsv1.2 -LsSf https://raw.githubusercontent.com/portofcontext/pctx/main/install.sh | sh
- # npm
- npm i -g @portofcontext/pctx
- ```
- ## Core Functionality
- pctx can be run as a scalable session server for Code Mode or as a lightweight unified MCP server that exposes Code Mode functionality for registered upstream MCP servers.
- ```bash
- # Start the Code Mode session server for the Python SDK
- pctx code-mode serve
- # Start Code Mode as a unified MCP server
- pctx code-mode init
- pctx code-mode 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
- pip install pctx-client
- ```
- ```python
- from pctx_client import Pctx, tool
- from agents import Agent # Use any Agent SDK
- from agents.run import Runner # This example is OpenAI Agents SDK
- @tool
- def get_weather(city: str) -> str:
- """Get weather information for a given city."""
- return f"It's always sunny in {city}!"
- pctx = Pctx(tools=[get_weather]) # or with mcp: servers=[your_mcp]
- tools = pctx.openai_agents_tools() # Run Code Mode with any Agent SDK
- agent = Agent(
- name="GreatCoder",
- model="litellm/openrouter/openai/gpt-oss-120b",
- instructions="You run code to complete complex tasks.",
- tools=tools,
- )
- ```
- ### 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 use agent tools (non-mcp tools).
- ```bash
- # Initialize config for upstream mcp connections
- pctx code-mode init
- # Add HTTP or stdio MCP servers
- pctx code-mode add stripe https://mcp.stripe.com
- pctx code-mode add memory --command "npx -y @modelcontextprotocol/server-memory"
- # Start as HTTP server (dev mode with UI)
- pctx code-mode dev
- # Or start as stdio MCP server
- pctx code-mode start --stdio
- ```
- 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.
- ## What is Code Mode?
- Code mode replaces sequential tool calling with code execution. Rather than an agent calling tools one at a time and passing results through its context window, it writes code that executes in a sandbox. Read Anthropic's overview [here](https://www.anthropic.com/engineering/code-execution-with-mcp).
- **Traditional MCP flow**:
- 1. Agent calls `getSheet(id)`
- 2. Server returns 1000 rows → agent's context
- 3. Agent calls `filterRows(criteria)`
- 4. Server returns 50 rows → agent's context
- **With Code Mode**:
- ```typescript
- const sheet = await gdrive.getSheet({ sheetId: "abc" });
- const orders = sheet.filter((row) => row.status === "pending");
- console.log(`Found ${orders.length} orders`);
- ```
- **Result:** 98.7% reduction in tokens (150k → 2k) for this multi-step operation.
- ## Features
- - **Code Mode interface**: Tools exposed as code 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, with persistent upstream sessions across `execute_typescript` calls. See [Upstream MCP Servers Guide](docs/upstream-mcp-servers.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.
- ## Security
- - LLM generated code runs in an isolated [Deno](https://deno.com) sandbox that can only access the network hosts specified in the configuration file.
- - 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
- ```
- ## 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/)
- - [Code execution with MCP by Anthropic](https://www.anthropic.com/engineering/code-execution-with-mcp)
- - [Code Mode explanation by Cloudflare](https://blog.cloudflare.com/code-mode/)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.