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»).
claude mcp add --transport http the-citadel 'https://thecitadelapp.com/api/mcp'
{
"mcpServers": {
"the-citadel": {
"type": "http",
"url": "https://thecitadelapp.com/api/mcp"
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
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(requiresAuthorization: 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): Useclaude_desktop_config.jsonwithmcp-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
| Tool | Purpose | Key Inputs | |||
|---|---|---|---|---|---|
citadel_platform_status | Return service health, supported protocols (mcp, acp, ucp, x402), public web routes, and discovery endpoints. | {} (no arguments) | |||
citadel_get_lead_photo_rubric | Retrieve 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_readiness | Score 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
| Endpoint | Purpose |
|---|---|
https://thecitadelapp.com/api/mcp | Public 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/server | Bearer-authenticated MCP endpoint (POST, returns HTTP 401 without a valid bearer token). |
https://thecitadelapp.com/.well-known/mcp.json | Machine-readable MCP server discovery card (protocolVersion: "2025-03-26", version 1.0.0). |
https://thecitadelapp.com/.well-known/mcp-registry-auth | Ed25519 domain ownership proof (v=MCPv1; k=ed25519; ...) for the Official MCP Registry. |
https://thecitadelapp.com/.well-known/agent-card.json | Agent-to-Agent (A2A) discovery card (protocolVersion: 0.3.0) pointing to https://thecitadelapp.com/api/a2a/lead-photo. |
https://thecitadelapp.com/llms.txt | Concise llms.txt directory covering The Citadel's lead-photo check, frameworks, and public routes. |
Web Diagnostics & Pricing
- Free Lead Photo Check: https://thecitadelapp.com/lead-photo-check — one uploaded photo, one first-frame signal, no sign-in or payment required.
- Full Profile Upgrade (Pricing):
$24.99one-time purchase (30 Intel credits — covers 1 Full Profile Audit at 15 credits plus 1 Post-Reshoot Verification Check, or up to 3 Photo Forge photos). - Private Profile Signal Audit: https://thecitadelapp.com/dating-profile-audit/start
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
server.json— Official MCP Registry manifest (2025-12-11schema, version1.0.0).cursor/mcp.json— Cursor Streamable HTTP MCP configurationclaude_desktop_config.json— Claude Desktopmcp-remoteconfigurationexamples/verify-mcp.sh— Executablecurlsmoke-test scriptLICENSE— MIT License
Publisher, Support & Policies
- Publisher: The Citadel Operations
- Support: support@thecitadelapp.com
- Policies: Privacy Policy · Terms of Service
- License: MIT
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 الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.