Codapult
PricingPluginsBlogDocsDemo

The SaaS Boilerplate for Builders

© 2026 Codapult. All rights reserved.

Built with Codapult

Product

  • Pricing
  • Plugins
  • Documentation
  • SaaS template comparison

About

  • Contact

Legal

  • Privacy Policy
  • Terms of Service
All articles

Getting Started

  • Introduction
  • Quick Start
  • Project Structure
  • License and Permitted Use

Configuration

  • Environment Variables
  • App Configuration

Authentication

  • Authentication
  • OAuth Providers
  • Two-Factor & Passwordless
  • Enterprise SSO (SAML)

Database

  • Database
  • Migrations

Teams

  • Teams & Organizations
  • Permissions & RBAC
  • SCIM Provisioning

Payments

  • Payments & Billing
  • Stripe Setup
  • LemonSqueezy Setup
  • Polar Setup
  • Payment Webhooks

Api

  • API Layer
  • tRPC
  • GraphQL

Ai

  • AI Features
  • Streaming Chat
  • RAG and Semantic Search
  • Quotas and Memory

Email

  • Email
  • Email Templates

Infrastructure

  • Infrastructure
  • Self-Hosting
  • File Storage
  • Docker
  • Background Jobs
  • Terraform & Pulumi
  • Kubernetes

Ui

  • UI & Theming

I18n

  • Internationalization

Content Management

  • Content Management

Admin

  • Admin Panel

Security

  • Security

Monitoring

  • Analytics & Monitoring

Modules

  • Module Architecture
  • Waitlist
  • Audit Log
  • White-Labeling
  • Workflow Automation
  • A/B Testing
  • Welcome Page
  • Referrals
  • GDPR Export and Deletion
  • Outgoing Webhooks

Plugins

  • Plugin System
  • AI Kit Plugin
  • CRM Plugin
  • Helpdesk Plugin
  • Email Marketing Plugin

Deployment

  • Deployment
  • Troubleshooting

Upgrading

  • Upgrading Codapult

Developer Tools

  • AI Agents & IDEs
  • MCP Server
  • Testing
Developer Tools

AI Agents & IDEs

Connect Cursor, Claude, Codex, Gemini, Windsurf, and other AI coding agents to Codapult with project instructions and MCP.

Codapult is designed to work well with AI coding agents and AI-native IDEs. The repository includes agent instructions, Cursor rules, and an MCP server that exposes project-aware tools, resources, and prompt templates.

What Is Included

CapabilityFile or commandPurpose
Agent guideAGENTS.mdProject structure, rules, patterns, security requirements, MCP overview
Claude guideCLAUDE.mdShort entrypoint for Claude Code/Claude Desktop users
Gemini guideGEMINI.mdShort entrypoint for Gemini CLI/IDE users
Cursor rules.cursor/rules/*.mdcPattern-specific rules for API routes, DB, components, adapters, plugins, server actions
Cursor MCP config.cursor/mcp.jsonPreconfigured MCP server connection
MCP servercodapult mcp-serverStructured project access for compatible agents

Supported Agents

Agent or IDERecommended setup
CursorUse included .cursor/rules and .cursor/mcp.json
Claude CodeRead CLAUDE.md/AGENTS.md; connect MCP through stdio if supported by your environment
Claude DesktopAdd the Codapult MCP server to claude_desktop_config.json
CodexRead AGENTS.md; use the MCP stdio command when MCP tools are available
Gemini CLI / Gemini Code AssistRead GEMINI.md/AGENTS.md; use the MCP stdio command where supported
Windsurf and other MCP clientsConfigure node ../codapult-cli/dist/index.js mcp-server as a stdio MCP server

MCP Server

The MCP server ships with @codapult/cli and exposes:

  • 19 tools for project status, database inspection, env validation, plugin management, code generation, checks, and deployment readiness.
  • 6 resources: schema, app config, AGENTS.md, .env.example, validation schemas, and navigation config.
  • 2 prompt templates for Codapult code review and schema design.

Build the CLI before using local MCP:

cd ../codapult-cli
pnpm install
pnpm build

Start the server:

node ../codapult-cli/dist/index.js mcp-server

Full reference: MCP Server.

Cursor

The project includes:

{
  "mcpServers": {
    "codapult": {
      "command": "node",
      "args": ["../codapult-cli/dist/index.js", "mcp-server"],
      "cwd": "."
    }
  }
}

Open Cursor settings and verify the codapult MCP server is active.

Claude Desktop

Add a stdio server entry:

{
  "mcpServers": {
    "codapult": {
      "command": "node",
      "args": ["/absolute/path/to/codapult-cli/dist/index.js", "mcp-server"],
      "cwd": "/absolute/path/to/codapult"
    }
  }
}

Agent-Safe Workflows

Ask agents to use Codapult MCP tools instead of guessing:

  • "Run Codapult doctor and tell me what is misconfigured."
  • "List all database tables and propose a schema for saved reports."
  • "Generate a protected dashboard page for invoices."
  • "Install the CRM plugin and show what files changed."
  • "Check deployment readiness for Docker and Terraform."

The MCP server reads project files directly and returns structured results, which reduces stale context and copy-paste errors.

Guardrails for Agents

When prompting an agent, include these constraints:

  • Follow AGENTS.md and .cursor/rules.
  • Use @/ imports and existing UI components.
  • Server components by default; add 'use client' only when browser state or effects are needed.
  • API route pattern: auth, rate limit, Zod validation, business logic, JSON response.
  • Server actions must validate input, check permissions, and revalidate affected paths.
  • Never expose secrets through NEXT_PUBLIC_ variables.
  • Keep modules removable and respect codapult:prune markers.
Upgrading CodapultMCP Server