club-mcp
Provides read-only access to the Hyper Human Club / Fluent Community via WordPress REST API, allowing retrieval of posts, comments, members, and profiles.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
club-mcp
Read-only MCP access to the Hyper Human Club / Fluent Community REST API.
Goal
Support three deployment variants with one shared TypeScript read-only core:
Local stdio MCP — recommended privacy-first default; credentials and club data stay on the user's machine.
Hosted public Streamable HTTP MCP — OAuth-protected remote connector with encrypted per-user WordPress credential storage.
Self-hosted remote MCP — operator deploys the HTTP server on their own infrastructure.
All variants expose safe read-only tools such as club_get_recent_posts, club_get_recent_comments, club_get_user_comments, club_search_members, and club_get_profile without sharing the owner’s browser session.
Related MCP server: @bdelanghe/site-mcp
Current status
v0.0.x ships the local stdio MCP server with 13 read-only tools that wrap the Hyper Human Club / Fluent Community REST API (club_search_members, club_get_profile, club_get_my_profile, club_list_spaces, club_list_courses, club_get_feed, club_get_feed_comments, club_get_user_comments, club_get_recent_posts, club_get_recent_comments, club_get_since_summary, club_get_unread_notifications, club_search_content). All tools are read-only and run against the authenticated user's own scope.
Published packages:
@hhc-mcp/core— framework-agnostic core (GET-only REST client, Zod schemas, 13 operations).@hhc-mcp/stdio— local stdio MCP transport, ready to register with Claude Desktop or any MCP client.
@hhc-mcp/http is scaffold-only and reserved for v0.2.0 (hosted/self-hosted HTTP transport).
Install
npx -y @hhc-mcp/stdioOr as a dependency:
pnpm add @hhc-mcp/stdio @hhc-mcp/coreSee docs/local-mode.md for the Claude Desktop config and credential setup.
License: MIT.
Key decisions
TypeScript-first implementation.
pnpm workspace with
@hhc-mcp/core,@hhc-mcp/stdio,@hhc-mcp/http.v1 is read-only only.
No POST/PATCH/PUT/DELETE tools.
No generic REST proxy tool.
No owner cookies/nonces in hosted mode.
Per-user upstream auth through WordPress Application Passwords.
Local stdio is recommended for maximum privacy.
Hosted public mode uses Basic Auth pass-through (see ADR-019). The server stores no credentials and runs no OAuth authorization server.
Cloudflare Tunnel publishes the hosted origin; TLS terminates at Cloudflare.
Local stdio direction
MCP client
-> local @hhc-mcp/stdio process
-> @hhc-mcp/core
-> https://club.hyperhuman.pl/wp-json/fluent-community/v2Example config:
{
"mcpServers": {
"hyperhuman-club": {
"command": "npx",
"args": ["-y", "@hhc-mcp/stdio"],
"env": {
"HHC_BASE_URL": "https://club.hyperhuman.pl",
"HHC_USER": "your_wp_login",
"HHC_APP_PASS": "xxxx xxxx xxxx xxxx xxxx xxxx"
}
}
}
}Hosted public direction
MCP client (with Authorization: Basic header)
-> /mcp endpoint on @hhc-mcp/http (behind Cloudflare Tunnel)
-> @hhc-mcp/core
-> club.hyperhuman.pl REST API (same Basic header forwarded)Hosted public mode holds the WordPress Application Password only in request-scoped memory and forwards it 1:1 to upstream. It persists no credentials and no club content, and never logs argument payloads or response bodies. See ADR-019.
Folder structure
club-mcp/
docs/
adr/
architecture.md
best-practices.md
hosted-auth.md
hosted-auth.md
implementation-plan.md
open-questions.md
read-only-tools.md
references.md
security-checklist.md
self-hosted-remote.md
stack-decision.md
variants.md
packages/
core/
stdio/
http/
research/Most important docs
docs/stack-decision.md— TypeScript-first stack decision.docs/adr/— formal architecture decisions.docs/variants.md— local, hosted public, and self-hosted variants.docs/architecture.md— system architecture.docs/hosted-auth.md— hosted auth and connect flow.docs/read-only-tools.md— read-only tool contracts.docs/security-checklist.md— practical checklist.docs/implementation-plan.md— build phases and estimates.docs/open-questions.md— remaining owner decisions before coding.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only MCP server for The Quiet Protocol's engines, benchmarks, proof, and business data.
Public read-only MCP server for HODLXXI agent identity, trust, receipts, and verification.
Read-only, no-auth MCP server over Human x AI's Content Hub and confirmed 2027 facts.
Public read-only MCP server for Genvernium product and developer resources.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceRead-only MCP server for accessing Substack content including publications, posts, comments, author profiles, recommendations, and Notes feed using your own session token.4MIT
- AlicenseNot gradedqualityCmaintenanceA local, read-only MCP server that exposes verified profile, posts, corpus, and other identity data from robertdelanghe.dev's signed static API.26 npmMIT
- AlicenseNot gradedqualityBmaintenanceA local, read-only Reddit MCP server that provides tools for searching posts, retrieving posts/comments, subreddit information, and user content via the official Reddit Data API with caching and privacy-focused features.-
- AlicenseNot gradedqualityDmaintenanceRead-only MCP server that provides tools to fetch SealChat public protocol docs, manifest, channel counts, and chat messages via the HTTP Agent API, without write access or database access.MIT