# Codebase

> Codebase is a freemium MCP server for developer tools. Let an AI agent build, preview and publish web apps on your Codebase account. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $16 a month
- **Platforms:** API, Web
- **Website:** https://codebase.design/agents
- **MCP Registry name:** design.codebase/codebase
- **Categories:** developer tools
- **Listing updated:** 2026-11-16

## About

Codebase turns an agent into an app builder that works inside your own account. The agent sends a prompt, polls the build, hands you a private preview link, applies follow-up changes to the same project and, only if you allowed it, publishes. Building never publishes: that needs a key created with deploy scopes, which are not selected by default. You keep the source and can download it as a zip without node_modules or .env files.

Spending is capped by the key. Builds draw on your credit balance, and a key can carry a credit limit, an expiry and narrow scopes. An Idempotency-Key header stops a retried request from starting a second paid build. Publishing supports rollback to an earlier version and unpublishing, with older versions kept.

An agent with a crypto wallet can skip the account: the API answers with an x402 payment offer in USDC on Base and returns a key holding the purchased credits. A Base starter with game, payments, social and mint recipes produces mini apps for the Base App and Farcaster.

## Features

- **Prompt to app:** Start a build from a prompt and poll its status and files.
- **Private previews:** Get a preview link you can open without signing in.
- **Follow-up changes:** Send another prompt against the same project.
- **Scoped, capped keys:** Limit scopes, expiry and credit spend per key.
- **Publish and roll back:** Deploy, switch to an earlier version or unpublish.
- **Pay with x402:** Agents with a wallet can buy credits in USDC on Base.

## Good for

- Have an agent prototype a web app and send you a preview
- Iterate on an app through follow-up prompts
- Download the generated source to keep
- Build a Base mini app such as a small game

## Install

### Claude Code (Terminal)

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

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

```sh
https://codebase.design/api/mcp
```

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

```json
{
  "mcpServers": {
    "codebase": {
      "url": "https://codebase.design/api/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "codebase": {
      "serverUrl": "https://codebase.design/api/mcp"
    }
  }
}
```

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

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

## FAQ

### Can the agent publish without my consent?

No. Publishing needs a key with deploys:write, which is not selected by default.

### How are builds paid?

With credits from your plan or pack; the free plan includes 1,000 credits a month, about 66 builds.

### Do I own the code?

The page says you keep the source and can download it.

### How do I connect?

Use the hosted endpoint with a Bearer key, or add it as a connector in claude.ai or ChatGPT.

### Is Codebase free?

Codebase has a free plan, with paid plans for more usage or features. Paid plans start at $16 a month.

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

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

### What are the best alternatives to Codebase?

The closest alternatives to Codebase 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/codebase
