Skip to content
mpak

Cursor Integration

Cursor supports MCP servers natively. mpak bundles work seamlessly with Cursor’s Agent mode.

Configuration File Location

Section titled “Configuration File Location”
.cursor/mcp.json

Share with your team or add to .gitignore for private config.

Quick Setup

Section titled “Quick Setup”
  1. Open Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
  2. Search “MCP” → Select “View: Open MCP Settings”
  3. Click “New MCP Server” or edit mcp.json directly

Add an mpak bundle:

{
  "mcpServers": {
    "echo": {
      "command": "mpak",
      "args": ["run", "@nimblebraininc/echo"]
    }
  }
}

Multiple Servers

Section titled “Multiple Servers”
{
  "mcpServers": {
    "echo": {
      "command": "mpak",
      "args": ["run", "@nimblebraininc/echo"]
    },
    "ipinfo": {
      "command": "mpak",
      "args": ["run", "@nimblebraininc/ipinfo"],
      "env": {
        "IPINFO_API_TOKEN": "your-token"
      }
    }
  }
}

Using MCP Servers in Cursor

Section titled “Using MCP Servers in Cursor”

Once configured, Cursor automatically uses MCP tools in Agent mode:

  1. Open the AI chat panel
  2. Select Agent mode (not Ask or Edit)
  3. Prompt Cursor - it will use relevant MCP tools automatically

Configuration with Secrets

Section titled “Configuration with Secrets”

Option 1: Environment Variables

Section titled “Option 1: Environment Variables”
{
  "mcpServers": {
    "ipinfo": {
      "command": "mpak",
      "args": ["run", "@nimblebraininc/ipinfo"],
      "env": {
        "IPINFO_API_TOKEN": "your-token-here"
      }
    }
  }
}
Section titled “Option 2: mpak config (Recommended)”

Keep secrets out of config files:

Terminal window
mpak config set @nimblebraininc/ipinfo api_key=your-token

Then use a clean config:

{
  "mcpServers": {
    "ipinfo": {
      "command": "mpak",
      "args": ["run", "@nimblebraininc/ipinfo"]
    }
  }
}

Pin to a Specific Version

Section titled “Pin to a Specific Version”
{
  "mcpServers": {
    "echo": {
      "command": "mpak",
      "args": ["run", "@nimblebraininc/echo@1.0.0"]
    }
  }
}

Troubleshooting

Section titled “Troubleshooting”

Server Not Appearing

Section titled “Server Not Appearing”
  1. Ensure you’re in Agent mode (not Ask or Edit)
  2. Check the MCP server status in settings
  3. Test the bundle directly: mpak run @package/name

Command Not Found

Section titled “Command Not Found”

Ensure mpak is installed globally:

Terminal window
npm install -g @nimblebrain/mpak
which mpak

If using a version manager (nvm, volta), specify the full path:

{
  "mcpServers": {
    "echo": {
      "command": "/Users/you/.nvm/versions/node/v20.0.0/bin/mpak",
      "args": ["run", "@nimblebraininc/echo"]
    }
  }
}

Resources

Section titled “Resources”