Documentation Index
Fetch the complete documentation index at: https://mintlify.com/lvndry/jazz/llms.txt
Use this file to discover all available pages before exploring further.
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]
Optional inline JSON configuration
Read MCP server JSON from a file
Add methods
Interactive
From file
Inline
Piped input
Run without arguments to add a server interactively:You’ll be prompted to paste your MCP server JSON configuration. Load configuration from a JSON file:jazz mcp add --file mcp-config.json
Pass JSON directly as an argument:jazz mcp add '{"github":{"command":"npx","args":["-y","@modelcontextprotocol/server-github"]}}'
Pipe JSON from stdin:cat mcp-config.json | jazz mcp add
{
"mcpServers": {
"server-name": {
"command": "npx",
"args": ["-y", "package-name"],
"env": {
"API_KEY": "your-key"
}
}
}
}
{
"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
- 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
jazz mcp enable
Enable a disabled MCP server.
Launches an interactive selector to choose which disabled server to enable.
jazz mcp disable
Disable an enabled MCP server.
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
Access GitHub repositories, issues, and pull requests.{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "your-token"
}
}
}
}
Read and write Notion pages and databases.{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.notion.com/mcp"]
}
}
}
Query and analyze PostgreSQL databases.{
"mcpServers": {
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres"],
"env": {
"POSTGRES_CONNECTION_STRING": "postgresql://user:pass@host:5432/db"
}
}
}
}
Advanced filesystem operations.{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/allowed/path"]
}
}
}
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
github-mcp.json:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token"
}
}
}
}
List all MCP servers
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