# ProposalPilot MCP Server
An MCP (Model Context Protocol) server that generates professional freelance project proposals using AI.
## Features
- **AI-Powered Proposals**: Uses Claude to generate compelling, tailored proposals
- **Complete Proposal Structure**: Executive summary, scope, timeline, pricing, and terms
- **Customizable Tone**: Professional, confident, or friendly writing styles
- **MCP Compatible**: Works with any MCP-compatible client (Claude Desktop, etc.)
## Installation
```bash
cd mcp-servers/proposalpilot-mcp
npm install
npm run build
```
## Configuration
Set your Anthropic API key:
```bash
export ANTHROPIC_API_KEY=your-key-here
```
### Claude Desktop
Add to your Claude Desktop config (`~/.config/claude-desktop/config.json` or `~/Library/Application Support/Claude/claude_desktop_config.json`):
```json
{
"mcpServers": {
"proposalpilot": {
"command": "node",
"args": ["/path/to/mcp-servers/proposalpilot-mcp/dist/index.js"],
"env": {
"ANTHROPIC_API_KEY": "your-key-here"
}
}
}
}
```
## Tool: `generate_proposal`
Generates a professional freelance project proposal.
### Required Inputs
| Parameter | Type | Description |
|-----------|------|-------------|
| `project_description` | string | Detailed description of the project requirements (min 10 chars) |
| `client_name` | string | Name of the client or company |
| `budget` | string | Budget info (e.g., "$100/hr", "$5000 fixed", "$3000-5000") |
| `timeline` | string | Desired timeline (e.g., "2 weeks", "by March 15") |
### Optional Inputs
| Parameter | Type | Description |
|-----------|------|-------------|
| `tone` | string | Writing tone: "professional", "confident", or "friendly" |
| `services` | string | Freelancer's services/skills to highlight |
### Example
```json
{
"name": "generate_proposal",
"arguments": {
"project_description": "Build a modern e-commerce website with React frontend and Node.js backend. Need product catalog, shopping cart, checkout with Stripe, and admin dashboard.",
"client_name": "TechStartup Inc",
"budget": "$8,000 - $12,000",
"timeline": "6 weeks",
"tone": "professional",
"services": "Full-stack web development, React, Node.js, PostgreSQL"
}
}
```
### Output
Returns a complete proposal with:
1. **Executive Summary** - Project understanding and fit
2. **Scope of Work** - Detailed deliverables breakdown
3. **Timeline** - Milestones and schedule
4. **Pricing** - Cost breakdown based on budget
5. **Terms & Conditions** - Payment and revision policies
## Development
```bash
# Run in development mode
npm run dev
# Build
npm run build
# Test
npm test
```
## Testing
The test script validates server startup, tool listing, and (if ANTHROPIC_API_KEY is set) proposal generation:
```bash
npm run build
npm test
```
## License
MIT
