The Citadel
Deterministic 6-dimension dating profile rubrics and readiness checks via Streamable HTTP MCP.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http the-citadel 'https://thecitadelapp.com/api/mcp'
{
"mcpServers": {
"the-citadel": {
"type": "http",
"url": "https://thecitadelapp.com/api/mcp"
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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).
Frequently asked questions
What is The Citadel?
Deterministic 6-dimension dating profile rubrics and readiness checks via Streamable HTTP MCP.
How do I install The Citadel?
It runs as a remote server. In Claude Code: claude mcp add --transport http the-citadel 'https://thecitadelapp.com/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does The Citadel need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is The Citadel open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains The Citadel?
It is published by venkork. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.