Deploy

nometria/claude-code-plugin

Connects Claude to Nometria's deployment platform with 7 MCP tools for shipping to AWS, Google Cloud, Azure, DigitalOcean, Hetzner, and Vercel. Exposes operations for authentication, config initialization, production deploys, staging previews with 2-hour free hosting, status checks, log streaming, and app listing. Available as a Claude Code plugin, standalone MCP server via npx, or slash commands generated into your project. Handles auth through API keys from nometria.com either as environment variables or via the login tool. Useful when you want Claude to deploy directly without leaving the conversation or switching to a terminal.

tools: 11
auth: Secret needed
transport: STDIO
env var: 1
last updated: Apr 4, 2026

View on GitHub

Tools

11 tools

Public tool metadata for what this MCP can expose to an agent.

get_deploy_instructionsUse this when you are about to call deploy_app in order to get the deployment constraints and hard rules. You must call this tool before starting to generate any code. This tool returns instructions only and does not deploy anything.

Use this when you are about to call deploy_app in order to get the deployment constraints and hard rules. You must call this tool before starting to generate any code. This tool returns instructions only and does not deploy anything.

No parameter schema in public metadata yet.

deploy_appUse this when the user asks to deploy or publish a website or web app and wants a public URL. Before generating files or calling this tool, you must call get_deploy_instructions and follow its constraints.9 params

Use this when the user asks to deploy or publish a website or web app and wants a public URL. Before generating files or calling this tool, you must call get_deploy_instructions and follow its constraints.

Parameters* required

app_idvalue

existing app id to update, or null for new app

app_namestring

short display name

app_typestring

app architecture: frontend-only or frontend+backendone of frontend-only · frontend+backend

deletePathsarray

Paths to delete. ONLY for updates (app_id required). Cannot delete package.json or framework entry points.

descriptionstring

short description of what the app does

filesarray

Files to write. NEW APPS: only custom files + diffs to template files. UPDATES: only changed files using diffs[]. At least one of files[] or deletePaths[] required.

frontend_templatevalue

REQUIRED when app_id is null. One of: 'html-static' (simple sites), 'react-vite' (SPAs, games), 'nextjs-static' (multi-page). Template files auto-included.

intentstring

The intent of this deployment. User-initiated examples: 'initial app deploy', 'bugfix - ui is too noisy'. Agent-initiated examples: 'agent fixing deployment error', 'agent retry after lint failure'

modelstring

The coding agent model used for this deployment, to the best of your knowledge. Examples: 'codex-5.3', 'chatgpt', 'opus 4.6', 'claude-sonnet-4-5', 'gemini-2.5-pro'

get_app_templateCall get_deploy_instructions first. Then call this once you've decided app_type and frontend_template. Returns base app template and SDK types. Template files auto-included in deploy_app.2 params

Call get_deploy_instructions first. Then call this once you've decided app_type and frontend_template. Returns base app template and SDK types. Template files auto-included in deploy_app.

Parameters* required

app_typestring

one of frontend-only · frontend+backend

frontend_templatestring

Frontend framework: 'html-static' - Simple sites, minimal framework; 'react-vite' - React SPAs, dashboards, games; 'nextjs-static' - Multi-page apps, SSGone of html-static · react-vite · nextjs-static

get_app_statusUse this when deploy_app tool call returns or when the user asks to check the deployment status of an app, or reports that the app has errors or is not working as expected. Returns deployment status (in-progress: 'deploying'/'deleting', terminal: 'ready'/'failed'/'deleted'), Q...2 params

Use this when deploy_app tool call returns or when the user asks to check the deployment status of an app, or reports that the app has errors or is not working as expected. Returns deployment status (in-progress: 'deploying'/'deleting', terminal: 'ready'/'failed'/'deleted'), Q...

Parameters* required

app_idstring

Target app id

sinceinteger

Optional timestamp in epoch milliseconds to filter errors. When provided, returns only errors since that timestamp.

delete_appUse this when you want to permanently delete an app. Use only on explicit user request. This is irreversible; after deletion, status checks will return not found.1 params

Use this when you want to permanently delete an app. Use only on explicit user request. This is irreversible; after deletion, status checks will return not found.

Parameters* required

app_idstring

Target app id

get_app_versionsList deployable versions for an existing app. Requires app_id. Returns newest-first {name, version, timestamp} items. Display 'name' to users. DO NOT display the 'version' value to users. Timestamp values MUST be converted to user's local time1 params

List deployable versions for an existing app. Requires app_id. Returns newest-first {name, version, timestamp} items. Display 'name' to users. DO NOT display the 'version' value to users. Timestamp values MUST be converted to user's local time

Parameters* required

app_idstring

Target app id

apply_app_versionStart deploying an existing app at a specific version. Use the 'version' value (not 'name') from get_app_versions. Returns true if accepted and deployment started; use get_app_status to observe completion.2 params

Start deploying an existing app at a specific version. Use the 'version' value (not 'name') from get_app_versions. Returns true if accepted and deployment started; use get_app_status to observe completion.

Parameters* required

app_idstring

Target app id

versionstring

Version id to apply

src_globUse this when you need to discover files in an app's source snapshot. Returns file paths matching a glob pattern (no content). Useful for exploring project structure before reading or searching files.6 params

Use this when you need to discover files in an app's source snapshot. Returns file paths matching a glob pattern (no content). Useful for exploring project structure before reading or searching files.

Parameters* required

app_idstring

Target app id

continuation_tokenstring

Token from previous response for pagination

globstring

Glob pattern to match files (default: **/*)default: **/*

include_dirsboolean

Include directory paths in resultsdefault: false

pathstring

Directory path to search within

versionstring

Version to inspect (defaults to applied version)

src_grepUse this when you need to search for patterns in an app's source code. Returns matching lines with optional context. Supports regex patterns, glob filters, and multiple output modes.13 params

Use this when you need to search for patterns in an app's source code. Returns matching lines with optional context. Supports regex patterns, glob filters, and multiple output modes.

Parameters* required

after_contextinteger

Lines to show after each match (0-20)default: 0

app_idstring

Target app id

before_contextinteger

Lines to show before each match (0-20)default: 0

case_insensitiveboolean

Enable case-insensitive matchingdefault: false

contextinteger

Lines before and after (overrides before/after_context)

continuation_tokenstring

Token from previous response for pagination

globstring

Glob pattern to filter files (e.g., '*.ts')

line_numbersboolean

Include line numbers in outputdefault: true

max_file_sizeinteger

Max file size to scan in bytes (default 10MB)

output_modestring

content=matching lines, files_with_matches=file paths only, count=match count per fileone of content · files_with_matches · countdefault: content

pathstring

Directory path to search within

patternstring

Regex pattern to search for (max 500 chars)

versionstring

Version to search (defaults to applied version)

src_readUse this when you need to read a specific file from an app's source snapshot. Returns file content with line-based pagination (offset/limit). Handles both text and binary files.5 params

Use this when you need to read a specific file from an app's source snapshot. Returns file content with line-based pagination (offset/limit). Handles both text and binary files.

Parameters* required

app_idstring

Target app id

file_pathstring

Path to the file to read

limitinteger

Number of lines to return (max 2000)default: 200

offsetinteger

Line offset to start reading from (0-indexed)default: 0

versionstring

Version to read from (defaults to applied version)

get_appsUse this when you need to list apps owned by the current user. Returns app details with display fields for user presentation and data fields for tool chaining.1 params

Use this when you need to list apps owned by the current user. Returns app details with display fields for user presentation and data fields for tool chaining.

Parameters* required

continuation_tokenstring

Token for pagination

Configuration

NOMETRIA_API_KEYsecret

Your Nometria API key (get one at https://ownmy.app/settings/api-keys)

Readme

@nometria-ai/claude-code

Deploy any project to any cloud directly from Claude Code.

Install

Option 1: Plugin (recommended)

# Install as a Claude Code plugin (includes MCP server + skills)
/plugin marketplace add nometria/claude-code-plugin
/plugin install nometria

Option 2: MCP server

# Add MCP server to Claude Code
claude mcp add nometria -- npx -y @nometria-ai/claude-code

# If you use nvm/fnm/volta and the above fails, use:
claude mcp add nometria -- /bin/sh -c '. "${NVM_DIR:-$HOME/.nvm}/nvm.sh" 2>/dev/null; exec npx -y @nometria-ai/claude-code'

Option 3: Slash commands only

# Generate slash commands + AI tool configs in your project
npx @nometria-ai/nom setup

MCP Tools

The MCP server exposes 34 tools, grouped by area:

Auth & config: nometria_login, nometria_init, nometria_setup, nometria_info

Deploy: nometria_deploy, nometria_preview, nometria_rollback

Monitoring: nometria_status, nometria_logs, nometria_list_apps, nometria_scan

Instance lifecycle: nometria_start, nometria_stop, nometria_terminate, nometria_upgrade

View the full README on GitHub

Details

Repository: github.com/nometria/claude-code-plugin
Package: @nometria-ai/claude-code
Transport: STDIO
Auth: Required
Registry: MCP registry, active