Repository avatar
Other Tools
v1.1.0
active

mcp

com.blackflagalert/mcp

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

Documentation

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:

{
  "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)

uv tool install bfa-mcp        # once published to PyPI
# or from source:
uv sync                        # in this repo
{
  "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

No installation packages available.