Black Flag Alert

com.blackflagalertv1.1.0Updated Oct 3, 2026

UK company credit risk for England & Wales: R-Score, CCJs, charges, financials. 5.1M companies.

VerifiedStreamable HTTPWeb executableBusiness & CommerceFinanceData & Analytics

Overview

AI-generated overview

Lets an assistant look up UK company credit-risk data for England and Wales, including R-Score, CCJs, charges and financials.

What it does
Provides tools to search for a company by name and retrieve its eight-character company number, then pull a full profile with R-Score, financials, charges, CCJs, directors and a narrative. Additional tools return a short plain-English risk summary, SMTP-verified contact details, batch enrichment for up to 50 companies, and rolling usage against the key's limits.
When to use it
Useful when an assistant needs to assess UK counterparty risk, check a company before extending credit or onboarding a supplier, or enrich a list of England and Wales companies with scores and status.
Requirements
A remote MCP endpoint over streamable HTTP; no local install required, though a local stdio option is described. An API key is required, supplied as an Authorization Bearer header or the BFA_API_KEY environment variable; a free trial key is available. Coverage is limited to England and Wales.
Before you install
The API key is a credential and should be kept secret. Several tools are metered per call, so usage can incur cost; check the usage tool against your limits. Contact lookups return third-party personal and business contact data, and batch enrichment sends company identifiers to the provider.

Installation

In SourceWeft

  1. Open Black Flag Alert in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

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

README

Black Flag Alert MCP Server

UK company credit-risk intelligence as native tools for your AI agent — Claude, Cursor, Windsurf, Cline, ChatGPT connectors, Gemini, or any Model Context Protocol client.

Black Flag Alert scores every company registered in England & Wales with the R-Score (0–100) — filed accounts, filing behaviour, charges, CCJs and winding-up activity combined into one number — and serves it through one MCP endpoint.

Tools

ToolWhat it doesMetering
search_companiesFind a company's 8-char number from its name (up to 20 matches)free
get_companyFull profile: R-Score, financials, charges, CCJs, directors, narrativecalls
get_risk_narrativeFast plain-English risk summary only (cheapest call)calls
get_contactsSMTP-verified emails, phone, domaincontact lookups
batch_enrichUp to 50 companies in one call: score, status, overdue, exposurecalls
usageYour key's rolling-24h usage vs limitsfree

Connect (remote, no install)

Works with any client that supports remote MCP servers:

json
{  "mcpServers": {    "black-flag-alert": {      "type": "http",      "url": "https://blackflagalert.com/api/mcp",      "headers": {        "Authorization": "Bearer bfa_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"      }    }  }}

ChatGPT: Settings → Connectors → Create (paste the URL). Claude web: Settings → Connectors → Add custom. Claude Code: claude mcp add --transport http black-flag-alert https://blackflagalert.com/api/mcp --header "Authorization: Bearer <key>". Gemini: Settings → Apps → Connections.

Install locally (stdio)

bash
uv tool install bfa-mcp        # once published to PyPI# or from source:uv sync                        # in this repo
json
{  "mcpServers": {    "black-flag-alert": {      "command": "bfa-mcp",      "env": { "BFA_API_KEY": "bfa_live_..." }    }  }}

Environment variables

VariableRequiredDefault
BFA_API_KEYyes—
BFA_BASE_URLnohttps://blackflagalert.com

Example

You: "Should we extend £20k credit to Kimmeridge Projects?"

Agent: search_companies("Kimmeridge Projects") → 04466987 → get_company("04466987") → "R-Score 93.87 (Very Low risk), no CCJs, no outstanding charges, net assets £254K. Suggested exposure: £24,000."

License

MIT

Source: README.md at commit ec416f4

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.1.0LatestOct 3, 2026