Skip to main content
Glama
The Citadel

The Citadel

by venkork

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"
    }
  }
}

Related MCP server: checkyourself

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


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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Remote MCP server with 21 tools: 10 Domain Dossier checks (DNS, MX, SPF, DMARC, DKIM, TLS, redirects, headers, CORS, web-surface) plus 10 developer utilities (base64, JWT decode, DNS lookup, UUID v4/v7, URL encode/decode, JSON format, User-Agent parse, IP lookup) and a dossier_full aggregate. Served over Streamable HTTP.
      21
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      A local, read-only MCP server that lets AI agents inspect and analyze photo libraries by scanning files, aggregating EXIF stats, finding duplicates, scoring blur, and generating cull reports without uploading any data.
      6
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      An MCP server that lets agents run free, keyless lead-leak audits on UK local service businesses — detecting form platforms and their outreach implications, checking whether phone numbers are tappable tel: links, comparing phone numbers across a site and free directories, screening website hygiene, and locating a business's own site. It also bundles these into a single full audit that returns a prioritised list of fixable issues alongside top local competitors.
      6
      MIT