MCP server

joppa mcp is an MCP (Model Context Protocol) server over stdio. Through it, a coding assistant sees your projects and their domains, starts services, reads their logs, creates databases or projects and reads the .env.

Connect an assistant

The simplest way: Settings › Command line › Connect the assistants. Or from the terminal:

joppa mcp install                           # Claude Code, Claude Desktop and Cursor, whichever are installed
joppa mcp install --client cursor --dry-run # shows what would be written
joppa mcp uninstall

Client	Where Joppa registers itself
Claude Code	claude mcp add --scope user, otherwise its config file
Claude Desktop	claude_desktop_config.json
Cursor	~/.cursor/mcp.json

Only the mcpServers.joppa entry is written; the rest of the file stays as is. Restart the assistant afterwards.

--client accepts claude-code, claude-desktop, cursor or all.

Tools

Tool	Role
get_status	Status of the proxy, CA, projects and services
list_projects	Projects, their domains and their health
list_services	Services and their status
start_service, stop_service	Starts or stops a service
service_logs	A service’s log (lines: 100 by default, 2,000 max)
list_databases	A server’s databases and their URLs
create_database	Creates a database (service, name, extensions)
get_env	A project’s .env, secrets masked unless reveal is set
start_proxy, stop_proxy	Starts or stops the proxy
set_route_enabled	Enables or disables a domain
add_project	Adds a folder, with its detected or given domains
add_service	Adds a service (engine, version, port, start)
list_templates	Project templates and their options
create_project	Creates a project from a template (dry_run to see the commands)
create_project_status	Tracks or cancels a creation in progress
open_app	Shows the Joppa window

Example requests

• “Start PostgreSQL and create a blog database with pgvector.”
• “Why is api.kinosante.test offline? Check the logs.”
• “Create an Astro project called docs in ~/Code and add it to Joppa.”