Black Flag Alert
UK company credit risk for England & Wales: R-Score, CCJs, charges, financials. 5.1M companies.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
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
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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
Questions fréquentes
Qu'est-ce que Black Flag Alert ?
UK company credit risk for England & Wales: R-Score, CCJs, charges, financials. 5.1M companies.
Comment installer Black Flag Alert ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http black-flag-alert 'https://blackflagalert.com/api/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour Black Flag Alert ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
Black Flag Alert est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient Black Flag Alert ?
Il est publié par lorquaid. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.