{
  "info": {
    "name": "Better Proposals — mcp.ai",
    "description": "REST API for the Better Proposals MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/better_proposals",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "better_proposals_create_company",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/company",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "company"
          ]
        },
        "description": "Tool to create a new company. Use after confirming the company does not already exist.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"CompanyName\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "better_proposals_create_document_type",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/document/type",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "document",
            "type"
          ]
        },
        "description": "Tool to create a new document type. Use after confirming the desired type name does not already exist.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"TypeName\": \"\",\n  \"TypeColour\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "better_proposals_create_proposal_cover",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/proposal/cover",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "proposal",
            "cover"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"BrandID\": 0,\n  \"BGColour\": \"\",\n  \"Headline\": \"\",\n  \"CoverName\": \"\",\n  \"Subheader\": \"\",\n  \"TextAlign\": \"\",\n  \"ButtonText\": \"\",\n  \"TextColour\": \"\",\n  \"ButtonStyle\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "better_proposals_get_all_companies",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/all/companies",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "all",
            "companies"
          ]
        },
        "description": "Tool to retrieve a paginated list of all companies. Use when listing available companies for display or selection.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"per_page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "better_proposals_get_all_currencies",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/all/currencies",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "all",
            "currencies"
          ]
        },
        "description": "Tool to retrieve a paginated list of all currencies. Use when listing available currency options before selection.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"per_page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "better_proposals_get_all_document_types",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/all/document/types",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "all",
            "document",
            "types"
          ]
        },
        "description": "Tool to retrieve a paginated list of all document types. Use when you need to display or select a document type ID.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"per_page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "better_proposals_get_all_proposals",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/all/proposals",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "all",
            "proposals"
          ]
        },
        "description": "Tool to retrieve a paginated list of all proposals. Use when you need to fetch proposals list after validating credentials.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"type\": 0,\n  \"per_page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "better_proposals_get_all_quotes",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/all/quotes",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "all",
            "quotes"
          ]
        },
        "description": "Tool to retrieve a paginated list of all quotes. Use after setting pagination parameters.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"per_page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "better_proposals_get_all_templates",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/all/templates",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "all",
            "templates"
          ]
        },
        "description": "Tool to retrieve a paginated list of all templates. Use when you need to list available templates for selection.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"per_page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "better_proposals_get_brand_settings",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/brand/settings",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "brand",
            "settings"
          ]
        },
        "description": "Tool to retrieve settings for the default brand. Use when you need default-brand configuration (colors, tax, name, etc.) before creating or customizing documents.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "better_proposals_get_company",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/company",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "company"
          ]
        },
        "description": "Tool to retrieve details of a specific company. Use when you need company metadata by ID.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"company_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "better_proposals_get_currency",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/currency",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "currency"
          ]
        },
        "description": "Tool to retrieve details of a specific currency. Use when you need currency metadata by ID.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"currency_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "better_proposals_get_new_proposals",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/new/proposals",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "new",
            "proposals"
          ]
        },
        "description": "Tool to retrieve all new proposals. Use after validating credentials when you need only newly created proposals.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"type\": 0,\n  \"per_page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "better_proposals_get_opened_proposals",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/opened/proposals",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "opened",
            "proposals"
          ]
        },
        "description": "Tool to retrieve all opened proposals. Use when you need proposals that recipients have opened.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"type\": 0,\n  \"per_page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "better_proposals_get_paid_proposals",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/paid/proposals",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "paid",
            "proposals"
          ]
        },
        "description": "Tool to retrieve all paid proposals. Use when you need to list proposals that have been paid.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"type\": 0,\n  \"per_page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "better_proposals_get_proposal",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/proposal",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "proposal"
          ]
        },
        "description": "Tool to retrieve details of a specific proposal by ID. Use when you need complete proposal metadata and content.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"proposal_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "better_proposals_get_proposal_count",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/proposal/count",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "proposal",
            "count"
          ]
        },
        "description": "Tool to retrieve the total count of proposals. Use when you need to know how many proposals exist.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "better_proposals_get_quote",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/quote",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "quote"
          ]
        },
        "description": "Tool to retrieve details of a specific quote. Use when you need full quote data by ID.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"quote_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "better_proposals_get_sent_proposals",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/sent/proposals",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "sent",
            "proposals"
          ]
        },
        "description": "Tool to retrieve all sent proposals. Use after dispatching proposals to clients to list them.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"type\": 0,\n  \"per_page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "better_proposals_get_settings",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/settings",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "settings"
          ]
        },
        "description": "Tool to retrieve current account settings. Use when you need default currency, tax, and timezone configuration before creating proposals.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "better_proposals_get_signed_proposals",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/signed/proposals",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "signed",
            "proposals"
          ]
        },
        "description": "Tool to retrieve all signed proposals. Use when you need to list proposals clients have signed after confirming credentials.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"type\": 0,\n  \"per_page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "better_proposals_get_template",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/template",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "template"
          ]
        },
        "description": "Tool to retrieve details of a specific template. Use after selecting the template ID to fetch metadata.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"template_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "better_proposals_list_merge_tags",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/merge/tags",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "merge",
            "tags"
          ]
        },
        "description": "Tool to retrieve custom merge tags with pagination support. Use when you need to list available merge tags for templates.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"per_page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}