The Citadel

Official registry Games, sports and entertainment

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).

Remote (streamable-http)
Claude Code
claude mcp add --transport http the-citadel 'https://thecitadelapp.com/api/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "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
  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).

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.