API & MCP

Everything a person can do on Rapport Pipeline Forecast, a program or AI agent can do with the same inputs and get the identical result.

HTTP API

POST https://rapportpipelineforecast.usefulweb.app/api/v1/calculate – run Rapport Pipeline Forecast
GET https://rapportpipelineforecast.usefulweb.app/api/v1/tool – inputs, output schema, examples
OpenAPI 3.1: /openapi.json · /openapi.yaml
Errors: application/problem+json; 422 includes per-field errors.

Rapport Pipeline Forecast

Reads a deals export (Rapport, HubSpot or Pipedrive CSV, or a Rapport CRM file) and computes the open pipeline per stage, the weighted forecast per month by expected close date, overdue deals, win rate by count and value, the average and median sales cycle and the numbers per owner. Same calculation as the Rapport dashboard.

Inputs of Rapport Pipeline Forecast
Field	Type	Default	Description
`deals`	textarea	—	Deals (CSV or Rapport file). Needs a title and a value column; stage, status (open/won/lost), probability, expected close, created, closed and owner columns are used when present.
`dealsFile`	file	—	File (optional). Used instead of the pasted text when given.
`asOf`	date	—	Today is. Deals expected before this day count as overdue; the months start here. Empty = today.
`months`	number	6	Months to forecast
`from`	date	—	Closed from (optional). Win rate and sales cycle count deals closed in this window. Empty = 12 months up to “Today is”.
`to`	date	—	Closed until (optional)
`pipeline`	text	—	Pipeline (optional). Name of one pipeline; empty = all.

Every result contains

inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.

MCP (Model Context Protocol)

Streamable HTTP endpoint: https://rapportpipelineforecast.usefulweb.app/mcp – protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake).
Tools: rapport_pipeline_forecast
Local stdio connector: node src/mcp-stdio.ts --tool=rapport-pipeline-forecast

{
  "mcpServers": {
    "rapport-pipeline-forecast": { "type": "http", "url": "https://rapportpipelineforecast.usefulweb.app/mcp" }
  }
}