The Citadel

السجل الرسمي الألعاب والرياضة والترفيه

Deterministic 6-dimension dating profile rubrics and readiness checks via Streamable HTTP MCP.

التثبيت

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

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

التوثيق

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

المحتويات
  1. The Citadel Remote MCP Server (com.thecitadelapp/citadel)
  2. Quickstart: Connect in Your MCP Client
  3. Available Public MCP Tools
  4. Discovery & Verification Endpoints
  5. Web Diagnostics & Pricing
  6. Verify Live with curl
  7. Repository Contents
  8. Publisher, Support & Policies
  9. Zero-Install Stdio Bridge (npx)

The Citadel Remote MCP Server (com.thecitadelapp/citadel)

Hosted Streamable HTTP Model Context Protocol (MCP) server for deterministic dating profile rubrics, lead photo evaluation criteria, and profile readiness diagnostics.

  • Remote MCP Endpoint (Public): https://thecitadelapp.com/api/mcp
  • Authenticated MCP Endpoint: https://thecitadelapp.com/api/mcp/server (requires Authorization: Bearer <token>)
  • Transport: streamable-http (JSON-RPC 2.0 over HTTPS — no local install required)
  • Registry ID: com.thecitadelapp/citadel (v1.0.0)
  • Publisher: The Citadel Operations (support@thecitadelapp.com)
  • Website: https://thecitadelapp.com

Quickstart: Connect in Your MCP Client

All three public diagnostic tools on https://thecitadelapp.com/api/mcp work over HTTPS with no credentials required.

1. Cursor

Copy .cursor/mcp.json into your project's .cursor/mcp.json (or ~/.cursor/mcp.json globally):

{
  "mcpServers": {
    "citadel": {
      "type": "http",
      "url": "https://thecitadelapp.com/api/mcp"
    }
  }
}
2. Claude Code

Add the remote Streamable HTTP server directly from your terminal:

claude mcp add --transport http citadel https://thecitadelapp.com/api/mcp
3. Claude Desktop
  • Option A (Connectors UI): Open Settings → Connectors → Add custom connector and enter https://thecitadelapp.com/api/mcp.
  • Option B (claude_desktop_config.json): Use claude_desktop_config.json with mcp-remote:
{
  "mcpServers": {
    "citadel": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://thecitadelapp.com/api/mcp"
      ]
    }
  }
}
4. Windsurf

Add The Citadel to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "citadel": {
      "serverUrl": "https://thecitadelapp.com/api/mcp"
    }
  }
}
5. Antigravity

In Antigravity's mcp_config.json, register the remote Streamable HTTP endpoint:

{
  "mcpServers": {
    "citadel": {
      "serverUrl": "https://thecitadelapp.com/api/mcp"
    }
  }
}

Available Public MCP Tools

ToolPurposeKey Inputs
citadel_platform_statusReturn service health, supported protocols (mcp, acp, ucp, x402), public web routes, and discovery endpoints.{} (no arguments)
citadel_get_lead_photo_rubricRetrieve the deterministic dating profile and lead photo evaluation rubric (slot 1 clarity, lighting exposure, framing posture, activity variety, prompt hooks).platform (hinge \bumble \tinder \general, optional)
citadel_evaluate_profile_readinessScore dating profile structural readiness and surface first-impression conversion bottlenecks from photo count, lead photo clarity, and prompt count.photoCount (required number, 1-6), soloClearLeadPhoto (required boolean), promptCount (optional number, 0-3)

Discovery & Verification Endpoints

EndpointPurpose
https://thecitadelapp.com/api/mcpPublic Streamable HTTP JSON-RPC 2.0 MCP endpoint (POST for initialize, tools/list, tools/call; GET returns server summary & tool names).
https://thecitadelapp.com/api/mcp/serverBearer-authenticated MCP endpoint (POST, returns HTTP 401 without a valid bearer token).
https://thecitadelapp.com/.well-known/mcp.jsonMachine-readable MCP server discovery card (protocolVersion: "2025-03-26", version 1.0.0).
https://thecitadelapp.com/.well-known/mcp-registry-authEd25519 domain ownership proof (v=MCPv1; k=ed25519; ...) for the Official MCP Registry.
https://thecitadelapp.com/.well-known/agent-card.jsonAgent-to-Agent (A2A) discovery card (protocolVersion: 0.3.0) pointing to https://thecitadelapp.com/api/a2a/lead-photo.
https://thecitadelapp.com/llms.txtConcise llms.txt directory covering The Citadel's lead-photo check, frameworks, and public routes.

Web Diagnostics & Pricing


Verify Live with curl

Run the included smoke-test script (no token required):

chmod +x ./examples/verify-mcp.sh
./examples/verify-mcp.sh

Direct curl example for citadel_evaluate_profile_readiness:

curl -sS -X POST https://thecitadelapp.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "citadel_evaluate_profile_readiness",
      "arguments": {
        "photoCount": 4,
        "soloClearLeadPhoto": true,
        "promptCount": 3
      }
    }
  }'

Repository Contents


Publisher, Support & Policies

Zero-Install Stdio Bridge (npx)

For stdio-only MCP clients (like Claude Desktop), connect without cloning or managing dependencies:

{
  "mcpServers": {
    "thecitadelapp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "github:venkork/citadel-mcp"
      ]
    }
  }
}

Or run directly via terminal: npx -y github:venkork/citadel-mcp (package ID: thecitadelapp-mcp@1.0.0).

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

ما هو The Citadel؟

Deterministic 6-dimension dating profile rubrics and readiness checks via Streamable HTTP MCP.

كيف أثبّت The Citadel؟

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

هل يحتاج The Citadel إلى مفتاح API؟

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

هل The Citadel مفتوح المصدر؟

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

من يصون The Citadel؟

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

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