Black Flag Alert
UK company credit risk for England & Wales: R-Score, CCJs, charges, financials. 5.1M companies.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http black-flag-alert 'https://blackflagalert.com/api/mcp'{
"mcpServers": {
"black-flag-alert": {
"type": "http",
"url": "https://blackflagalert.com/api/mcp"
}
}
}Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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.
- Endpoint: https://blackflagalert.com/api/mcp (streamable HTTP, MCP 2025-06-18)
- API keys: free trial, no card — https://blackflagalert.com/developers
- Coverage: England & Wales (5.1M companies). SC/NI/R/FC/OE prefixes are out of coverage.
- Methodology: https://blackflagalert.com/methodology
Tools
| Tool | What it does | Metering |
|---|---|---|
search_companies | Find a company's 8-char number from its name (up to 20 matches) | free |
get_company | Full profile: R-Score, financials, charges, CCJs, directors, narrative | calls |
get_risk_narrative | Fast plain-English risk summary only (cheapest call) | calls |
get_contacts | SMTP-verified emails, phone, domain | contact lookups |
batch_enrich | Up to 50 companies in one call: score, status, overdue, exposure | calls |
usage | Your key's rolling-24h usage vs limits | free |
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
| Variable | Required | Default |
|---|---|---|
BFA_API_KEY | yes | — |
BFA_BASE_URL | no | https://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
Frequently asked questions
What is Black Flag Alert?
UK company credit risk for England & Wales: R-Score, CCJs, charges, financials. 5.1M companies.
How do I install Black Flag Alert?
It runs as a remote server. In Claude Code: claude mcp add --transport http black-flag-alert 'https://blackflagalert.com/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Black Flag Alert need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is Black Flag Alert open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Black Flag Alert?
It is published by lorquaid. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.