ControlAPI-MCP

MCP server that exposes any OpenAPI/REST API as MCP tools with dynamic server switching and variable substitution.

🚀 One-Click Install

Click to install directly in your editor - no configuration needed!

📥 Install in VS Code

📥 Install in VS Code Insiders

💡 After Installation: The AI assistant will guide you to connect to an API server. Simply provide the OpenAPI URL when asked, or use the set_server_config tool to connect to your API.

Quick Start (Auto-Download)

Zero installation - automatically downloads and runs the latest release:

1. Download the auto-run script:

2. Use it in your MCP config:

Note: You can optionally set OPENAPI_URL, BASE_URL, and SERVER_NICKNAME in env vars, or configure dynamically using the set_server_config tool.

Download from releases or build:

Setup (Development)

Building Binary

Creates a standalone executable at dist/controlapi-mcp (16MB)

MCP Configuration

Using Binary

Using Python (Development)

Optional: OPENAPI_URL, BASE_URL, SERVER_NICKNAME

💡 No Configuration Needed: You can start with no environment variables and configure the server dynamically using the set_server_config tool. The AI assistant will guide you through the setup.

Features

Dynamic Server Switching

• Connect to any OpenAPI server at runtime

• Switch between multiple APIs (dev, staging, production)

• Server context tracking with history

• Automatic schema reloading

Available Tools

• set_server_config - Connect to an OpenAPI server (use this first if not configured)

• get_server_info - Check current server and connection status

• get_server_history - View recent server switches

• health_check - Test server connectivity

• list_endpoints - List all API endpoints

• search_schema - Search endpoints by keyword

• execute_request - Make HTTP requests with variable substitution

• set_variable - Store variable (e.g., auth token)

• get_variables - View all stored variables

• reload_schema - Reload current server's schema

Variable Substitution

Use {{variable_name}} in headers, body, or path:

Example Workflow

1. First time: set_server_config with openapi_url

2. execute_request to /auth/login → get token

3. set_variable key="token" value="Bearer xyz..."

4. execute_request with Authorization: {{token}}

5. Switch servers: set_server_config to test on different environment