# Better Proposals — MCP server on mcp.ai
> Connect your Better Proposals account and use 23 tools for proposals and invoices straight from your AI agent. Connect with your own API key. Better Proposals is a web-based proposal creation tool that enables users to send professionally designed proposals.

By: mcp.ai · official
Page: https://mcp.ai/better_proposals

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_better_proposals?ms=1787291400000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/better_proposals/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/better_proposals/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/better_proposals/skill.md
Postman collection (v2.1): https://mcp.ai/better_proposals/postman.json

## Tools
- better_proposals_create_company(CompanyName: string) — Tool to create a new company. Use after confirming the company does not already exist.
- better_proposals_create_document_type(TypeName: string, TypeColour?: string) — Tool to create a new document type. Use after confirming the desired type name does not already exist.
- better_proposals_create_proposal_cover(BrandID?: integer, BGColour?: string, Headline?: string, CoverName?: string, Subheader?: string, TextAlign?: string, ButtonText?: string, TextColour?: string, ButtonStyle?: string) — Tool to create a new proposal cover design. Use when you need a custom cover design before sending out a proposal. Use after finalizing cover settings.
- better_proposals_get_all_companies(page?: integer, per_page?: integer) — Tool to retrieve a paginated list of all companies. Use when listing available companies for display or selection.
- better_proposals_get_all_currencies(page?: integer, per_page?: integer) — Tool to retrieve a paginated list of all currencies. Use when listing available currency options before selection.
- better_proposals_get_all_document_types(page?: integer, per_page?: integer) — Tool to retrieve a paginated list of all document types. Use when you need to display or select a document type ID.
- better_proposals_get_all_proposals(page?: integer, type?: integer, per_page?: integer) — Tool to retrieve a paginated list of all proposals. Use when you need to fetch proposals list after validating credentials.
- better_proposals_get_all_quotes(page?: integer, per_page?: integer) — Tool to retrieve a paginated list of all quotes. Use after setting pagination parameters.
- better_proposals_get_all_templates(page?: integer, per_page?: integer) — Tool to retrieve a paginated list of all templates. Use when you need to list available templates for selection.
- better_proposals_get_brand_settings() — Tool to retrieve settings for the default brand. Use when you need default-brand configuration (colors, tax, name, etc.) before creating or customizing documents.
- better_proposals_get_company(company_id: string) — Tool to retrieve details of a specific company. Use when you need company metadata by ID.
- better_proposals_get_currency(currency_id: string) — Tool to retrieve details of a specific currency. Use when you need currency metadata by ID.
- better_proposals_get_new_proposals(page?: integer, type?: integer, per_page?: integer) — Tool to retrieve all new proposals. Use after validating credentials when you need only newly created proposals.
- better_proposals_get_opened_proposals(page?: integer, type?: integer, per_page?: integer) — Tool to retrieve all opened proposals. Use when you need proposals that recipients have opened.
- better_proposals_get_paid_proposals(page?: integer, type?: integer, per_page?: integer) — Tool to retrieve all paid proposals. Use when you need to list proposals that have been paid.
- better_proposals_get_proposal(proposal_id: string) — Tool to retrieve details of a specific proposal by ID. Use when you need complete proposal metadata and content.
- better_proposals_get_proposal_count() — Tool to retrieve the total count of proposals. Use when you need to know how many proposals exist.
- better_proposals_get_quote(quote_id: string) — Tool to retrieve details of a specific quote. Use when you need full quote data by ID.
- better_proposals_get_sent_proposals(page?: integer, type?: integer, per_page?: integer) — Tool to retrieve all sent proposals. Use after dispatching proposals to clients to list them.
- better_proposals_get_settings() — Tool to retrieve current account settings. Use when you need default currency, tax, and timezone configuration before creating proposals.
- better_proposals_get_signed_proposals(page?: integer, type?: integer, per_page?: integer) — Tool to retrieve all signed proposals. Use when you need to list proposals clients have signed after confirming credentials.
- better_proposals_get_template(template_id: string) — Tool to retrieve details of a specific template. Use after selecting the template ID to fetch metadata.
- better_proposals_list_merge_tags(page?: integer, per_page?: integer) — Tool to retrieve custom merge tags with pagination support. Use when you need to list available merge tags for templates.

## Example prompts
- "What can I do in Better Proposals?"
- "Show me a summary of my Better Proposals account"

## Links
Docs: https://mcp.ai/docs/mcps/better_proposals
Website: https://mcp.ai/mcps/better_proposals