MCP.so
Sign In

Penqwin

@sarinmsari

Repository

About Penqwin

An AST-based Model Context Protocol (MCP) server that provides token-efficient codebase skeletons to LLM agents (like Cursor, Claude Desktop, and Antigravity).

#context-router#reduce-llm-token#cut-llm-cost

Basic information

Category

AI & Agents

Transports

stdio

Publisher

sarinmsari

Submitted by

Sarin M

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "penqwin": {
      "command": "npx",
      "args": [
        "-y",
        "@penqwin/mcp"
      ],
      "env": {
        "PENQWIN_API_KEY": "YOUR PENQWIN API KEY",
        "PENQWIN_ORG_ID": "YOUR PENQWIN ORG ID",
        "PENQWIN_REPO": "YOUR GITHUB REPO URL",
        "PENQWIN_API_URL": "https://app.penqwin.com"
      }
    }
  }
}

Tools

5

Returns a compact table-of-contents for the repository '{PENQWIN_REPO}'. Lists all tracked source files with their exported symbol names. ALWAYS call this FIRST before any other tool to understand the repository structure. Use the file paths returned here as input to get_folder_skeleton or get_file_skeleton. Cost: ~10-20 tokens per file — very cheap.

Returns compact AST skeletons for all source files under a given folder path prefix. Use this to understand a module or feature area without reading raw source files. Skeletons include: exports, function signatures, type definitions, and doc comments. Cost: ~50 tokens per file — much cheaper than raw source code. Tip: call get_repo_index first to discover valid folder paths.

Returns the AST skeleton for a single specific source file. The skeleton includes: all exports with signatures, imports, class members, and doc comments. Use this when you need the details of one specific file after narrowing down from get_repo_index. For multiple related files, prefer get_folder_skeleton — it is one round trip.

Searches the entire repository for files that export a specific symbol name. Use this to find where a function, class, type, or interface is defined. Returns: file path, language, kind (function/class/type/etc.), signature, and doc comment. Example: search for 'createClient' to find all files that export a function by that name.

Returns aggregate statistics for the repository '{PENQWIN_REPO}'. Includes: total file count and a breakdown by programming language. Use this to understand the tech stack and scale of the codebase at a glance.

Overview

What is Penqwin?

An AST-based Model Context Protocol (MCP) server that provides token-efficient codebase skeletons (imports, exports, signatures, JSDoc comments) to LLM agents like Cursor, Claude Desktop, and Antigravity. It reduces token context sizes by 80% to 95% during codebase exploration and navigation.

How to use Penqwin?

Install via npm install @penqwin/mcp and build with npm run build. Configure environment variables (PENQWIN_API_KEY, PENQWIN_ORG_ID, PENQWIN_REPO, PENQWIN_API_URL) and integrate with your IDE using npx or by pointing to the local build. Run node dist/index.js to start the stdio server.

Key features of Penqwin

  • Five MCP tools: get_repo_index, get_folder_skeleton, get_file_skeleton, search_symbols, get_repo_stats.
  • AST-based extraction reduces token context by 80–95%.
  • Requires Node.js v18+ and an active eng-doc backend server.
  • Configurable entirely via environment variables.
  • Integrates with Cursor, Claude Desktop, and Antigravity/Gemini Code Assistant.

Use cases of Penqwin

  • Quickly understand a repository’s structure without loading full source files.
  • Search for exported symbols (classes, functions, types) across the codebase.
  • Retrieve structural skeletons of a single file with signatures, parameters, and JSDoc.
  • Navigate codebase with a compact table of contents (~10–20 tokens per file).

FAQ from Penqwin

What does Penqwin do differently from full file loading?

It sends structural skeletons (imports, exports, signatures, JSDoc) instead of full source code, reducing token context by 80–95%.

What are the runtime requirements?

Node.js v18+ and an active eng-doc backend server with a valid API key generated from the eng-doc platform.

How do I configure Penqwin?

Set environment variables PENQWIN_API_KEY, PENQWIN_ORG_ID, PENQWIN_REPO, and PENQWIN_API_URL.

What transport does Penqwin use?

It uses stdio transport for MCP integration.

Which IDEs are supported?

Cursor, Claude Desktop, and Antigravity/Gemini Code Assistant.

Comments

More AI & Agents MCP servers

Web Agent Protocol

OTA-Tech-AI

🌐Web Agent Protocol (WAP) - Record and replay user interactions in the browser with MCP support

500

Model Context Protocol for Unreal Engine

chongdashu

Enable AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP).

2.0K

Just Prompt - A lightweight MCP server for LLM providers

disler

just-prompt is an MCP server that provides a unified interface to top LLM providers (OpenAI, Anthropic, Google Gemini, Groq, DeepSeek, and Ollama)

733

1Panel

1Panel-dev

🔥 1Panel is a modern, open-source VPS control panel — and the only one with native AI agent support. Run Ollama models, deploy OpenClaw agents, and manage your entire server stack from one clean web interface.

36.1K

Solon Ai

opensolon

Java AI application development framework (supports LLM-tool,skill; RAG; MCP; Agent-ReAct,Team-Agent). Compatible with java8 ~ java25. It can also be embedded in SpringBoot, jFinal, Vert.x, Quarkus, and other frameworks.

416