OrbitalMCP AI Token Optimizer - Documentation

Introduction

Welcome to the OrbitalMCP documentation. This guide shows you how to use the built-in AI chat interface for automatic 20-25% token savings, seamless MCP server management across all your machines, and 50+ ready-to-use automation workflows.

OrbitalMCP provides AI token optimization for multiple providers, leveraging MCP (Model Context Protocol) to deliver advanced features for AI-assisted development.

Documentation Topics

  • Context Profiles - Learn how to enhance AI interactions with project-specific context

Getting Your API Key

Your OrbitalMCP API key enables automatic token compression, cross-machine MCP sync, and access to 50+ workflow templates. To get your API key, you first need to sign up for an OrbitalMCP account (free tier available).

1. Sign Up: If you don't have an account, sign up here.

2. Navigate to API Keys: Once you are logged in, go to the dashboard and click on the "API Keys" tab.

3. Generate Key: Click the "Generate New API Key" button. Give your key a descriptive name (e.g., "My VS Code Key") and click "Generate".

4. Copy Your Key: Your new API key will be displayed. Copy it to a safe place. You will not be able to see this key again.

VS Code Extension Setup

Installation

1. Open VS Code and go to the Extensions view (Ctrl+Shift+X).

2. Search for "OrbitalMCP" and click Install.

3. Once installed, open the command palette (Ctrl+Shift+P) and run the command OrbitalMCP: Set API Key.

4. Paste your OrbitalMCP API key when prompted.

AI Chat Integration

The OrbitalMCP Connector includes a built-in AI chat interface with automatic token optimization for multiple providers.

Using the AI Chat

Once you install the OrbitalMCP Connector and set your API key:

  1. Click the OrbitalMCP icon in the VS Code sidebar
  2. Open the AI Chat panel
  3. Select your AI provider (Claude, OpenAI, Gemini, or OpenRouter)
  4. Enter your AI provider's API key when prompted
  5. Start chatting - messages are automatically compressed for 20-25% token savings

How It Works

The OrbitalMCP Connector runs a local MCP server that provides access to your configured MCP servers and tools. The built-in AI chat interface compresses every message before sending it to your chosen AI provider, delivering consistent token savings across all supported providers.

General Usage

The extension automatically configures your environment to manage MCP servers. All MCP servers you configure in your OrbitalMCP dashboard become available through the extension.

The extension adds a new view to your activity bar that shows:

  • - A list of your MCP servers
  • - The status of each server (online/offline)
  • - Access to the AI Chat interface
  • - Token savings statistics
  • - A button to quickly open your OrbitalMCP dashboard

Important: Token optimization only works through the OrbitalMCP AI Chat interface. External AI tools do not benefit from automatic token compression.

Website Dashboard

The dashboard is the central hub for managing your MCP servers.

Manual Server Setup

You can add any MCP-compliant server to your dashboard.

1. Go to the My Servers tab in the dashboard.

2. Click the Add New Server button.

3. Fill in the server details:

  • Server Name: A friendly name for your server (e.g., "Local Playwright Server").
  • Server URL: The full URL of your MCP server (e.g., "http://localhost:8080").
  • API Key: The API key for that specific server, if it requires one. This is not your OrbitalMCP API key.
  • Headers (Optional): Any custom headers required by your server, in JSON format.

4. Click Save Server. The server will now be available to any tool using your OrbitalMCP API key.