Proxima Documentation

Proxima is a local MCP (Model Context Protocol) server that connects multiple AI providers to your coding environment. Instead of paying for API keys, use your existing AI accounts directly.

Model Context Protocol (MCP) is an open standard that connects AI assistants with external tools and data sources.

Installation

Requirements

Node.js 18+ (for MCP server and CLI)
Windows 10/11 — pre-built installer available
macOS / Linux — supported via source code

Option 1: Installer (Recommended)

Download the latest release and run the installer. This sets up everything automatically.

Download for Windows

Option 2: Run from Source

git clone https://github.com/Zen4-bit/Proxima.git cd proxima npm install npm start

Configuration

Add this to your AI coding app's MCP configuration (Cursor, VS Code, Cloud Desktop, etc.):

{ "mcpServers": { "proxima": { "command": "node", "args": ["C:/path/to/proxima/src/mcp-server-v3.js"] } } }

Tip: You can copy the exact configuration JSON from the "Settings" tab in the Proxima application.

Search Tools

Tools for retrieving information from the web.

Tool Name	Description
`deep_search`	Comprehensive web search for detailed topics.
`internet_search`	General internet search on any topic.
`github_search`	Find open-source repos, code, and solutions on GitHub.
`reddit_search`	Search Reddit discussions and threads.
`news_search`	Get the latest news articles on a topic.
`academic_search`	Find scholarly papers and research.

Code Tools

Utilities for generating, debugging, and optimizing code.

Tool Name	Description
`verify_code`	Check code against best practices and linting rules.
`explain_code`	Get detailed explanations of complex code snippets.
`generate_code`	Generate boilerplate or specific function implementations.
`convert_code`	Convert code between languages or frameworks.
`optimize_code`	Suggest performance improvements.
`review_code`	Comprehensive code review feedback.

Development Tools NEW

Advanced tools for solving problems and building projects.

Tool Name	Description
`solve`	One-shot problem solver — senior engineer level.
`fix_error`	Root cause + exact fix for any error.
`build_architecture`	Full project architecture blueprint.
`write_tests`	Auto-generate tests (jest / vitest / mocha / pytest).
`explain_error`	Error explained in plain terms, no jargon.
`conversation_export`	Export full conversation history from any provider.

Multi-AI Tools

Orchestrate multiple AI providers.

Tool Name	Description
`ask_chatgpt`	Directly query ChatGPT.
`ask_claude`	Directly query Claude.
`ask_gemini`	Directly query Gemini.
`ask_perplexity`	Directly query Perplexity (web search + citations).
`ask_all_ais`	Query all providers simultaneously.
`ask_selected`	Pick specific providers to query.
`compare_ais`	Compare responses side-by-side.
`smart_query`	Auto-picks best provider for the query.
`chain_query`	Sequential multi-AI pipeline — pass output between providers.
`debate`	Multi-provider debate with FOR / AGAINST / NEUTRAL stances.
`verify`	Cross-provider verification with confidence score.
`security_audit`	Code security scan — CRITICAL / HIGH / MEDIUM / LOW.

Analysis & Content Tools

Analyze documents, extract data, and generate content.

Tool Name	Description
`analyze_file`	Upload and analyze a local file.
`review_code_file`	Code review on a local file (bugs, performance, security).
`analyze_document`	Analyze documents from URL.
`extract_data`	Extract structured data from text or URL.
`summarize_url`	Summarize any URL.
`brainstorm`	Generate ideas on any topic.
`fact_check`	Fact verification.
`get_ui_reference`	UI/UX design consultant — colors, layouts, CSS tokens.

CLI Tool NEW in v4.1.0

The proxima CLI lets you use any AI provider from your terminal.

Install

From the app: Settings → ⚡ Install CLI to PATH
From source: npm link (Windows) or sudo npm link (macOS/Linux)

Commands

proxima ask "How does async/await work?" proxima ask claude "Review this approach" proxima search "latest Node.js release" proxima code "REST API with Express" proxima fix "SyntaxError: Unexpected token" proxima debate "tabs vs spaces" proxima compare "Bun vs Node.js"

Pipe Support

npm run build 2>&1 | proxima fix git diff | proxima code review proxima ask "What does this do?" --file src/server.js

REST API v4.1.0

OpenAI-compatible REST API at http://localhost:3210. Enable in Settings → REST API & CLI.

Endpoints

POST /v1/chat/completions — OpenAI-compatible chat GET /v1/models — List available models GET /v1/functions — API function catalog GET /v1/stats — Response time stats POST /v1/conversations/new — Reset conversations GET /docs — Interactive API docs

Example

curl http://localhost:3210/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{"model": "claude", "message": "What is AI?"}'

Use model: "all" to query all providers at once, or model: ["claude", "chatgpt"] for specific ones.

WebSocket NEW in v4.1.0

Real-time streaming AI at ws://localhost:3210/ws. Requires REST API to be enabled.

Example

const ws = new WebSocket("ws://localhost:3210/ws"); ws.send(JSON.stringify({ action: "ask", model: "claude", message: "What is a closure?", id: "req_1" })); ws.onmessage = (e) => { const msg = JSON.parse(e.data); console.log(msg.content); };

Troubleshooting

Windows Firewall Prompt

Proxima runs on localhost:19223 and localhost:3210. Click "Allow" — only accepts local connections.

Provider shows "Not logged in"

Click the provider tab and complete login. Use OTP (email code) for ChatGPT, Claude, Perplexity. Gemini uses cookie-based auth from your regular browser.

MCP Tools not appearing

Ensure Proxima is running in the background.
Verify the path in your MCP config (use Settings copy button).
Restart your coding environment.

CLI: "proxima" not found

Open a fresh terminal after install. If still not found, click 🔧 Fix in Settings → CLI.

CLI: "Cannot connect to Proxima"

Proxima must be running and REST API must be enabled. CLI connects to localhost:3210.

WebSocket won't connect

WebSocket shares the REST API server. Enable REST API in Settings first.

License

This software is for personal, non-commercial use only. Commercial and enterprise use is not permitted without a license.