Skip to main content

kongen-mcp

MCP (Model Context Protocol) server for the Kongen Labs SCI Pattern Intelligence API.

Connects Claude Code, Cursor, Windsurf, and any MCP-compatible client to Kongen's cross-domain pattern intelligence — reasoning regime detection, structural transfer scoring, and intelligent model routing.

Tools

Tool Description Cost
score_prompt Detect reasoning regime and optimal token budget for a prompt 1 KT
transfer_score Score a structural signature against 2.8M+ cross-domain patterns 50 KT
check_usage Check your token balance and usage 0 KT
route_model Recommend Haiku/Sonnet/Opus based on prompt complexity 1 KT

Installation

pip install kongen-mcp

Or install from source:

git clone https://github.com/kongenlabs/kongen-mcp.git
cd kongen-mcp
pip install .

Configuration

Get your API key at kongenlabs.life.

Claude Code

Add with the CLI:

claude mcp add kongen -- kongen-mcp

Then set your API key when prompted, or add it manually to .claude/mcp.json:

{
  "mcpServers": {
    "kongen": {
      "command": "kongen-mcp",
      "env": {
        "KONGEN_API_KEY": "kl_live_..."
      }
    }
  }
}

Cursor

  1. Open Settings > MCP > Add Server
  2. Name: kongen
  3. Command: kongen-mcp
  4. Environment variables:
    • KONGEN_API_KEY: your API key

Windsurf

Add to your MCP configuration:

{
  "mcpServers": {
    "kongen": {
      "command": "kongen-mcp",
      "env": {
        "KONGEN_API_KEY": "kl_live_..."
      }
    }
  }
}

Custom base URL

To point at staging or a local instance, set KONGEN_API_BASE_URL:

{
  "mcpServers": {
    "kongen": {
      "command": "kongen-mcp",
      "env": {
        "KONGEN_API_KEY": "kl_test_...",
        "KONGEN_API_BASE_URL": "https://staging-api.kongenlabs.life"
      }
    }
  }
}

Usage examples

Once configured, the tools are available to your AI assistant. Examples of what you can ask:

Prompt scoring:

"Score this prompt for complexity: Prove that the square root of 2 is irrational using proof by contradiction."

Model routing:

"Which Claude model should I use for this task: Summarize this 3-line email."

Transfer scoring:

"Score this structural signature: activator 0.7, inhibitor 0.3, boundary 0.8, scale_coherence 0.6, field_magnitude 1.5, a_i_ratio 2.33, gradient 0.5"

Usage check:

"How many Kongen tokens do I have left?"

Environment variables

Variable Required Default Description
KONGEN_API_KEY Yes — Your Kongen API key (kl_live_... or kl_test_...)
KONGEN_API_BASE_URL No https://api.kongenlabs.life API base URL override

License

MIT

Metadata

Release files for kongen-mcp 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for kongen-mcp 1.0.1
File Size Uploaded Provenance
kongen_mcp-1.0.1.tar.gz 6.6 MB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for kongen-mcp 1.0.1
File Interpreter ABI Platform
kongen_mcp-1.0.1-py3-none-any.whl Python 3 none any Details

Total release size: 6.6 MB

Release files / kongen_mcp-1.0.1.tar.gz

Download URL kongen_mcp-1.0.1.tar.gz
Size 6.6 MB
Tags Source
SHA-256 checksum
How to use checksums
52e468e4ca1a1f4f428364e8ba51d878b02d3efce8576170b38f93ee943e8d0e
BLAKE2b-256 checksum
How to use checksums
4e8796544bcf487c62f40e59b6f10564b1485beef868a1f501197f880c0bcdb8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Release files / kongen_mcp-1.0.1-py3-none-any.whl

Download URL kongen_mcp-1.0.1-py3-none-any.whl
Size 7.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
56eddd49a3b1c30669896077602c8fa4bbda069a8a4b5e3024c12deccd0fa538
BLAKE2b-256 checksum
How to use checksums
f7729c60dd75bf75ee4f26ec2bdd0b34cc1df8c870c92ebd2f28468d77eebd3e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Security for kongen-mcp 1.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page