# Superflag

> Superflag is a freemium MCP server for developer tools. Connect agents to Superflag feature flags with scoped read or write access. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Web
- **Website:** https://superflag.sh
- **MCP Registry name:** io.github.happycatlabs/superflag
- **Categories:** developer tools
- **Listing updated:** 2026-11-16

## About

Superflag is a feature-flag service built around a simple idea in its slogan: ship the code once and decide later who gets it. Flags can target users by attributes, roll out by percentage, run experiments, or switch a feature off without redeploying, and changes are versioned so they can be reviewed and rolled back from the dashboard, CLI or API.

The MCP server lets an agent reach that same account. Access is granted through a browser login, with scoped read, write or read-write permission, so you decide how much an agent can change. The registry entry does not list individual tools.

In applications, the SDK fetches and caches flag configuration and evaluates targeting in process, so checks with a warm cache need no network round trip. A Node SDK is shown. The free tier has one app, five flags and 25,000 requests a month per environment; Pro adds five apps and unlimited flags.

## Features

- **Scoped agent access:** Read, write or read-write permission granted through browser login.
- **Percentage rollouts:** Release a flag to a share of users.
- **Attribute targeting:** Target by user attributes such as plan.
- **Versioned changes:** Review and roll back config from dashboard, CLI or API.
- **Cached SDK evaluation:** Targeting runs in your app with a cached snapshot.
- **Free tier:** One app and five flags without a card.

## Good for

- Let an agent toggle a flag during an incident
- Review current rollout percentages from a chat
- Set up targeting rules for a new feature
- Roll back a flag change

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http superflag https://superflag.sh/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://superflag.sh/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "superflag": {
      "url": "https://superflag.sh/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "superflag": {
      "type": "http",
      "url": "https://superflag.sh/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "superflag": {
      "serverUrl": "https://superflag.sh/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "superflag": {
      "type": "http",
      "url": "https://superflag.sh/api/mcp"
    }
  }
}
```

## FAQ

### How does the server authenticate?

Through a browser login that grants scoped read, write or read-write access.

### Is there a free plan?

Yes: one app, five flags, and 25,000 requests a month per environment.

### Do flag checks need a network call?

Not with a warm cache; the SDK evaluates targeting in process.

### Is Superflag free?

Superflag has a free plan, with paid plans for more usage or features.

### How do I add Superflag to Claude Code?

Run this command in your terminal: claude mcp add --transport http superflag https://superflag.sh/api/mcp

### What are the best alternatives to Superflag?

The closest alternatives to Superflag are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/superflag
