Skip to content
MCP server

Black Flag Alert

UK company credit risk: R-Score, CCJs, charges and financials for 5.1M companies

Install
Pricing
Freemium
Platforms
API, CLI
Runs
Remotely
Version
1.1.0
Listing updated
2 days ago

About Black Flag Alert

Black Flag Alert is a freemium MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.

Black Flag Alert scores companies registered in England and Wales from 0 to 100 using filed accounts, filing behaviour, charges, CCJs and winding-up activity. Scottish, Northern Irish and overseas company numbers are out of coverage, and the API returns not-found with a reason for them.

The README lists six tools. A company can be found by name, fetched as a full profile with five years of financials, directors and a suggested credit exposure, summarised in a plain-English narrative, enriched in batches of up to 50, or looked up for SMTP-verified contact details. The README's example asks whether to extend 20,000 pounds of credit and gets back a score, no CCJs, net assets and a suggested exposure.

A free trial key lasts 14 days with 100 calls and 20 contact lookups a day, no card needed. The README notes a local stdio option and an MIT licence.

Install

Run in a terminal

claude mcp add --transport http mcp https://blackflagalert.com/api/mcp

Add to Settings → Connectors → Add custom connector

https://blackflagalert.com/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://blackflagalert.com/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://blackflagalert.com/api/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://blackflagalert.com/api/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://blackflagalert.com/api/mcp"
    }
  }
}

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

search_companies
Finds a company number from a name, up to 20 matches.
get_company
Full profile with R-Score, financials, charges, CCJs and directors.
get_risk_narrative
Fast plain-English risk summary.
get_contacts
SMTP-verified emails, phone and domain.
batch_enrich
Enriches up to 50 companies in one call.
usage
Shows the key's rolling 24-hour usage.

What it does

R-Score
A 0-100 score with risk band for each company.
Full company profile
Financials, filings, charges, CCJs, directors and suggested credit exposure.
Risk narrative
A deterministic plain-English summary, the cheapest call.
Verified contacts
SMTP-validated emails, phone and website domain.
Batch enrichment
Up to 50 companies per call.
Usage check
Shows rolling 24-hour usage against limits.

Good for

  • Assess a customer's credit risk before extending terms
  • Screen a supplier by CCJs and charges
  • Enrich a prospect list with scores and contacts
  • Monitor score changes between filing periods

Pricing

Freemium

Free core product and 14-day trial API key; paid add-ons planned

Prices change. Check blackflagalert.com before you buy.

Black Flag Alert FAQ

Which companies are covered?

Companies registered in England and Wales; Scottish, NI and overseas numbers are not.

How do I get a key?

Request a free trial key at blackflagalert.com/developers; no card is needed.

What are the trial limits?

14 days, 100 calls a day and 20 contact lookups a day.

Can it run locally?

Yes, a stdio package using BFA_API_KEY is described in the README.

Is Black Flag Alert free?

Black Flag Alert has a free plan, with paid plans for more usage or features.

How do I add Black Flag Alert to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://blackflagalert.com/api/mcp

What are the best alternatives to Black Flag Alert?

The closest alternatives to Black Flag Alert are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

Alternatives to Black Flag Alert

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments