# contextweaver

contextweaver snapshots the tools available to an agent and shows what changed between API versions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9 repo stars
- Author: dgenio
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dgenio/contextweaver
- Updated: 2026-10-19
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/contextweaver

## What it does

Reads an OpenAPI document, an MCP server's `tools/list` response, or a native catalog, normalizes the capability list, and produces a deterministic snapshot. The `diff` command compares two snapshots and separates tool additions and removals from edits to existing ones — a required-parameter change is flagged separately from a description update.

Runs locally via `uvx`, needs no API keys, and does not invoke the tools themselves. The `verify` command checks snapshot structure, identifier uniqueness, and canonical digests. A potential breaking-change flag appears when `required`, `type`, or `enum` fields shift, but the server does not perform full JSON Schema compatibility analysis.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add contextweaver -- uvx contextweaver
```
uvx runs the command named after the package; if the README names another one, use uvx --from contextweaver <command>

### Codex

**Platform CLI**
```bash
codex mcp add contextweaver -- uvx contextweaver
```
uvx runs the command named after the package; if the README names another one, use uvx --from contextweaver <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "contextweaver": {
            "command": "uvx",
            "args": [
                "contextweaver"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from contextweaver <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "contextweaver": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "contextweaver"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from contextweaver <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add contextweaver uvx contextweaver
```
uvx runs the command named after the package; if the README names another one, use uvx --from contextweaver <command>

## When to use it
- compare API versions and see which tools were added or removed
- check whether required parameters of an existing tool have changed
- snapshot an agent's capability surface before deployment
- produce a deterministic snapshot from an OpenAPI file without calling a model

## Example prompts
- Save a snapshot from `openapi.yaml` to `capabilities.json`
- Compare `capabilities.json` and `capabilities-candidate.json`
- Verify the structure of `capabilities.json`

## Similar
- [source-command-ccguide-diff-docs](https://affpapa.org/en/nevibecode/skills/source-command-ccguide-diff-docs.md) — skill · ★ 6529 repo stars
- [publish-artifact-to-sites](https://affpapa.org/en/nevibecode/skills/publish-artifact-to-sites.md) — skill · ★ 8052 repo stars
- [repopilot](https://affpapa.org/en/nevibecode/hooks/repopilot.md) — hook · ★ 1596 repo stars
- [Prefire](https://affpapa.org/en/nevibecode/mcp/prefire.md) — MCP server · ★ 535 repo stars
- [init-docs](https://affpapa.org/en/nevibecode/commands/init-docs.md) — command · ★ 6529 repo stars
- [confdiff-mcp](https://affpapa.org/en/nevibecode/mcp/confdiff-mcp.md) — MCP server · ★ 41 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
