Skip to main content
Glama

ContextBridge

npm version MCP Registry

ContextBridge is a context portability tool for AI conversations. This package publishes the MCP server surface: it compresses an in-progress conversation into a structured context block that preserves the user's goal, confirmed decisions, current state, open threads, artifacts, constraints, recent pivots, and suggested next step, then formats that handoff so another AI can continue without forcing the user to restate everything.

The published npm artifact is the stdio MCP server for Claude Desktop, agent runtimes, and other MCP-compatible hosts. The browser extension runtime is developed in the same repository, but it is not part of this MCP Registry publishing flow.

Related MCP server: context-diamond

Install In Claude Desktop

Add this to your Claude Desktop MCP config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "contextbridge": {
      "command": "npx",
      "args": ["-y", "@contextbridge_ai/mcp"],
      "env": {
        "GROQ_API_KEY": "your_groq_api_key_here"
      }
    }
  }
}

Or with OpenAI:

{
  "mcpServers": {
    "contextbridge": {
      "command": "npx",
      "args": ["-y", "@contextbridge_ai/mcp"],
      "env": {
        "OPENAI_API_KEY": "your_openai_api_key_here",
        "OPENAI_MODEL": "gpt-4.1-mini"
      }
    }
  }
}

For a hosted no-key lane instead of BYOK:

{
  "mcpServers": {
    "contextbridge": {
      "command": "npx",
      "args": ["-y", "@contextbridge_ai/mcp"],
      "env": {
        "CONTEXTBRIDGE_HOSTED_URL": "https://your-hosted-endpoint.example/v1",
        "CONTEXTBRIDGE_HOSTED_MODEL": "mistralai/Mistral-7B-Instruct-v0.2"
      }
    }
  }
}

Available MCP Tools

compress_context

Compresses a raw transcript into a structured context block.

Parameters:

  • transcript (string, required): the raw conversation transcript to compress.

  • provider ("openai" | "openai-chat" | "google" | "groq" | "custom" | "hosted", optional): provider override.

  • model (string, optional): model override for the selected lane.

  • apiKey (string, optional): BYOK API key override.

  • baseUrl (string, optional): API base URL override.

  • hostedApiKey (string, optional): optional auth key for the hosted lane.

format_for_target

Formats a compressed context block for a destination platform.

Parameters:

  • context_block (object, required): a validated ContextBridge compressed context block.

  • target ("claude" | "chatgpt" | "gemini", required): destination AI platform.

resume_context

Builds a destination-ready landing package from a compressed context block.

Parameters:

  • context_block (object, required): a validated ContextBridge compressed context block.

  • target ("claude" | "chatgpt" | "gemini", required): destination AI platform.

BYOK Setup

ContextBridge auto-selects the OpenAI Responses lane when a BYOK key is present.

Environment variables:

OPENAI_API_KEY=your_openai_api_key_here
OPENAI_MODEL=gpt-4.1-mini
OPENAI_BASE_URL=https://api.openai.com/v1

Additional supported provider overrides:

GOOGLE_API_KEY=your_google_api_key_here
GOOGLE_MODEL=gemini-2.5-pro
GOOGLE_BASE_URL=https://generativelanguage.googleapis.com/v1beta/openai

GROQ_API_KEY=your_groq_api_key_here
GROQ_MODEL=llama-3.3-70b-versatile
GROQ_BASE_URL=https://api.groq.com/openai/v1

CONTEXTBRIDGE_API_KEY=your_custom_api_key_here
CONTEXTBRIDGE_MODEL=your_custom_model_here
CONTEXTBRIDGE_BASE_URL=https://your-endpoint.example/v1
CONTEXTBRIDGE_PROVIDER=custom

Hosted Lane Setup

The hosted lane is the no-key path for end users who do not bring their own provider credentials.

Environment variables:

CONTEXTBRIDGE_HOSTED_URL=https://your-hosted-endpoint.example/v1
CONTEXTBRIDGE_HOSTED_MODEL=mistralai/Mistral-7B-Instruct-v0.2
CONTEXTBRIDGE_HOSTED_API_KEY=

Selection priority:

  1. Explicit apiKey option passed into compression uses the OpenAI Responses BYOK lane.

  2. OPENAI_API_KEY uses the OpenAI Responses BYOK lane.

  3. CONTEXTBRIDGE_HOSTED_URL uses the hosted lane.

Contributing

Contributions are welcome. The highest-leverage areas are extraction quality evaluation, browser collector resilience, destination formatting quality, hosted-lane infrastructure, and real-world handoff testing across platforms.

License

MIT. See LICENSE.

Available Tools

4 tools
compress_contextCompress ContextA
Read-onlyIdempotent

Compresses a raw conversation transcript into a structured ContextBridge handoff block.

Inputs: transcript (required), provider. Returns: goal, version, open_threads, recent_pivot, +8 more

format_for_targetFormat For TargetA
Read-onlyIdempotent

Formats a compressed ContextBridge handoff block into a paste-ready opening prompt for a destination AI platform.

Inputs: target (required), context_block (required). Returns: target, api_split, format_version, formatted_prompt, +2 more

resume_contextResume ContextA
Read-onlyIdempotent

Packages a stored ContextBridge handoff block into a destination-ready landing bundle for resuming the conversation on another AI platform.

Inputs: target (required), context_block (required). Returns: target, handoff_kind, resume_ready, format_version, +6 more

say_helloSay HelloA

Dummy tool used to confirm the ContextBridge MCP server is connected and working.

Inputs: name (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: health check, compression, formatting, and resume packaging. No overlap or ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case, making them predictable and easy to understand.

    Tool Count5/5

    With 4 tools, the server is appropriately scoped for its purpose of context handoff, each tool is necessary and none are superfluous.

    Completeness4/5

    The core workflow of compressing, formatting, and resuming context is covered. A minor gap is the lack of a decompress tool for reading the stored context, but it's not essential for the stated purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers