# Samebase

> Samebase is a free MCP server for developer tools. Create GitHub-backed Convex apps with live URLs and per-PR previews from an agent. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://samebase.com
- **Repository:** https://github.com/samebase/plugin
- **MCP Registry name:** com.samebase/samebase
- **Categories:** developer tools, cloud and infrastructure
- **Listing updated:** 2026-11-14

## About

Samebase handles the plumbing around an app a coding agent writes. After you connect GitHub and Convex with one OAuth step each, it creates a repository in your GitHub, writes a Convex access token into it, and the first push deploys through Alchemy from your own GitHub Actions in about 90 seconds. Google sign-in is set up, and every pull request gets its own deployment and data, deleted when the PR closes.

The MCP server is installed as a plugin for ChatGPT, Codex and Claude Code, together with a skill telling the client when to use Samebase and when to ask before a provider change. It reads app state such as URL, deployed commit, checks and pull requests. After setup Samebase changes nothing in your accounts, and deleting your Samebase account leaves the app running once you swap the token for your own.

It is in beta and free during the beta. The app is source-available under the FSL, while the template and plugin are Apache 2.0. Samebase resells no hosting; GitHub and Convex bill directly.

## Features

- **Repository creation:** Creates a repo in your GitHub and wires the deploy token.
- **Deploy on push:** Alchemy deploys the app from your own GitHub Actions.
- **Preview per pull request:** Each PR gets its own deployment and database.
- **Google sign-in:** Authentication is configured for the app.
- **App state reading:** Reports URL, deployed commit, checks and pull requests.
- **Optional Cloudflare:** Declare a Worker and add Cloudflare tokens to use it.

## Good for

- Give a coding agent a deployable app from a prompt
- Run several agents in parallel with isolated previews
- Review a pull request on its own live URL
- List the apps an agent has deployed
- Move an app off Samebase without downtime

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http samebase https://samebase.com/mcp
```

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

```sh
https://samebase.com/mcp
```

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

```json
{
  "mcpServers": {
    "samebase": {
      "url": "https://samebase.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "samebase": {
      "type": "http",
      "url": "https://samebase.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "samebase": {
      "serverUrl": "https://samebase.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "samebase": {
      "type": "http",
      "url": "https://samebase.com/mcp"
    }
  }
}
```

## FAQ

### What does it cost?

Samebase is free during the beta, and GitHub and Convex bill their own usage.

### Is it open source?

The app is source-available under the FSL; the template and agent plugin are Apache 2.0.

### What if I delete my account?

Your app keeps running; swap the Convex token for your own before revoking Samebase.

### How do I install the plugin?

Claude Code: /plugin marketplace add samebase/plugin. Codex: codex plugin marketplace add samebase/plugin.

### Is Samebase free?

Yes. Samebase is free to use.

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

Run this command in your terminal: claude mcp add --transport http samebase https://samebase.com/mcp

### What are the best alternatives to Samebase?

The closest alternatives to Samebase 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/samebase
