The Citadel
Deterministic 6-dimension dating profile rubrics and readiness checks via Streamable HTTP MCP.
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 the-citadel 'https://thecitadelapp.com/api/mcp'
{
"mcpServers": {
"the-citadel": {
"type": "http",
"url": "https://thecitadelapp.com/api/mcp"
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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).
Questions fréquentes
Qu'est-ce que The Citadel ?
Deterministic 6-dimension dating profile rubrics and readiness checks via Streamable HTTP MCP.
Comment installer The Citadel ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http the-citadel 'https://thecitadelapp.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 The Citadel ?
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.
The Citadel est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient The Citadel ?
Il est publié par venkork. 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.