# RaiseGate

> Organisation-scoped API and MCP server for the RaiseGate tracker.

- [Quickstart](https://docs.raisegate.com/quickstart.md): The VC workflow end to end: add companies, poll, review signals, triage leads.
- [Authentication](https://docs.raisegate.com/authentication.md): Bearer keys, organisation scoping, and the four scopes.
- [Conventions](https://docs.raisegate.com/conventions.md): IDs, pagination, compact views, fuzzy lookup, sector filters, idempotency, and rate limits.
- [MCP overview](https://docs.raisegate.com/mcp/overview.md): The Partner API as a remote Model Context Protocol server.
- [Connect a client](https://docs.raisegate.com/mcp/connect.md): Claude Code, Cursor, Claude Desktop, and custom agents.
- [Tools](https://docs.raisegate.com/mcp/tools.md): All 15 MCP tools, scopes, rate buckets, and behaviour worth knowing.
- [Building an agent](https://docs.raisegate.com/agents.md): How to build an MCP server or custom agent on this API.
- [Operations](https://docs.raisegate.com/operations.md): Run timing, alert email rules, classification stability, lead quality, and deletion.
- [Error reference](https://docs.raisegate.com/errors.md): HTTP status codes, error codes, and when each is returned.
- [API overview](https://docs.raisegate.com/api/overview.md): How the Partner API relates to the RaiseGate app, and how the resources fit together.
- [Create a tracked company](https://docs.raisegate.com/api-reference/tracker/create-a-tracked-company.md): Saves the company immediately and returns in about 2-3 seconds. Missing LinkedIn/X profiles are found in the background and the first tracker run starts automatically. Send `Idempotency-Key` so retries are safe. Re-adding an already tracked company updates it (`existingEntity: true`) instead of dupl…
- [Enrich a draft before confirmation](https://docs.raisegate.com/api-reference/tracker/enrich-a-draft-before-confirmation.md): Discovers missing company and founder LinkedIn/X profiles without creating anything, and waits for the result (about 15 seconds; up to 4 minutes). Prefer create-then-poll for agents. This call can exceed typical MCP timeouts.
- [List tracked companies](https://docs.raisegate.com/api-reference/tracker/list-tracked-companies.md): Newest-first cursor page of tracked companies. Compact view by default. Filter by status, stage, or natural sector wording.
- [Get a tracked company](https://docs.raisegate.com/api-reference/tracker/get-a-tracked-company.md): Full view by default, plus an `operation` object for polling enrichment and the first run. Enrichment is complete when `operation.enrichmentComplete` is true. The first run has finished when `lastScrapedAt` is set.
- [Update tracking](https://docs.raisegate.com/api-reference/tracker/update-tracking.md): Send only the fields to change. An empty body returns `400`. `status: paused` stops scheduled runs; `status: ok` resumes. Founders you resend keep their enriched data.
- [Stop tracking](https://docs.raisegate.com/api-reference/tracker/stop-tracking.md): Permanently deletes the company and its tracker history (runs, signals, alert logs). If the entity was created from a lead, the lead stays accepted with `trackedEntityId: null`.
- [Refresh now](https://docs.raisegate.com/api-reference/tracker/refresh-now.md): Queues an immediate tracker run. Poll the entity until `lastScrapedAt` differs from `baselineLastScrapedAt` (about 60-90 seconds). Fails if a run is already in progress or the company is paused.
- [List signals](https://docs.raisegate.com/api-reference/signals/list-signals.md): Analysed result of each tracker run. 'No new signals' check-ins (`recommendation: ignore`) are hidden unless `includeNoise=true`. Use `needsAttention=true` for reach-out-worthy developments.
- [Get one signal](https://docs.raisegate.com/api-reference/signals/get-one-signal.md): Full view by default: analysis, reasons, metrics and every evidence item. A signal's ID is the ID of the tracker run that produced it.
- [List alerts](https://docs.raisegate.com/api-reference/alerts/list-alerts.md): Default is emailed alerts (`outcome=sent`), newest first. `latestPerEntity=true` returns the most recent matching alert per company.
- [Get one alert](https://docs.raisegate.com/api-reference/alerts/get-one-alert.md): Full view by default, including rule evaluations and the decision object.
- [List leads](https://docs.raisegate.com/api-reference/leads/list-leads.md): Founders discovered around tracked companies. `decision=unreviewed` is the inbox. A decision applies to every row for the same person.
- [Get one lead](https://docs.raisegate.com/api-reference/leads/get-one-lead.md): Full view by default, including stage rationale, traffic and the decision.
- [Accept a lead and start tracking](https://docs.raisegate.com/api-reference/leads/accept-a-lead-and-start-tracking.md): The API equivalent of Track in the UI. Requires `leads:write` and `tracker:write`. The lead supplies identity; you supply tracking settings. Poll `operation.pollUrl` as for create.
- [Accept or reject a lead](https://docs.raisegate.com/api-reference/leads/accept-or-reject-a-lead.md): `{ "accepted": true }` only records acceptance. Use `/track` to accept and start tracking. A new decision replaces the previous one. Shared with the RaiseGate UI.

## OpenAPI Specs

- [openapi](/openapi.json)