MCP commands

Manage Model Context Protocol server integrations

MCP (Model Context Protocol) commands let you connect Jazz agents to external services and data sources.

jazz mcp add

Add an MCP server configuration.

jazz mcp add [json] [options]

Arguments:

json · string

Optional inline JSON configuration

Options:

-f, --file · string

Read MCP server JSON from a file

Add methods

Interactive

Run without arguments to add a server interactively:

jazz mcp add

You’ll be prompted to paste your MCP server JSON configuration.

From file

Load configuration from a JSON file:

jazz mcp add --file mcp-config.json

Inline

Pass JSON directly as an argument:

jazz mcp add '{"github":{"command":"npx","args":["-y","@modelcontextprotocol/server-github"]}}'

Piped input

Pipe JSON from stdin:

cat mcp-config.json | jazz mcp add

Configuration format

MCP server configurations use this structure:

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "package-name"],
      "env": {
        "API_KEY": "your-key"
      }
    }
  }
}

Or for HTTP servers:

{
  "mcpServers": {
    "server-name": {
      "transport": "http",
      "url": "https://api.example.com/mcp",
      "headers": {
        "Authorization": "Bearer token"
      }
    }
  }
}

jazz mcp list

List all configured MCP servers.

jazz mcp list
jazz mcp ls  # alias

Displays:

• Server name
• Command or URL
• Enabled/disabled status
• Transport type (stdio or http)

jazz mcp remove

Remove an MCP server.

jazz mcp remove
jazz mcp rm  # alias

Launches an interactive selector to choose which server to remove.

jazz mcp enable

Enable a disabled MCP server.

jazz mcp enable

Launches an interactive selector to choose which disabled server to enable.

jazz mcp disable

Disable an enabled MCP server.

jazz mcp disable

Launches an interactive selector to choose which enabled server to disable.

Disabled servers remain configured but won’t be loaded or used by agents.

Popular MCP servers

GitHub

Access GitHub repositories, issues, and pull requests.

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token"
      }
    }
  }
}

Notion

Read and write Notion pages and databases.

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.notion.com/mcp"]
    }
  }
}

PostgreSQL

Query and analyze PostgreSQL databases.

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_CONNECTION_STRING": "postgresql://user:pass@host:5432/db"
      }
    }
  }
}

Filesystem

Advanced filesystem operations.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/allowed/path"]
    }
  }
}

Slack

Send messages and interact with Slack.

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-token"
      }
    }
  }
}

Examples

Add GitHub integration

jazz mcp add --file github-mcp.json

With github-mcp.json:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token"
      }
    }
  }
}

List all MCP servers

jazz mcp list

Disable a server temporarily

jazz mcp disable
# Select: github

Re-enable a server

jazz mcp enable
# Select: github

Tips

MCP servers are loaded lazily—only when an agent needs them. This keeps startup fast.

Store API keys in environment variables rather than hardcoding them in configuration files.

You can disable servers without removing them if you want to temporarily turn off an integration.

MCP server configurations are stored in ~/.agents/mcp.json (full config) and ~/.jazz/jazz.config.json (enabled status).

Next steps

MCP integration guide

Learn more about using MCP servers

MCP concept

Understand how MCP works in Jazz