ScopeProfit
Sends approved scope documents as PDF and DOCX email attachments to clients when Brevo is configured.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
Scope-to-Profit
Scope copilot for freelancers and software agencies, exposed as an MCP server. It turns a client's messy idea (loose text, screenshots, "I want something simple but…") into a formal, versioned scope document that any AI agent can drive.
Source of truth:
docs/scope-to-profit.md(product scope v1/v2 and the current MCP-first architecture). MCP setup and tool reference:docs/mcp.md.
What it produces
requirements (functional / non-functional) with a verbatim source quote
blocking questions
risks with a traffic light
scope (included / excluded / assumptions / acceptance criteria)
hour-range estimate (no prices)
next steps
All of it in the fixed template 7.1, exported to Markdown, PDF and editable DOCX.
Related MCP server: ProposalCraft
Architecture (MCP-first)
ChatGPT · Claude · Cursor · Grok bots · custom agents
│ MCP (Streamable HTTP / stdio)
▼
Backend API (NestJS) ── scope tools ── LangGraph agent (optional) ── PostgreSQL + persistent storageMCP server (primary interface) —
POST /api/mcp(Streamable HTTP, stateless) and a stdio entrypoint for local hosts. 20 tools:create_project,add_client_input(text + image URLs),get_tldr,get_scope_document,list_pending_questions,answer_question,update_scope_section,approve_scope,export_document,list_projects,archive_project,get_project,get_conversation,get_input_image,log_change_request,list_change_requests,get_quote,save_quote,export_quote,decide_quote.Auth —
Authorization: Bearerwith a ScopeProfit API key, or OAuth 2.1 (dynamic client registration + PKCE) for ChatGPT-style connectors. Seedocs/mcp.md.Backend API — the only component with database and file-system access. Keeps the versioned Brief (PostgreSQL), renders template 7.1 and the PDF/DOCX artifacts, and runs the optional server-side scope agent.
Landing (
apps/landing) — static marketing page that explains the MCP-first product and how to connect each client. There is no web app anymore: the Next.js client chat (apps/app) was removed; the client conversation now happens in whatever agent uses the MCP server.
Quick start (local)
pnpm install
cp .env.example .env # fill DATABASE_URL, ENCRYPTION_KEY, PUBLIC_API_URL
pnpm --filter @scopeprofit/contracts run build
pnpm run db:migrate
pnpm --filter @scopeprofit/api run build
pnpm --filter @scopeprofit/api run mcp:keys create --email <your-email> --label local
pnpm run dev:api # MCP endpoint at http://localhost:3001/api/mcp
pnpm run dev:landing # landing at http://localhost:3000Then connect a client as described in docs/mcp.md (ChatGPT, Claude, Claude Code, Cursor, OpenAI Responses API, MCP Inspector, raw HTTP).
Self-hosting for ChatGPT
Use the opt-in HTTPS overlay and host-led drafting setup in docs/self-host-chatgpt.md. The MCP/OAuth server already exists; creating a custom ChatGPT connection still requires an eligible account/workspace and a verified live endpoint. A hosted public instance (above) and an official MCP Registry listing are available if you do not want to self-host.
Typical flow
create_project→add_client_inputwith the client's words and image URLs.Either the host LLM drafts the scope with
update_scope_section(every requirement must quote a stored message), or the server agent does it in the background (analyze: true, needs the owner's Gemini key).get_tldr/list_pending_questions→answer_questionuntil nothing blocks the estimate.get_scope_documentto review template 7.1 →approve_scope(locks the reviewed version; approval never emails the client) →export_documentfor a signed download link to share.
For developers (the product)
ScopeProfit is used through an MCP client, not a web UI. You talk to it from ChatGPT, Claude, Cursor, Claude Code or your own agent:
Install it yourself (self-hosted, ~5 minutes, nothing to request): clone the repo, pnpm install, point .env at any PostgreSQL, run the migrations and create your own API key with mcp:keys create — then connect over stdio (mcp:stdio) or local HTTP. Any agent that can run shell commands can do the whole setup from the guide at scopeprofit.vercel.app/docs. ScopeProfit is also listed in the official MCP Registry as io.github.FranprzDev/scopeprofit.
Get an API key from the installation operator:
pnpm --filter @scopeprofit/api run mcp:keys create --email you@example.com --label <client>.Connect your host — per-client recipes (ChatGPT OAuth, Claude connector, Claude Code header, local stdio for Claude Desktop/Cursor) are in docs/mcp.md.
Typical flow:
create_project→add_client_input→ answerlist_pending_questions→ draft withupdate_scope_section→approve_scope→export_document→save_quote→export_quote→decide_quote. Eight-call quickstart and the full error-code table: docs/mcp.md.
There is no client portal and no email delivery: you review the exported PDF/DOCX, share the signed link with your client yourself, and record their answer with decide_quote.
Stack
API: NestJS 11 (Node 22, TypeScript), Prisma 6 + PostgreSQL 17
MCP: xmcp 1.9 (file-based tools, Streamable HTTP + stdio) with the existing OAuth 2.1 authorization server
Agent (optional): LangGraph + LangChain JS with Gemini; clarification gate via Vercel AI Gateway
Documents: structured Brief → Markdown,
pdfkit→ PDF,docx→ DOCXBot: grammY webhook with
secret_tokenQuality: unit, integration, MCP (SDK client over xmcp HTTP) and e2e (HTTP, OAuth, stdio) tests on real PostgreSQL; separate backend and landing CI pipelines
Deploy: Docker Compose with PostgreSQL and persistent volumes
Commands
pnpm --filter @scopeprofit/api run lint
pnpm --filter @scopeprofit/api run typecheck
pnpm --filter @scopeprofit/api run test # unit + integration + mcp + e2e (needs DATABASE_URL)
pnpm --filter @scopeprofit/api run build
pnpm --filter @scopeprofit/api run mcp:stdio # local stdio server (needs SCOPEPROFIT_API_KEY)
pnpm run production:preflightVersion status
v1 — delivered: projects, structured versioned Brief, AI agent, template 7.1, PDF/DOCX, approval and delivery.
v2 — delivered: Brief diff, change-request log and classification, strict domain types.
v3 (pricing, quotes, maintenance) — delivered: quotes and rate cards are MCP tools (
save_quote,get_quote,export_quote,decide_quote); maintenance records stay internal.MCP-first — this release: MCP server, API keys, OAuth for ChatGPT/Claude connectors, signed exports; web app removed, landing rewritten.
Docs
scopeprofit.vercel.app/docs — live developer docs (connect, 20 tools with examples, flow, limits);
/llms.txton the same site for AI agentsdocs/scope-to-profit.md— product concept, scope and architecture (source of truth)docs/mcp.md— MCP tools, auth and client setupdocs/technical-plan.md— original v1 technical plan (historical; the web client it describes was removed)docs/production-launch-checklist.md— production checklist
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for generating rough-draft project plans from natural-language prompts.
A MCP server built for developers enabling Git based project management with project and personal…
B2B, GovCon & LegalTech MCP server for live RFPs, contract parsing, compliance & proposal tools.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn AI-native specification framework that enables deep requirements analysis and structured project planning through intelligent Q\&A workflows. The MCP server provides tools for project initialization, requirement analysis, and the generation of living documentation like development plans and architecture specs.3 npmApache 2.0
- AlicenseBqualityCmaintenanceAn MCP server for freelancers and agencies that drafts client proposals and business emails — quotes, invoices, follow-ups, scope changes, and more — in your own voice, running locally with no API key or cloud.1002MIT
- AlicenseBqualityDmaintenanceAn MCP server that gives LLM agents structured, safe, and traceable access to engineering project documentation stored in Markdown/Git repositories, enabling management of requirements, decisions, tests, tasks, and impact analysis.14MIT
- AlicenseAqualityDmaintenanceAn MCP server that turns a rough project idea into a structured spec, running entirely locally inside any MCP-compatible editor.444 npmMIT