# Black Flag Alert

> Black Flag Alert is a freemium MCP server for finance and payments. UK company credit risk: R-Score, CCJs, charges and financials for 5.1M companies. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://blackflagalert.com/developers
- **Repository:** https://github.com/lorquaid/black-flag-alert-mcp
- **MCP Registry name:** com.blackflagalert/mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://blackflagalert.com/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://blackflagalert.com/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/black-flag-alert
