Alertedly
MCP server · v3.9.0

Competitive intelligence, inside your AI assistant.

Connect Alertedly to Claude, ChatGPT, Cursor, Microsoft Copilot, VS Code, Meta Muse or any MCP client, and ask about your competitors, portfolio and dealflow in plain English. Alertedly researches every company you track across 16 channels, every week. Your assistant can pull, rank and compare all of it, with sources.

Connect in 60 seconds

Or start with a free report, right from your assistant.

ClaudeChatGPTCursorCodexVS CodeMeta MuseMicrosoft Copilot and any MCP client
Claude Alertedly connectedExample

Give me a one-page brief on Northwind for this week's partner meeting.

Used alertedly · get_company_brief

Northwind is staffing up enterprise sales ahead of a pricing change.

What changed

  • 9 new sales roles, 2 of them leadership Careers
  • New Enterprise tier on the pricing page Website changes

What to watch

Whether the Enterprise tier is announced publicly.

Highpricing_changenorthwind.example/pricing
DocsMCP server overview
On this page

What you can do

Weekly briefs
A short brief per company: what changed, what to watch, top signals with source links.
Signals across your list
Raises, launches, pricing changes, hiring sprees and slowdowns, leadership changes, filtered by week, type and severity.
Rankings and changes
Rank companies on any weekly metric and see what changed between two weeks.
Competitor radar
Known competitors plus new entrants starting to make noise in a category.
Head-to-head comparisons
Hiring, launches, social and ads activity side by side, week over week.
Built for firms
Per-person sign-in, firm-wide scope, roles, limits and an audit log.

Connect

Server URL (streamable HTTP):

MCP server URL
https://mcp.alertedly.com

https://mcp.alertedly.com/mcp also works, for existing setups.

  • Method
    Sign in with Alertedly (OAuth)
    Use it for
    Everyone. Recommended.
    How
    Add the URL in your client, then sign in with your own Alertedly account. Each person signs in as themselves, with no key to copy or share. New users can create a free account during sign-in.
  • Method
    API key
    Use it for
    Scripts, CI and automations
    How
    Send X-API-Key: YOUR_KEY or Authorization: Bearer YOUR_KEY. Personal keys live in the dashboard; firm admins create organization keys in Team settings. Prefer read-only keys.

Quickstart

Pick your client. Each takes about a minute. More detail and checks are in the full quickstart.

For
Claude.ai and Claude Desktop, individual plans
Auth
Sign in (OAuth)
  1. Open Settings → Connectors and choose Add custom connector.
  2. Name it Alertedly and enter the URL https://mcp.alertedly.com.
  3. Click Connect, sign in with your Alertedly account and approve.
  4. In a chat, enable Alertedly from the tools menu and ask: “What happened across my tracked companies this week?”

If you used the old mcp-remote bridge in your Claude Desktop config file, remove that entry; the connector replaces it.

For
Organization owners on Claude Team or Enterprise
Auth
Sign in (OAuth), per member
  1. An owner opens the organization's connector settings (Settings → Connectors, under organization connectors) and adds a custom connector named Alertedly with URL https://mcp.alertedly.com. This is done once for the whole organization.
  2. Each member then opens their own Settings → Connectors, finds Alertedly, clicks Connect and signs in with their own Alertedly account.
  3. Members of a firm on Alertedly automatically see the firm's portfolio and dealflow. Nothing is configured per person.
For
ChatGPT plans that allow custom connectors
Auth
Sign in (OAuth)
  1. Open Settings → Connectors (called Apps & Connectors in some versions).
  2. If your plan requires it, turn on Developer mode in the advanced connector settings.
  3. Create a connector with URL https://mcp.alertedly.com and OAuth authentication.
  4. Sign in with your Alertedly account and approve. Add Alertedly to a chat from the tools menu.
For
Workspace admins on ChatGPT Business or Enterprise
Auth
Sign in (OAuth), per member
  1. A workspace admin opens the workspace's connector settings and adds a custom connector with URL https://mcp.alertedly.com and OAuth authentication.
  2. The admin enables or publishes the connector for the workspace (or for specific groups, if your workspace uses them).
  3. Each member connects Alertedly and signs in with their own Alertedly account.
For
Claude Code CLI
Auth
Sign in, or API key for headless use

With sign-in (no key):

terminal
claude mcp add --transport http alertedly https://mcp.alertedly.com

Start a session, run /mcp, choose Alertedly and sign in in the browser. /mcp then lists the Alertedly tools: 33 on a personal account, 83 for a firm.

With an API key (CI, scripts, remote machines without a browser):

terminal
claude mcp add --transport http alertedly https://mcp.alertedly.com \
  --header "X-API-Key: YOUR_ALERTEDLY_API_KEY"
For
Cursor editor
Auth
Sign in, or API key

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). With sign-in, give only the URL; Cursor asks you to sign in when it connects:

~/.cursor/mcp.json
{
  "mcpServers": {
    "alertedly": {
      "url": "https://mcp.alertedly.com"
    }
  }
}

With an API key:

~/.cursor/mcp.json
{
  "mcpServers": {
    "alertedly": {
      "url": "https://mcp.alertedly.com",
      "headers": { "X-API-Key": "YOUR_ALERTEDLY_API_KEY" }
    }
  }
}

Save, then open Cursor Settings → MCP. Alertedly should show 33 tools on a personal account, 83 for a firm.

For
Codex CLI and IDE extension
Auth
Sign in, or API key

With sign-in, on recent versions:

terminal
codex mcp add alertedly --url https://mcp.alertedly.com
codex mcp login alertedly

With an API key, add to ~/.codex/config.toml (or .codex/config.toml in a trusted project) and export the key before launching Codex:

~/.codex/config.toml
[mcp_servers.alertedly]
url = "https://mcp.alertedly.com"
bearer_token_env_var = "ALERTEDLY_API_KEY"
terminal
export ALERTEDLY_API_KEY="YOUR_ALERTEDLY_API_KEY"

Alternative using the explicit header instead of a bearer token:

~/.codex/config.toml
[mcp_servers.alertedly]
url = "https://mcp.alertedly.com"
env_http_headers = { "X-API-Key" = "ALERTEDLY_API_KEY" }

Run /mcp inside Codex to verify. If the server isn't detected on an older build, update Codex or enable the streamable-HTTP client (experimental_use_rmcp_client = true).

For
Copilot Studio makers and Microsoft 365 admins
Auth
Sign in where supported; read-only org key for shared automations

A maker or admin in your tenant adds Alertedly as a custom MCP connector:

  • Transport: Streamable HTTP
  • Endpoint: https://mcp.alertedly.com
  • Authentication, recommended: OAuth, where your Copilot setup supports it, so each person signs in with their own Alertedly account.
  • Authentication, shared automations: API key in header X-API-Key. Use an organization key created by a firm admin in Team settings, with read-only scope.
For
VS Code with GitHub Copilot agent mode
Auth
Sign in, or API key

Add to .vscode/mcp.json in your workspace, or run MCP: Add Server from the Command Palette. With sign-in, VS Code asks you to sign in when the server starts:

.vscode/mcp.json
{
  "servers": {
    "alertedly": {
      "type": "http",
      "url": "https://mcp.alertedly.com"
    }
  }
}

With an API key, prompted once and stored by VS Code:

.vscode/mcp.json
{
  "inputs": [
    { "type": "promptString", "id": "alertedly-key", "description": "Alertedly API key", "password": true }
  ],
  "servers": {
    "alertedly": {
      "type": "http",
      "url": "https://mcp.alertedly.com",
      "headers": { "X-API-Key": "${input:alertedly-key}" }
    }
  }
}
For
Meta Muse
Auth
Sign in (OAuth)

Add https://mcp.alertedly.com as a connector and sign in with your Alertedly account. Once Alertedly is listed in the Muse connector directory, you can also connect from its listing.

What can I ask?

Investors

  • “What happened across our portfolio this week? Highest severity first.”

    get_signals

  • “Draft this week's partner update: top moves per portfolio company, with sources.”

    get_signalsget_company_brief

  • “Give me a one-page brief on Vercel for this week's partner meeting.”

    get_company_brief

  • “Which dealflow companies raised money or launched something in the last two weeks?”

    get_signals

All VC prompts and the firm rollout guide

Startups

  • “Give me a competitor brief on Linear: what changed this week and what should we watch?”

    get_company_brief

  • “Compare Notion and Coda head to head on hiring and shipped features.”

    compare_companies

  • “Who are the new entrants in Vercel's category?”

    get_competitor_radar

  • “Which competitor is running the most Meta ads right now?”

    rank_companies

All startup prompts

Start with a free report

Ask your assistant: “Get me a free competitor report on Notion, notion.so.” It usually takes a few minutes, and only seconds if Alertedly already researched that company this week. The report is emailed to you, and you can ask “show my Alertedly report” to read and discuss it in chat. The free report tools work on any Alertedly account, including free accounts. One free report per account.

To get this every week for every competitor, start tracking.

Tools

83 tools. Every tool returns readable text and structured data with a declared output schema. See the tools reference for arguments, example prompts and responses.

  • Type
    read
    What it does
    Your tracked companies, with last report week and data freshness.
  • Type
    read
    What it does
    A short brief: headline, the developments, what to watch, recommendations, top signals with sources, key metrics. Investor briefs add what changed since last week (computed from stored numbers: each channel number last week and this week, new and continuing developments, signals by severity), Alertedly's take (our labeled read, with what would confirm it) and coverage (when researched, channels with data, items read).
  • Type
    read
    What it does
    The full report, or one channel, from the latest or a past report.
  • Type
    read
    What it does
    Signals grouped by company, each with source links. The main tool for weekly questions.
  • Type
    read
    What it does
    Events and alerts for one company over a number of days, with source links.
  • Type
    read
    What it does
    Events across every tracked company in one call, with source links.
  • Type
    read
    What it does
    Rank companies on one weekly metric, with the change versus N weeks ago.
  • Type
    read
    What it does
    Two companies side by side, or one company across two dates. Weekly metrics first, week over week.
  • Type
    read
    What it does
    Metric changes and the signals between two weeks.
  • Type
    read
    What it does
    New entrants making noise in the company's category, plus known competitors.
  • Type
    read
    What it does
    Suggested competitors, known relationships and radar mentions.
  • Type
    read
    What it does
    USPTO trademark filings and a summary.
  • Type
    read
    What it does
    Ads a company runs in the ad libraries (Meta; Google and LinkedIn where available) over the latest weekly report window (7 days): per platform the status, ad counts by freshness (newly launched, newly observed, existing), how much of the library was read, the weekly summary and the creatives, each with its ad library link.
  • Type
    read
    What it does
    Customer reviews on G2 and Trustpilot, where available, published in the latest weekly report window (7 days): per site the count and average of the week's reviews (a sample, never the site's official rating; the two sites are never blended), coverage, the weekly summary of praise and complaints, the reviews themselves with links, and review signals.
  • Type
    read
    What it does
    Per company: last weekly run, status, and whether data is stale (older than 8 days) or missing.
  • Type
    write
    What it does
    Start weekly tracking of a company.
  • Type
    write
    What it does
    Stop tracking a company. Shows a preview first; removes only after you confirm.
  • Type
    write
    What it does
    Move a firm company from dealflow to portfolio, or back.
  • Type
    write
    What it does
    Replace the firm's notes on a company (board dates, round, owner).
  • Type
    read
    What it does
    Who moved most this week, and who went quiet.
  • Type
    read
    What it does
    One company week by week over a period: signals, metric changes, reports.
  • Type
    read
    What it does
    Your archived reports, one per company and date, with audio flags.
  • Type
    read
    What it does
    Read one archived report as text, with its audio summary link.
  • Type
    read
    What it does
    Your plan, companies tracked vs allowed, channels, limits and permissions.
  • Type
    read
    What it does
    Firm members and roles, and pending invites.
  • Type
    write
    What it does
    Queue a free one-time report on any company. One per account, signed in with a work email.
  • Type
    read
    What it does
    Check progress, or read the finished free report in chat.
  • Type
    write
    What it does
    Admins: invite up to 500 people (role analyst or admin, optional name) and email each an invite link, as Team & access does. Seats, members and pending invites are checked; an invite whose email didn't go out comes back with its link.
  • Type
    write
    What it does
    Admins: withdraw a pending invite; its link stops working.
  • Type
    write
    What it does
    Admins: email an invite again with a new link valid for 7 days.
  • Type
    write
    What it does
    Admins: make a member an admin or an analyst; a firm always keeps one admin.
  • Type
    write
    What it does
    Admins: remove someone from the firm; their firm API keys are revoked and the invites they sent withdrawn. The preview lists what goes.
  • Type
    write
    What it does
    Leave the firm yourself (never its last admin).
  • Type
    read
    What it does
    What removing a member would revoke: firm API keys, invites they sent, personal alert rules, share links.
  • Type
    read
    What it does
    Momentum 0-100 per company with flags, drivers and why it needs attention. Companies still building a baseline are listed separately, never ranked.
  • Type
    read
    What it does
    A month, quarter or year in numbers: signals, raises, launches, risers and drops, champions, gone quiet, dealflow heating up, coming up.
  • Type
    read
    What it does
    The firm's weekly round-up, as emailed Monday mornings: portfolio (needs attention, wins to amplify), dealflow (heating up, cooling) or the combined firm report, each item with a next step and sources.
  • Type
    read
    What it does
    The weeks with a weekly round-up, newest first, and which kinds each has.
  • Type
    read
    What it does
    A company's momentum score week by week, up to a year.
  • Type
    read
    What it does
    The months, quarters and years with reports, which is current and which has data.
  • Type
    read
    What it does
    Home's "Act on this week": the latest critical and high signals, each with why it needs attention and its triage.
  • Type
    read
    What it does
    The Month, Quarter or Year in Review as story cards (biggest moment, top riser, champions, competitor of the period and more).
  • Type
    read
    What it does
    What Alertedly covered: research checks, signals by severity, signals caught before the press, your firm's activity.
  • Type
    read
    What it does
    Open roles across portfolio companies, filterable by function, location, company and posting date.
  • Type
    read
    What it does
    Board prep for one company: what changed since the last board meeting, competitor moves, activity, silence, momentum and founder questions, with sources. Includes Alertedly's saved summary when one exists; never writes a new one.
  • Type
    read
    What it does
    The firm's LP-update highlights for a period: the saved draft (dashboard edits win), or written once for the firm and saved. Negatives are left out unless asked for.
  • Type
    read
    What it does
    A short note to a founder about a signal (check-in, congrats, competitor heads-up, intro offer): the saved draft or a template, plus the facts. Placeholders stay as {{founder_first_name}} and {{sender_first_name}}.
  • Type
    write
    What it does
    Set a company's owner, stage, next and last board meeting, tags, fund or jobs-board visibility.
  • Type
    write
    What it does
    Review a signal (the dashboard's Review button; the tool keeps the name triage): mark it acted on, check in, watching or ignore (or clear), assign it and add a note.
  • Type
    write
    What it does
    Add a private note on a company, optionally about one signal.
  • Type
    write
    What it does
    Delete one of the firm's notes (its author or an admin).
  • Type
    write
    What it does
    Save your edits to the firm's LP highlights draft for a period, clear them, or take or dismiss a newer draft waiting behind them.
  • Type
    read
    What it does
    Critical and high signals still to review in the latest four weeks (To review in the dashboard), and how many are assigned to you.
  • Type
    read
    What it does
    Who reviewed a company's signals, when, to what, with notes (the company page's Decisions).
  • Type
    read
    What it does
    The firm's private notes on a company. Notes appear only here, never in other tools, shares, emails or drafts.
  • Type
    write
    What it does
    A read-only link (alertedly.com/s/…) to a frozen board pack, review, LP highlights, brief, value report or digest. Asking again returns the same live link.
  • Type
    read
    What it does
    The firm's shared links with views, expiry and state.
  • Type
    write
    What it does
    Turn off a shared link (its creator or an admin).
  • Type
    write
    What it does
    Add up to 200 companies at once. Dry run by default; adding needs dry_run false and confirm.
  • Type
    write
    What it does
    Add a note with a company's recent public signals to your CRM (Attio, HubSpot or Notion). Notes and triage never leave Alertedly.
  • Type
    read
    What it does
    What Alertedly sent to your CRM (Attio, HubSpot or Notion), newest first: notes added, companies skipped and failed sends, each with what fixes it.
  • Type
    read
    What it does
    Which tracked companies your CRM finds (by exact website, or the record matched by hand), and which ones automatic sync would skip until they're matched. Changes nothing.
  • Type
    write
    What it does
    Pick which CRM record a company's notes go to when its website finds none or several, or add the company to the CRM as a new record.
  • Type
    write
    What it does
    Create (or, with rule_id, change) an alert rule: signal types and minimum severity, or momentum flags, for a lens, companies or tags.
  • Type
    read
    What it does
    Firm alert rules and your own, with what each watches and where it sends.
  • Type
    write
    What it does
    Delete an alert rule (the firm default rule is turned off instead).
  • Type
    read
    What it does
    Recent alerts sent: rule, signal or flag, channel, recipient and status.
  • Type
    read
    What it does
    Slack, webhook and CRM (Attio, HubSpot or Notion) status, whether alert and digest delivery is live, and the jobs board. Never returns secrets.
  • Type
    write
    What it does
    Your own email settings: digest for all companies or only yours, review emails, alert emails.
  • Type
    read
    What it does
    Whether the public portfolio jobs board is published, its address and hidden companies.
  • Type
    write
    What it does
    Admins: publish the portfolio jobs board, set its address and title.
  • Type
    read
    What it does
    Your own email settings: the Portfolio and Dealflow round-ups, digest scope, reviews, alerts and board-pack reminders.
  • Type
    write
    What it does
    Admins: change the firm's name everywhere it shows (the jobs board address stays).
  • Type
    write
    What it does
    Admins: rename an integration, or pause or resume it. Secrets and addresses are entered on the site or over REST, never through an assistant.
  • Type
    write
    What it does
    Admins: remove an integration and its stored secret.
  • Type
    read
    What it does
    Admins: the firm's API keys (name, last four characters, scopes, creator, last use); never a key. Keys are created on the site only.
  • Type
    write
    What it does
    Admins: revoke one of the firm's API keys at once.
  • Type
    read
    What it does
    Admins: read the firm's own website and list the companies its portfolio page links to (name, website, logo, and whether the firm already tracks each). It only finds: import the ones the user confirms with import_companies. Usually answers within seconds; a slow site answers scan_status running with a scan_id for get_portfolio_site_scan. 10 reads an hour per firm.
  • Type
    read
    What it does
    The result of a find_portfolio_on_site that was still reading (scan_status running): the companies found once the scan is done, or running again.
  • Type
    read
    What it does
    The firm's settings as the dashboard shows them: time zone, alert quiet hours, whether only admins may create share links, and the jobs board (published, address, title).
  • Type
    read
    What it does
    Calls to Alertedly over MCP and the REST API in the last 1 to 90 days (default 30), newest first: who, which key, which tool or endpoint, status and response time. Admins see everyone's calls and a per-member summary; members see their own.
  • Type
    write
    What it does
    Admins: limit share links to admins, quiet hours and time zone (get_firm_settings reads them).
  • Type
    read
    What it does
    Your Alertedly dashboard, right inside the chat.

Channels

Alertedly collects 16 channels for every tracked company, every week. Careers, Meta ads, Google ads, LinkedIn ads, Reddit, reviews (G2 and Trustpilot) and trademarks are part of Pro and VC plans; on other plans those channels and their signals are hidden.

  • Channel
    Press and news
    Key
    press
    What's tracked
    Press releases, media coverage, funding and partnership news
    Plan
    All plans
  • Channel
    Website and blog
    Key
    website_blog
    What's tracked
    New blog posts and content themes
    Plan
    All plans
  • Channel
    Changelog
    Key
    changelog
    What's tracked
    Feature releases and product updates
    Plan
    All plans
  • Channel
    Website changes
    Key
    website_screenshot
    What's tracked
    Homepage and pricing page changes, messaging shifts
    Plan
    All plans
  • Channel
    Careers
    Key
    careers
    What's tracked
    Open, new and removed roles; leadership, engineering and sales hiring
    Plan
    Pro and VC
  • Channel
    LinkedIn
    Key
    linkedin
    What's tracked
    Posts and engagement
    Plan
    All plans
  • Channel
    X
    Key
    twitter
    What's tracked
    Posts and engagement
    Plan
    All plans
  • Channel
    Instagram
    Key
    instagram
    What's tracked
    Posts and engagement
    Plan
    All plans
  • Channel
    YouTube
    Key
    youtube
    What's tracked
    Videos and engagement
    Plan
    All plans
  • Channel
    TikTok
    Key
    tiktok
    What's tracked
    Videos and engagement
    Plan
    All plans
  • Channel
    Meta ads
    Key
    meta_ads
    What's tracked
    Active and new ads, creative and messaging
    Plan
    Pro and VC
  • Channel
    Google ads
    Key
    google_ads
    What's tracked
    Active and newly launched ads from Google's Ads Transparency Center
    Plan
    Pro and VC
  • Channel
    LinkedIn ads
    Key
    linkedin_ads
    What's tracked
    Active and newly launched ads from the LinkedIn Ad Library
    Plan
    Pro and VC
  • Channel
    Reddit
    Key
    reddit
    What's tracked
    Mentions and sentiment
    Plan
    Pro and VC
  • Channel
    Reviews (G2 and Trustpilot)
    Key
    reviews
    What's tracked
    New reviews and ratings, low ratings and replies
    Plan
    Pro and VC
  • Channel
    Trademarks (USPTO)
    Key
    trademarks
    What's tracked
    New trademark applications and filings
    Plan
    Pro and VC

Plans and access

  • Starter ($199/month, 10 companies) includes the MCP server. Answers cover the Starter channels; careers, Meta ads, Google ads, LinkedIn ads, Reddit, reviews (G2 and Trustpilot) and trademarks are hidden.
  • Pro ($399/month, 25 companies) and VC plans (from $999/month) include the MCP server, the REST API and all 16 channels, ads, reviews and trademarks included. See Pricing.
  • Any account, including free accounts, can use the free report tools.

Rate limits

  • Limit
    Per person
    Applies to
    Each signed-in user, or each organization API key
    Value
    60 requests / minute
  • Limit
    Per firm
    Applies to
    All members and keys of one firm together
    Value
    600 requests / minute

Every authenticated request counts, including initialize and tools/list. Over the limit, the server returns HTTP 429 with a Retry-After header. If limits can't be checked for a moment, read tools keep working and write tools are refused until they can.

Security

You only ever see your own account's or your firm's companies. 53 of the 83 tools only read; the 30 that change things need write access, and changes with portfolio-level or outside effects (such as removing a company) ask you to confirm first. Keys are stored as hashes, carry read or write scope, can expire and can be revoked at any time. Every call is logged, and firm admins can review their firm's log. Web content in answers is labeled as data, not instructions.

Security and data handling, in full

Troubleshooting

  • Error
    401
    Usual cause
    Sign-in expired or revoked, or the API key was revoked or expired
  • Error
    403
    Usual cause
    Read-only key used for a write tool, not a firm admin, or not a member of that org
  • Error
    429
    Usual cause
    Rate limit hit; wait for Retry-After
  • Error
    No data yet
    Usual cause
    Company added this week; its first weekly run hasn't finished

Troubleshooting guide

For VC firms

Roll out to every partner in three steps.

REST API

Same data over HTTP, for pipelines and internal tools.

Works with Claude, ChatGPT, Claude Code, Codex, Cursor, Microsoft Copilot, VS Code, Meta Muse, Zed, Continue and other MCP clients.