Command reference

Every example on this page is real output captured from mcp running against a live workspace. Identifiers and key previews are masked (xxxx), but the shape, columns, and values are exactly what the CLI prints.

Global flags work on every command: --json (raw JSON), --format <table|tsv|jsonl|json>, --field <names>, --filter <key=substring>, --profile <name>, and --base-url <url>. Run mcp --help for the full list.

Auth and identity

mcp login            # browser flow (default)
mcp login --paste    # SSH/headless: paste an API key
mcp whoami           # who am I, which key, which orgs
mcp logout

mcp whoami resolves your identity, the active API key, the base URL, and every organization you can act on:

user         [email protected]
auth method  apiKey
api key      mcf_xxxxxxxxxxxxxxxxxxx (your-machine.local)
base url     https://api.mcpcloud.sh
default org  kn7cxxxxxxxxxxxxxxxxxxxxxxxx5baj
org count    3

ID                                Name               Slug                Role    Plan        Default
────────────────────────────────  ─────────────────  ──────────────────  ──────  ──────────  ───────
kn7cxxxxxxxxxxxxxxxxxxxxxxxx5baj  MCPCloud           mcpcloud            owner   enterprise  ✓
kn7cxxxxxxxxxxxxxxxxxxxxxxxxtkdt  Abyssinian Studio  abyssinian-studio   owner   starter
kn7bxxxxxxxxxxxxxxxxxxxxxxxx2na5  test-org-2         test-org-2          owner   free

Projects

mcp projects list
mcp projects get <projectId>
mcp projects create --name <name>
mcp projects update <projectId>
mcp projects api-sources <projectId>   # imported specs / source material
mcp projects api-source <apiSourceId>

ID                                Name             Slug   Servers   Created
────────────────────────────────  ───────────────  ─────  ────────  ─────────────────────
js74xxxxxxxxxxxxxxxxxxxxxxxx8w0d  GitHub Showcase                    5/23/2026, 3:44:48 PM
js75xxxxxxxxxxxxxxxxxxxxxxxx99bg  Stripe Showcase                    5/23/2026, 12:55:06 PM
js7axxxxxxxxxxxxxxxxxxxxxxxx80xg  Slate Showcase                     5/22/2026, 10:27:06 PM
js74xxxxxxxxxxxxxxxxxxxxxxxx80sg  Forge Showcase                     5/22/2026, 10:26:51 PM
js7bxxxxxxxxxxxxxxxxxxxxxxxx5ff8  Tally Showcase                     5/21/2026, 7:46:23 PM

Servers

mcp servers list
mcp servers get <serverId>
mcp servers create --project <projectId> --name <name>
mcp servers deploy <serverId> [--wait]
mcp servers push-spec <serverId> --spec ./openapi.yaml
mcp servers pause <serverId>
mcp servers resume <serverId>
mcp servers logs <serverId> [--follow]
mcp servers versions <serverId>
mcp servers deployments <serverId>
mcp servers oauth-connections <serverId>

mcp servers list — one row per server with its project, status, and live version:

ID                                Name                            Project          Status   Version   Last Deployed
────────────────────────────────  ──────────────────────────────  ───────────────  ───────  ────────  ─────────────────────
md77xxxxxxxxxxxxxxxxxxxxxxxxanfs  GitHub MCP (demo org)           GitHub Showcase  active   1.0.0     5/24/2026, 3:31:36 PM
md72xxxxxxxxxxxxxxxxxxxxxxxx9abw  Stripe MCP (test mode)          Stripe Showcase  active   1.0.0     5/24/2026, 3:02:27 PM
md72xxxxxxxxxxxxxxxxxxxxxxxx99nz  Slate                           Slate Showcase   active   1.0.0     5/22/2026, 10:41:52 PM
md75xxxxxxxxxxxxxxxxxxxxxxxx8n1g  Forge — Code & Issues API       Forge Showcase   active   1.0.0     5/22/2026, 10:41:18 PM
md7fxxxxxxxxxxxxxxxxxxxxxxxx4zqx  Tally — Payments & Billing API  Tally Showcase   active   1.0.0     5/21/2026, 8:04:20 PM

mcp servers get <serverId> — the deployed URL is the live MCP endpoint:

id                 md77xxxxxxxxxxxxxxxxxxxxxxxxanfs
name               GitHub MCP (demo org)
status             active
version            1.0.0
project            GitHub Showcase (js74xxxxxxxxxxxxxxxxxxxxxxxx8w0d)
url                https://github-mcp-demo-org-hd87bhjc.dev-mcp.mcpcloud.sh/mcp
latest deployment  nd73xxxxxxxxxxxxxxxxxxxxxxxxbhjc
last deployed      5/24/2026, 3:31:36 PM
created            5/24/2026, 3:16:41 PM
updated            5/28/2026, 9:40:52 PM

mcp servers logs <serverId> — recent deployment events (newest first):

[2026-05-24T19:31:38.792Z] INFO    health       Health check passed.
[2026-05-24T19:31:37.508Z] INFO    deploy       Synced dispatch policy for the active platform deployment.
[2026-05-24T19:31:36.513Z] INFO    deploy       Deployment is active at https://github-mcp-demo-org-hd87bhjc.dev-mcp.mcpcloud.sh/mcp.
[2026-05-24T19:31:34.928Z] INFO    deploy       Uploading Worker module to Cloudflare Workers for Platforms.
[2026-05-24T19:31:26.517Z] INFO    build        Preparing generated Worker modules for Cloudflare.
[2026-05-24T19:31:26.438Z] INFO    queue        Deployment queued.

Tools

mcp tools list --server <serverId>
mcp tools show <name> --server <serverId>
mcp tools enrich <name> [--apply]
mcp tools diff <name>
mcp tools pull [name]

mcp tools list --server <serverId> — every generated tool with its enrichment status:

Name                          Method  Path  Enrichment  Description
────────────────────────────  ──────  ────  ──────────  ─────────────────────────────────────────────
searchRepos                                 completed   Search GitHub repositories by keywords and q…
searchIssuesAndPullRequests                 completed   Search for GitHub issues and pull requests …
pullsCreateReview                           completed   Create a code review on a pull request with…
pullsMerge                                  completed   Merge a pull request into its base branch. …
issuesCreate                                completed   Create a new issue in a GitHub repository. …
reposGet                                    completed   Retrieve comprehensive metadata for a speci…
…  (28 tools total)

mcp tools show <name> --server <serverId> surfaces the applied metadata plus any pending AI suggestion:

searchRepos (n17dxxxxxxxxxxxxxxxxxxxxxxxxataf)
  description:    Search GitHub repositories by keywords and qualifiers (language, stars, forks, topics, etc.)…
  semanticTags:   search, repositories, discovery, github, code-search
  riskClass:      read
  idempotent:     true
  updatedAt:      5/24/2026, 3:29:47 PM

AI enrichment (status: completed)
  last applied:   5/24/2026, 3:29:47 PM
  Apply with: mcp tools enrich searchRepos --apply

Deployments

mcp deployments list
mcp deployments get <deploymentId>
mcp deployments runtime-auth <deploymentId>
mcp deployments logs <deploymentId> [--follow]
mcp deployments rollback <deploymentId>

ID                                Server                          Project          Target      Access   Status   Version   Deployed
────────────────────────────────  ──────────────────────────────  ───────────────  ──────────  ───────  ───────  ────────  ─────────────────────
nd73xxxxxxxxxxxxxxxxxxxxxxxxbhjc  GitHub MCP (demo org)           GitHub Showcase  workersDev  public   active   0.1.0     5/24/2026, 3:31:36 PM
nd77xxxxxxxxxxxxxxxxxxxxxxxxbfha  Stripe MCP (test mode)          Stripe Showcase  workersDev  public   active   1.0.0     5/24/2026, 3:02:27 PM
nd72xxxxxxxxxxxxxxxxxxxxxxxx8494  Slate                           Slate Showcase   workersDev  public   active   0.1.0     5/22/2026, 10:41:52 PM
nd76xxxxxxxxxxxxxxxxxxxxxxxx9640  Forge — Code & Issues API       Forge Showcase   workersDev  public   active   0.1.0     5/22/2026, 10:41:18 PM
nd7cxxxxxxxxxxxxxxxxxxxxxxxx611f  Tally — Payments & Billing API  Tally Showcase   workersDev  public   active   0.1.0     5/21/2026, 8:04:20 PM

mcp deployments runtime-auth <deploymentId> — the access posture and edge policy for a deployment, including rate/request limits:

deployment       GitHub MCP (demo org) (nd73xxxxxxxxxxxxxxxxxxxxxxxxbhjc)
access mode      public
requires token   no
deployment url   https://github-mcp-demo-org-hd87bhjc.dev-mcp.mcpcloud.sh/mcp
exchange path    /api/v1/runtime/auth/token
token audience   mcpfactory-runtime
exposure target  platformSubdomain
runtime kind     platformWorker

edge policy       active
allowed audience  —
allowed org       —
rate limit        60 req / 60s
request limit     60 / day
updated           5/24/2026, 3:31:36 PM

Invoke a tool

mcp invoke exchanges runtime-auth if needed, sends a JSON-RPC tools/call, and prints the response — a fast way to smoke-test a deployed server:

mcp invoke <serverId> searchRepos --args '{"q":"mcp language:typescript stars:>500","per_page":3}'

{
  "total_count": 287,
  "incomplete_results": false,
  "items": [
    {
      "full_name": "BrowserMCP/mcp",
      "html_url": "https://github.com/BrowserMCP/mcp",
      "description": "Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser",
      "stargazers_count": 2400,
      "language": "TypeScript"
    }
    // …two more items
  ]
}

--args accepts inline JSON, @path/to/args.json, or @- for stdin. Add --json for the full JSON-RPC envelope, or --raw to skip the content-block pretty printer.

Skills

mcp skills list
mcp skills get <skillId>
mcp skills create --project <projectId> --name <name>
mcp skills connect <skillId> [--agent <agent>] [--apply]
mcp skills install <skillId>
mcp skills versions <skillId>
mcp skills installations <skillId>

ID                                Name                                Project          Status     Version   Updated
────────────────────────────────  ──────────────────────────────────  ───────────────  ─────────  ────────  ─────────────────────
ms73xxxxxxxxxxxxxxxxxxxxxxxxa69b  PR Review Readiness Sweep (GitHub)  GitHub Showcase  published  1.0.0     5/24/2026, 3:32:36 PM
ms7bxxxxxxxxxxxxxxxxxxxxxxxx8knx  Failed Payment Recovery (Stripe)    Stripe Showcase  published  1.0.0     5/23/2026, 2:31:25 PM
ms7cxxxxxxxxxxxxxxxxxxxxxxxx8kqk  Meeting Notes → Action Items        Slate Showcase   published  1.0.0     5/22/2026, 10:42:19 PM
ms78xxxxxxxxxxxxxxxxxxxxxxxx87p1  PR Review Readiness Sweep           Forge Showcase   published  1.0.0     5/22/2026, 10:42:12 PM
ms79xxxxxxxxxxxxxxxxxxxxxxxx5d9w  Failed Payment Recovery             Tally Showcase   published  1.0.0     5/21/2026, 7:54:38 PM

Marketplace

mcp marketplace list
mcp marketplace get <artifactId>
mcp marketplace versions <artifactId>

ID                                Name                                Type    Access   Version   Creator        Published
────────────────────────────────  ──────────────────────────────────  ──────  ───────  ────────  ─────────────  ─────────────────────
p170xxxxxxxxxxxxxxxxxxxxxxxxbg9g  PR Review Readiness Sweep (GitHub)  skill   public   1.0.0     MCPCloudDemos  5/24/2026, 3:32:37 PM
p17cxxxxxxxxxxxxxxxxxxxxxxxxbytn  GitHub MCP (demo org)               server  public   1.0.0     MCPCloudDemos  5/24/2026, 3:32:36 PM
p17axxxxxxxxxxxxxxxxxxxxxxxx8xa8  Stripe MCP (test mode)              server  public   1.0.0     MCPCloudDemos  5/23/2026, 2:31:25 PM
p178xxxxxxxxxxxxxxxxxxxxxxxx9fq5  Meeting Notes → Action Items        skill   public   1.0.0     MCPCloudDemos  5/22/2026, 10:42:19 PM
p173xxxxxxxxxxxxxxxxxxxxxxxx6ka2  Tally — Payments & Billing API      server  public   1.0.0     MCPCloud Team  5/21/2026, 8:04:31 PM

API keys

mcp api-keys list
mcp api-keys create --name <name>   # secret is shown once
mcp api-keys revoke <apiKeyId>

ID                                Name                Preview                Created                 Last Used
────────────────────────────────  ──────────────────  ─────────────────────  ──────────────────────  ─────────────────────
nh73xxxxxxxxxxxxxxxxxxxxxxxxercy  your-machine.local  mcf_xxxxxxxxxxxxxxxxxxx  5/26/2026, 5:23:06 PM   5/29/2026, 1:38:29 PM
nh7cxxxxxxxxxxxxxxxxxxxxxxxxs0qs  your-machine.local  mcf_xxxxxxxxxxxxxxxxxxx  4/29/2026, 4:51:53 PM   5/5/2026, 9:13:27 PM
nh75xxxxxxxxxxxxxxxxxxxxxxxxqs6g  for cli testing     mcf_xxxxxxxxxxxxxxxxxxx  4/27/2026, 9:33:42 PM   4/29/2026, 4:26:18 PM

Config and profiles

mcp config show
mcp config set-url <url>
mcp config set-org <organizationId>
mcp config use <profile>           # switch active profile (e.g. staging, prod)
mcp --profile prod servers list    # run one command against a named profile

mcp config show prints the active profile (the API key is always redacted):

path         /Users/you/.mcpcloud/config.json
profile      local
base url     https://api.mcpcloud.sh
app url      https://mcpcloud.sh
default org  —
api key      mcf_xxxxxxxxxxx
editor       cursor
editor open  always

Shell completion

mcp completion zsh  > "${fpath[1]}/_mcp" && compinit
mcp completion bash > ~/.local/share/bash-completion/completions/mcp
mcp completion fish > ~/.config/fish/completions/mcp.fish

#compdef mcp mcpsh mcpcloud

# mcp zsh completion. Install:
#   mcp completion zsh > "${fpath[1]}/_mcp"
# then restart your shell or run `compinit`.

_mcp() {
  local -a commands
  commands=(
    'login:Sign in via browser (default) or paste an API key'
    'whoami:Show the caller identity, API key, base URL, and organizations'
    'servers:Manage MCP servers'
    …
  )
}

Diagnostics

Run mcp doctor whenever something looks off — it checks Node, your config, the base URL, API-key auth, the claude CLI, and whether a newer release is available. See Diagnostics & the interactive UI for the full walkthrough.

mcp doctor
mcp update

CLI docs

Command Reference

Command reference

Auth and identity

Projects

Servers

Tools

Deployments

Invoke a tool

Skills

Marketplace

API keys

Config and profiles

Shell completion

Diagnostics

​Command reference

​Auth and identity

​Projects

​Servers

​Tools

​Deployments

​Invoke a tool

​Skills

​Marketplace

​API keys

​Config and profiles

​Shell completion

​Diagnostics

Command reference

Auth and identity

Projects

Servers

Tools

Deployments

Invoke a tool

Skills

Marketplace

API keys

Config and profiles

Shell completion

Diagnostics