# my-cool-proxy

An MCP gateway that exposes tools progressively via a Lua runtime, preventing context bloat across multiple servers.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 15
- Author: karashiiro
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/karashiiro/my-cool-proxy
- Updated: 2026-10-05
- HTML: https://affpapa.org/en/nevibecode/mcp/my-cool-proxy

## What it does

Connecting numerous external services usually dumps every tool schema straight into the prompt. This proxy stops token waste by revealing capabilities in stages. The agent first inspects available servers, queries specific tool names, and retrieves parameter schemas only when preparing an invocation.

An embedded Lua environment handles tool composition. An agent can chain dependent API calls or iterate over items directly on the gateway through an `execute()` call. Intermediate outputs stay inside the runtime instead of round-tripping into the prompt history.

The gateway creates a blank configuration file during its initial start. Without manually adding downstream MCP server entries to that JSON file, the proxy serves nothing to the agent. Run `my-cool-proxy --config-path` to locate where those settings live.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add my-cool-proxy -- npx -y @karashiiro/my-cool-proxy
```

### Codex

**Platform CLI**
```bash
codex mcp add my-cool-proxy -- npx -y @karashiiro/my-cool-proxy
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "my-cool-proxy": {
            "command": "npx",
            "args": [
                "-y",
                "@karashiiro/my-cool-proxy"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "my-cool-proxy": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@karashiiro/my-cool-proxy"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add my-cool-proxy npx -y @karashiiro/my-cool-proxy
```

## When to use it
- reduce token consumption caused by massive tool definitions
- chain multi-step tool calls in a single Lua execution script
- unify MCP server configurations across multiple coding assistants
- restrict agent actions to safe and filtered endpoints

## Example prompts
- Check what MCP servers and tools are registered in my-cool-proxy
- Run a Lua script through my-cool-proxy to fetch and transform data from configured endpoints
- List all gateway skills available via my-cool-proxy resources

## Similar
- [tavily-key-generator-proxy](https://affpapa.org/en/nevibecode/skills/tavily-key-generator-proxy.md) — skill · 1400 installs
- [masterhttprelayvpn-proxy](https://affpapa.org/en/nevibecode/skills/masterhttprelayvpn-proxy.md) — skill · 365 installs
- [agentica-claude-proxy](https://affpapa.org/en/nevibecode/skills/agentica-claude-proxy.md) — skill · 483 installs
- [skgate](https://affpapa.org/en/nevibecode/mcp/skgate.md) — MCP server · ★ 13
- [proxy-scraper](https://affpapa.org/en/nevibecode/mcp/proxy-scraper.md) — MCP server · ★ 74
- [gcf-proxy](https://affpapa.org/en/nevibecode/mcp/gcf-proxy.md) — MCP server · ★ 11

---
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