MCP Freelance Proposal

A stdio MCP server that helps freelancers turn project briefs into proposal-ready material using either OpenAI or Anthropic.

Tools

• generate_freelance_proposal: drafts a full client-ready proposal.
• create_scope_of_work: creates scope, deliverables, acceptance criteria, assumptions, and change control.
• draft_discovery_questions: generates grouped questions to clarify a project before pricing.
• analyze_project_brief: summarizes goals, deliverables, risks, ambiguities, and positioning angles.

Requirements

• Node.js 20.11 or newer
• One or both API keys exported in the MCP host environment:
  • OPENAI_API_KEY
  • ANTHROPIC_API_KEY

No API key is created by this project. It only reads environment variables.

Install

npm install
npm run build

Run Locally

OPENAI_API_KEY=your_key_here npm run dev

On PowerShell:

$env:OPENAI_API_KEY="your_key_here"
npm run dev

Use Anthropic instead:

$env:ANTHROPIC_API_KEY="your_key_here"
$env:FREELANCE_PROPOSAL_PROVIDER="anthropic"
npm run dev

CLI

The package also includes a local helper CLI. It defaults to starting the MCP server.

npm run cli -- reputation "Acme Co"
npm run cli -- portfolio list
npm run cli -- generate --brief "Client needs a new lead-generation website" --client "Acme Co" --title "Website Redesign"

The generate command uses OPENAI_API_KEY or ANTHROPIC_API_KEY just like the MCP tools.

MCP Client Configuration

After building, point your MCP client at the compiled server.

{
  "mcpServers": {
    "freelance-proposal": {
      "command": "node",
      "args": ["C:/Projects/mcp-freelance-proposal/dist/index.js"],
      "env": {
        "OPENAI_API_KEY": "${OPENAI_API_KEY}",
        "ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}",
        "FREELANCE_PROPOSAL_PROVIDER": "auto"
      }
    }
  }
}

FREELANCE_PROPOSAL_PROVIDER can be auto, openai, or anthropic. In auto mode, OpenAI is used when OPENAI_API_KEY is present; otherwise Anthropic is used when ANTHROPIC_API_KEY is present.

Optional Model Overrides

Environment defaults:

OPENAI_MODEL=gpt-5.2
ANTHROPIC_MODEL=claude-sonnet-4-5

Each tool also accepts a provider and model field, so callers can override the provider or model per request.

Development

npm run typecheck
npm test
npm run build

Tests use fake providers and do not call external APIs.