About Black Flag Alert
Black Flag Alert provides credit-risk data for companies in England and Wales, for AI agents and MCP clients assessing business risk. Its R-Score combines financial filings, filing behavior, charges, CCJs, and winding-up activity, with tools for individual lookups and batch enrichment.
Key features
- 01Search companies by name
- 02Retrieve R-Score and company profiles
- 03Get plain-English risk summaries
- 04Look up SMTP-verified contact details
- 05Enrich up to 50 companies per call
Use cases
- 01Assess credit risk for a prospective customer or partner
- 02Review a company's CCJs, charges, and financials
- 03Enrich risk and status data for companies in bulk
- 04Find a company's email, phone, and domain
MCP support
It provides a remote Streamable HTTP MCP endpoint and can also be connected locally over stdio. Its MCP tools search companies, retrieve risk profiles and contact details, and enrich company data in batches.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://blackflagalert.com/api/mcpclaude mcp add --transport http com-blackflagalert https://blackflagalert.com/api/mcp{"mcpServers":{"com-blackflagalert":{"type":"http","url":"https://blackflagalert.com/api/mcp"}}}Open in Cursor{"servers":{"com-blackflagalert":{"type":"http","url":"https://blackflagalert.com/api/mcp"}}}Open in VS Code{"mcpServers":{"com-blackflagalert":{"type":"http","url":"https://blackflagalert.com/api/mcp"}}}{"mcpServers":{"com-blackflagalert":{"serverUrl":"https://blackflagalert.com/api/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEBlack 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.