ctxtual
Stores oversized tool results and lets agents search, filter, and page them.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
Python 3.11+ - System packages:
uv
install ctxtual with mcp extra via uv tool
uv tool install 'ctxtual[mcp]'
Check that it works
ctxtual --version 2>&1The output should contain “0.5.0”.
Add it to your agent
claude mcp add ctxtual -- ctxtual wrap -- python3 '<path>'JSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"ctxtual": {
"command": "ctxtual",
"args": [
"wrap",
"--",
"python3",
"<path>"
]
}
}
}Replace <path> with your own path.
What it does
These come from the README; pickfit didn’t check them one by one.
- Keep large tool results out of the agent's contextNot tested
- Wrap any MCP serverNot tested
- Search, filter and page through stored resultsNot tested
How far pickfit got
Linux x86_64
- Installs
- Connects
- A tool call works
- Works offline
Good for
- search through stored large tool results
- filter and sort large tool results
- aggregate large structured tool results
- page through stored large tool results
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Works offline
- Checked on 31 Oct 2026
- Version 0.5.0
An MCP client handshake over stdio listed 5 tools, and a call to big_tool returned a result.
Differences the test machine hit
- README: ctxtual wrap proxies any MCP server
In the test: wrap needs an upstream MCP server; probe required creating a dummy upstream and launching as ctxtual wrap -- python3 /tmp/dummy_mcp.py