English Français العربية

Black Flag Alert

السجل الرسمي أخرى

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http black-flag-alert 'https://blackflagalert.com/api/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "black-flag-alert": {
            "type": "http",
            "url": "https://blackflagalert.com/api/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Black Flag Alert MCP Server
  2. Tools
  3. Connect (remote, no install)
  4. Install locally (stdio)
  5. Environment variables
  6. Example
  7. License

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

الأسئلة الشائعة

ما هو Black Flag Alert؟

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

كيف أثبّت Black Flag Alert؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http black-flag-alert 'https://blackflagalert.com/api/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Black Flag Alert إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Black Flag Alert مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Black Flag Alert؟

ينشره lorquaid. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.