PlanMySaaS API — Overview

The PlanMySaaS API gives developers the same blueprint pipeline that powers the web app — exposed as a versioned REST API and as an MCP server for AI IDEs (Claude Desktop, Cursor, Windsurf, Claude Code).

Every call costs credits from your workspace balance. Your 100 signup credits work across web + API — there's no developer tax.

Quick start

  1. Generate an API key at Settings → API Keys.
  2. Paste it into the X-API-Key header (or Authorization: Bearer <key>).
  3. POST to any endpoint under /api/v1/mcp/generate/* with a JSON body containing idea.

First call

curl -X POST https://www.planmysaas.com/api/v1/mcp/generate/research \
  -H "X-API-Key: pms_live_…" \
  -H "Content-Type: application/json" \
  -d '{"idea":"A quiet-hours SMS scheduler for solo SaaS founders"}'

Response shape:

{
  "data": { /* structured output for the tool */ },
  "meta": {
    "tool":             "generate_research",
    "creditsCharged":   25,
    "creditsRemaining": 475,
    "durationMs":       8234,
    "requestId":        "a1b2c3…"
  }
}

Base URL

https://www.planmysaas.com/api/v1

The /v1 prefix means this surface is stable — breaking changes ship as /v2 with a deprecation window of at least 90 days.

Request envelope

All generation endpoints accept POST requests with JSON. The only required field is idea (10-2000 chars). Optional upstream artefacts can be passed to improve output coherence:

  • research — pass to /generate/architecture so tech choices factor in market context
  • architecture — pass to /generate/features for feature specs that respect your system design
  • features — pass to /generate/phases to sequence real features into real phases

Response envelope

Every response follows one of two shapes:

Success (2xx)

{ "data": { ... tool-specific output ... },
  "meta": { "tool", "creditsCharged", "creditsRemaining", "durationMs", "requestId" } }

Error (4xx / 5xx)

{ "error": {
    "code":    "insufficient_credits",      // machine-readable
    "message": "You need 150 credits but have 40.",
    "docs":    "https://www.planmysaas.com/docs/api/errors",
    "requestId": "a1b2c3…"
  }}

Tools available

ToolEndpointCreditsPlan
Research POST /generate/research 25Free+
Architecture POST /generate/architecture 20Free+
Features POST /generate/features 25Free+
Phases POST /generate/phases 15Free+
Prompt Pack POST /generate/prompt-pack 30Starter+
Full BlueprintPOST /generate/blueprint 150Starter+
Check Credits GET /credits 0 Free+

Next steps