# Install Mcp

> A simple CLI to install MCP servers into any client - auth included!

- **Type:** MCP server
- **Install:** `agentstack add mcp-supermemoryai-install-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [supermemoryai](https://agentstack.voostack.com/s/supermemoryai)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [supermemoryai](https://github.com/supermemoryai)
- **Source:** https://github.com/supermemoryai/install-mcp
- **Website:** https://www.npmjs.com/package/install-mcp

## Install

```sh
agentstack add mcp-supermemoryai-install-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Install MCP CLI

### A CLI tool to install and manage MCP servers.

Installing MCPs is a huge pain, so I made a CLI tool to make it easier.

## Usage

The CLI now supports multiple installation methods with automatic detection:

### Simple package names

```bash
npx install-mcp mcp-package-name --client claude-desktop
```

### Scoped packages

```bash
npx install-mcp @org/mcp-server --client claude-desktop
```

### Full commands (for custom arguments)

```bash
npx install-mcp 'npx some-mcp-server --custom-args' --client claude-desktop
```

### Remote URLs (with automatic naming)

```bash
npx install-mcp https://mcp.example.com/server --client claude-desktop
```

The tool automatically:

- Converts simple package names to `npx package-name`
- Preserves full commands as-is
- Infers server names from package names or URLs (e.g., `mcp.example.com` → `mcp-example-com`)
- Handles OAuth authentication for remote servers

### Supermemory project support

When installing a server hosted on `https://api.supermemory.ai/*`, you can pass a project name via `--project`. This is a convenience alias for adding the header `x-sm-project: `.

Rules:

- Only applies to URL installs targeting `https://api.supermemory.ai/*`.
- Values must not contain spaces.
- If you omit `--project` for these URLs, you'll be prompted. Pressing Enter uses `default`.
- The value is injected as a header alongside any `--header` flags.

Examples:

```bash
# Explicit project
npx install-mcp https://api.supermemory.ai/servers/my-server \
  --client cursor \
  --project myproj

# Prompted for project (Enter defaults to "default")
npx install-mcp https://api.supermemory.ai/servers/my-server --client cursor
```

Warp users: the generated config will include `--header "x-sm-project: "` in the `args` array when installing Supermemory URLs.

### Headers Support

You can pass headers for authentication or other purposes using the `--header` flag:

```bash
# Single header
npx install-mcp https://api.example.com/mcp --client claude-desktop --header "Authorization: Bearer token123"

# Multiple headers
npx install-mcp https://api.example.com/mcp --client claude-desktop \
  --header "Authorization: Bearer token123" \
  --header "X-API-Key: secret-key"
```

### OAuth Authentication for Remote Servers

When installing remote servers (URLs), the CLI will ask if the server uses OAuth authentication:

```bash
npx install-mcp https://api.example.com/mcp --client claude-desktop
# Output: Does this server use OAuth authentication? (Y/n)
```

You can bypass this prompt using the `--oauth` flag:

```bash
# Automatically run OAuth authentication
npx install-mcp https://api.example.com/mcp --client claude-desktop --oauth yes

# Skip OAuth authentication entirely
npx install-mcp https://api.example.com/mcp --client claude-desktop --oauth no
```

If you answer yes, the authentication flow:

- Runs automatically before installation
- Handles OAuth flows seamlessly in the background
- **Authentication state is shared globally** - once you authenticate with a server, that authentication is automatically available to all MCP clients
- No need to re-authenticate when using the same server in different clients

```bash
# Output: Running authentication for https://api.example.com/mcp
```

If authentication fails, you'll see:

```
Authentication failed. Use the client to authenticate.
```

If the server doesn't use OAuth (you answer no), the installation proceeds directly without authentication.

This ensures secure access to remote servers while maintaining flexibility for servers that don't require OAuth.

## Supported Clients

The `--client` flag specifies which MCP client you're installing for:

- `claude-desktop`
- `cline`
- `roo-cline`
- `windsurf`
- `witsy`
- `enconvo`
- `cursor`
- `vscode`
- `gemini-cli`
- `claude-code`
- `goose`
- `zed`
- `opencode`
- `warp` (outputs config to copy/paste into Warp's cloud-based settings)
- `codex` (OpenAI's Codex CLI tool)
- `droid` (Factory.AI's Droid CLI tool)
- `aider` (AI pair programming tool)
- `aider-desk` (Desktop version of aider)

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [supermemoryai](https://github.com/supermemoryai)
- **Source:** [supermemoryai/install-mcp](https://github.com/supermemoryai/install-mcp)
- **License:** MIT
- **Homepage:** https://www.npmjs.com/package/install-mcp

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-supermemoryai-install-mcp
- Seller: https://agentstack.voostack.com/s/supermemoryai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.