Maguyva.ai Documentation

Transform your AI development workflow with intelligent context optimization. Stop fighting AI context limits and start building better software faster.

Install overview

Get up and running with Maguyva.ai in under 5 minutes:

1. Sign up for free trial - No credit card required
2. Connect your repository - GitHub integration
3. Connect client to MCP server - Connect to one, some or all of your MCP enabled agents
4. Start using optimized context - Works with any MCP-compatible AI agent

Connect client to MCP server (examples)

Set your key in environment variables

You must replace “mgv_xxxx” in the examples below with your key from app.maguyva.ai

macOS/Linux (Bash/Zsh)

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

Windows (PowerShell)

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

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": ["@maguyva/mcp@latest"],
      "env": {
        "DEFAULT_REPOSITORY": "github_user_account/repository_name"
      }
    }
  }
}

# add to your shell profile for persistence:
echo 'export MAGUYVA_ENDUSER_KEY="sk-live-xxxx"' >> ~/.zshrc  # or ~/.bashrc
source ~/.zshrc                                              # reload

claude mcp add maguyva npx @maguyva/mcp@latest

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "@maguyva/mcp@latest"
      ]
    }
  }
}

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "@maguyva/mcp@latest"
      ]
    }
  }
}

# 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.yaml
mcp_servers:
  maguyva:
    command: npx
    args:
      - "@maguyva/mcp@latest"

{
  "mcp": {
    "servers": {
      "maguyva": {
        "command": "npx",
        "args": ["@maguyva/mcp@latest"]
      }
    }
  }
}

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "@maguyva/mcp@latest"
      ]
    }
  }
}

{
  "mcp.servers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "@maguyva/mcp@latest"
      ]
    }
  }
}

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "@maguyva/mcp@latest"
      ]
    }
  }
}

Key Benefits

🚀 50-90% Token Reduction

Dramatically reduce AI processing costs while improving response quality with our intelligent context optimization.

🔧 Universal Compatibility

Works with all major programming languages and any MCP-compatible AI agent. No vendor lock-in.

⚡ Instant Integration

Connect your existing repositories and start optimizing immediately. No complex setup required.

🔒 Enterprise Security

End-to-end encryption, ephemeral processing, and SOC 2 compliance for your proprietary code.

Documentation Overview

Popular Use Cases

Code Review & Analysis

• Faster code reviews with better AI understanding
• Automated security and performance analysis
• Technical debt identification and recommendations

Documentation Generation

• API documentation from codebase analysis
• README and wiki generation
• Code comment and docstring creation

Development Assistance

• Intelligent code completion and suggestions
• Bug detection and resolution guidance
• Architecture recommendations and refactoring

Project Onboarding

• New team member onboarding acceleration
• Codebase explanation and navigation
• Dependency analysis and mapping

Getting Help

• Free Trial - Test Maguyva.ai with your codebase
• Community Support - Get help from other developers
• Contact Us - Direct support for technical questions

Start Your Free Trial →