Skip to content
MCP server

Codebase

Let an AI agent build, preview and publish web apps on your Codebase account

Install
Pricing
Freemium
Platforms
API, Web
Runs
Remotely
Version
0.1.0
Listing updated
1 day ago

About Codebase

Codebase is a freemium MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://codebase.design/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "codebase": {
      "url": "https://codebase.design/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Freemium, from $16 a month

Free 1,000 credits/mo; Indie $16, Builder $33, Pro $65 per month (introductory beta pricing)

Prices change. Check codebase.design before you buy.

Codebase 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 to Codebase

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools