Browse the docs

Resources

Changelog

Changes to the Alertedly MCP server and REST API.

2026-10-08

MCP server 3.0.0

New

  • 16 tools. New: get_company_brief, get_signals, rank_companies, get_company_changes, get_competitor_radar, get_trademarks, get_coverage.
  • Firm scope: members who sign in, or use a personal key, see their firm's portfolio and dealflow. Optional org argument on every tool for people in several firms.
  • Roles: any member can add to dealflow; adding to portfolio needs a firm admin.
  • Every tool returns structured data with a declared output schema, alongside the text answer.
  • Signals and events include source links.
  • MCP prompts weekly_portfolio_digest, competitor_brief, partner_update; resources alertedly://channels and alertedly://guide.

Changed

  • Rate limits: 60 requests/minute per person plus 600/minute per firm.
  • Every tool call is written to the audit log; firm admins can review it in Team settings.
  • Web content in answers is sanitized and returned in labelled blocks, to be treated as data.
  • Answers are shorter by default; detail: "full" returns the whole report.
  • Free reports: usually minutes, seconds if the company was already researched this week.
  • get_company_intelligence, get_events, get_portfolio_events, compare_companies and get_competitors keep their arguments and now read the weekly data first.

Removed

  • The old v2 server endpoint is retired. Use https://mcp.alertedly.com.

2026-10-08

REST API 1.6.0

New

  • Key scopes: read for GET, write for POST, PUT, PATCH and DELETE. Missing scope returns 403 INSUFFICIENT_SCOPE.
  • Key expiry: expired keys return 401.
  • ?org= on every endpoint for people in several firms.
  • Every request is written to the usage log.

Changed

  • Report endpoints (/reports, /reports/{id}, /companies/{id}/latest-report, /voice-summary/{report_id}) return only your account's or your firm's reports.
  • VC endpoints /signals, /metrics, /leaderboard and /digest are documented. See the API reference.

Earlier

  • API 1.5: VC endpoints (/signals, /metrics, /leaderboard, /digest) and portfolio bulk endpoints.
  • API 1.4: /usage and /voice-summary.
  • API 1.2: events.