Ship faster with the CLI.
Deployment, monitoring, and management for your MCP servers directly from the terminal. Everything you love about the dashboard, now in your shell.
CLI in beta
The freemcp-cli package is available via pip. Commands below reflect the current implementation. Track progress →
Global Options
| Flag | Description |
|---|---|
| --api-url | Override the API base URL (env: FREEMCP_API_URL) |
| --json | Output raw JSON instead of formatted tables |
| -q, --quiet | Suppress non-essential output |
| -v, --verbose | Show HTTP request details |
| --no-color | Disable colored output |
| --version | Show CLI version and exit |
Command Reference
A Authentication
freemcp login [TOKEN] Shortcut: freemcp auth loginAuthenticate with your backend JWT token. Opens an interactive prompt if no token is provided.
freemcp logout Clear the saved authentication token from local config.
freemcp whoami Display the currently authenticated user (username, email, plan).
freemcp status Check API health and readiness with per-service status breakdown.
S Server Management
freemcp server deploy [OPTIONS] Deploy a new MCP server. Requires --name and --slug. Provide one of --git-url, --dockerfile, or --self-hosted.
freemcp server list List all your servers with status, endpoint, and health in a formatted table.
freemcp server get <server-id> Show detailed information for a specific server (ID, slug, or name).
freemcp server update <server-id> [OPTIONS] Update server metadata: name, description, category, tags, env vars, or endpoint URL.
freemcp server delete <server-id> Permanently delete a server and all associated resources. Confirmation required.
freemcp server logs <server-id> [OPTIONS] Stream or tail server logs. Shortcut: freemcp logs.
freemcp server builds <server-id> List build history for a server with status and timestamps.
freemcp server build <server-id> Trigger a manual rebuild of a server from its source.
freemcp server trust <server-id> Mark a server as trusted for security policy bypasses.
freemcp server deploy-template <template-id> Deploy a new instance from a public marketplace template.
E Explore Marketplace
freemcp explore search [OPTIONS] Search public MCP servers by query, category, or tags.
freemcp explore categories List all available server categories.
freemcp explore tags List all tags used across public servers.
freemcp explore featured Show featured servers curated by the freemcp team.
freemcp explore info <username/slug> Get detailed info about a public server including tools, prompts, and resources.
freemcp explore tools <username/slug> List all tools exposed by a public server.
freemcp explore prompts <username/slug> List all prompts exposed by a public server.
freemcp explore resources <username/slug> List all resources exposed by a public server.
freemcp explore related <username/slug> Find related servers based on category and tags.
B Billing & Usage
freemcp usage Show current usage statistics: request count, server count, and quota limits.
freemcp billing status Check your subscription status, plan, and next billing date.
G GitHub Integration
freemcp github connect Link your GitHub account for repository-based deploys.
freemcp github repos List your accessible GitHub repositories.
freemcp github disconnect Revoke GitHub OAuth access.
# Admin Commands (requires admin scope)
freemcp admin users list List all registered users with plan and status.
freemcp admin users ban <user-id> Ban a user account.
freemcp admin users set-plan <user-id> <plan> Change a user's subscription plan (free, pro, trial).
freemcp admin servers list List all servers across all users.
freemcp admin servers stuck Find servers stuck in building or error states.
freemcp admin system health Show detailed system health diagnostics.
freemcp admin quota overview View platform-wide quota utilization.
Common Workflows
Deploy from GitHub
Deploy from Dockerfile
Explore & Install
Ready to go headless?
Explore the full command list by running freemcp --help