Proposal Generator MCP

An MCP (Model Context Protocol) server that turns client requirements into a timeline, tech stack, price estimate, milestone breakdown, and a ready-to-send Markdown proposal document — built for freelancers and agencies.

{
  "clientName": "Green Valley Fertilizers",
  "projectType": "ecommerce",
  "features": ["auth", "ecommerce-catalog", "payments", "admin-dashboard", "search"],
  "region": "pakistan"
}

Use it from Claude Desktop, Claude Code, Cursor, or any MCP-compatible client.

Tools

Tool	Returns
`generate_proposal`	Full pipeline: JSON summary + Markdown proposal document
`estimate_price_and_timeline`	Quick estimate: hours, price range, timeline
`recommend_tech_stack`	Tech stack suggestion based on project type + features
`list_feature_catalog`	Every recognized feature key with its hour estimate and category

Install & run

Option A — from source (local development)

git clone <repo-url> proposal-generator
cd proposal-generator
bun install
bun run build

Start the server:

bun start

Option B — from npm (published package)

npm install -g @proposal-generator/server
# or
bun install -g @proposal-generator/server

Run it:

proposal-generator-mcp

Scripts reference

Script	Description
`bun run build`	Build with tsdown (ESM + .d.ts + sourcemap)
`bun run dev`	Watch mode rebuild on changes
`bun run lint`	Auto-fix lint & formatting issues (biome)
`bun run lint:check`	Check lint without writing
`bun run typecheck`	`tsc --noEmit` type verification
`bun run release`	Build, bump version, publish to npm

Configure your MCP client

Claude Desktop

Edit claude_desktop_config.json (location varies by OS):

Local source install:

{
  "mcpServers": {
    "proposal-generator": {
      "command": "bun",
      "args": ["run", "/absolute/path/to/proposal-generator/packages/server/dist/index.mjs"]
    }
  }
}

Global npm install:

{
  "mcpServers": {
    "proposal-generator": {
      "command": "npx",
      "args": ["@proposal-generator/server"]
    }
  }
}

Claude Code

# Local source install
claude mcp add proposal-generator -- bun run /absolute/path/to/proposal-generator/packages/server/dist/index.mjs

# Global npm install
claude mcp add proposal-generator -- npx @proposal-generator/server

Cursor

Settings → Features → MCP Servers → Add new MCP server:

Field	Local	npm
Name	`proposal-generator`	`proposal-generator`
Type	`command`	`command`
Command	`bun run /absolute/path/.../dist/index.mjs`	`npx @proposal-generator/server`

opencode

If using opencode, add to your project's opencode.json:

{
  "mcpServers": {
    "proposal-generator": {
      "command": "bun",
      "args": ["run", "packages/server/dist/index.mjs"]
    }
  }
}

Any MCP client (stdio)

{
  "mcpServers": {
    "proposal-generator": {
      "command": "bun",
      "args": ["run", "/path/to/packages/server/dist/index.mjs"]
    }
  }
}

Customizing estimates

Everything that drives the numbers lives in two files — no logic changes needed:

File	What to tune
`packages/server/src/data/featureCatalog.ts`	Feature keys, hour estimates, tech pulled in
`packages/server/src/data/rateCards.ts`	Regional hourly rates, base hours per project type, complexity multipliers

The milestone template (phase names, payment splits) lives in packages/server/src/logic/estimator.ts. The proposal document layout lives in packages/server/src/logic/proposalBuilder.ts.

After editing any of these, rebuild with bun run build.

Project structure

proposal-generator/
├── package.json               # workspace root (bun monorepo)
├── biome.json                 # lint & format config
├── tsconfig.base.json         # shared TypeScript config
├── opencode.json              # opencode MCP config
├── .gitignore
├── README.md
│
└── packages/
    └── server/                # @proposal-generator/server
        ├── package.json
        ├── tsconfig.json      # extends tsconfig.base.json
        ├── tsdown.config.ts   # build config
        ├── dist/              # build output (gitignored)
        └── src/
            ├── index.ts                   # MCP server + tool definitions
            ├── data/
            │   ├── featureCatalog.ts      # feature -> hours/tech mapping
            │   └── rateCards.ts           # regional rates, base hours, multipliers
            └── logic/
                ├── estimator.ts           # core math: hours, price, timeline, milestones
                └── proposalBuilder.ts     # renders the Markdown proposal document

Publishing to npm

# Login (one-time)
npm login

# Bump version, tag, and publish
bun run release

This runs: bun run build → bumpp (version bump + git tag) → npm publish.