Maguyva.ai Documentation
Installation Guide (NPM method)

Installation Guide (NPM method)

Connect client to MCP server

🗄ī¸
Your Github account must be connected to your Maguyva account at app.maguyva.ai.
🔑
You must obtain a Maguyva personal API key from app.maguyva.ai.

Set your key in environment variables

⚠ī¸
Your personal API key will be stored in environment variables. This is considered best practice. You should ensure secrets are not shared e.g. checked into to your repo.

ℹī¸
Replace “mgv_xxxx” in the examples below with your personal Maguyva API key.
ℹī¸
Replace “github_user_account/repository_name” with the github name and repo you’re using.

Linux (Bash)

For one off use:

export MAGUYVA_ENDUSER_KEY="mgv_xxxx"
export DEFAULT_REPOSITORY="github_user_account/repository_name"

Save this to your ~/.bashrc for persistence

OR run this to save to your file:

# add to your shell profile for persistence:
echo 'export MAGUYVA_ENDUSER_KEY="mgv_xxxx"' >> ~/.bashrc
echo 'export DEFAULT_REPOSITORY="github_user_account/repository_name"' >> ~/.bashrc
source ~/.bashrc                                              # reload

macOS (Zsh)

For one off use:

export MAGUYVA_ENDUSER_KEY="mgv_xxxx"
export DEFAULT_REPOSITORY="github_user_account/repository_name"

Save this to your ~/.zshrc for persistence

# add to your shell profile for persistence:
echo 'export MAGUYVA_ENDUSER_KEY="mgv_xxxx"' >> ~/.zshrc
echo 'export DEFAULT_REPOSITORY="github_user_account/repository_name"' >> ~/.zshrc
source ~/.zshrc                                              # reload

Windows (PowerShell) 

# make it persist in your profile:
'$Env:MAGUYVA_ENDUSER_KEY="mgv_xxxx"' | Out-File -Append $PROFILE
'$Env:DEFAULT_REPOSITORY="github_user_account/repository_name"' | Out-File -Append $PROFILE
. $PROFILE

Connect the MCP via mcp-remote

Standard config
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": ["@maguyva/mcp@latest"],
      "env": {
        "DEFAULT_REPOSITORY": "github_user_account/repository_name"
      }
    }
  }
}
⚠ī¸
The examples below have not been updated to specify a default repository.
Claude Code
claude mcp add maguyva npx @maguyva/mcp@latest
Claude Desktop
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "@maguyva/mcp@latest"
      ]
    }
  }
}
Cursor
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "@maguyva/mcp@latest"
      ]
    }
  }
}
Gemini CLI
# Install MCP server
npm install -g @maguyva/mcp@latest

# Configure in Gemini CLI settings
gemini config set mcp.servers.maguyva "npx @maguyva/mcp@latest"
Goose
# goose.yaml
mcp_servers:
  maguyva:
    command: npx
    args:
      - "@maguyva/mcp@latest"
LM Studio
{
  "mcp": {
    "servers": {
      "maguyva": {
        "command": "npx",
        "args": ["@maguyva/mcp@latest"]
      }
    }
  }
}
Qodo Gen
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "@maguyva/mcp@latest"
      ]
    }
  }
}
VS Code
{
  "mcp.servers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "@maguyva/mcp@latest"
      ]
    }
  }
}
Windsurf
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "@maguyva/mcp@latest"
      ]
    }
  }
}

Getting Help

Ready to supercharge your AI workflow? Most developers see immediate improvements in their first session.

Start Your Free Trial →

How Maguyva.ai WorksInstallation Guide (JSON only)