project-human

@humanity4ai/mcp-servers

MCP action contracts and server runtime for Humanity4AI skills.

All 9 humanity skills are exposed as standard MCP tools using the official @modelcontextprotocol/sdk JSON-RPC 2.0 protocol, natively compatible with Claude Code, Copilot, Manus AI, OpenCode, LangChain, and any other MCP SDK client.

---

Quick Start for AI Agents

1. Clone and install

git clone https://github.com/humanity4ai/project_human.git
cd project_human
pnpm install

2. Start the MCP server

pnpm start
# or directly:
pnpm --filter @humanity4ai/mcp-servers start

The server starts on stdio using the official MCP SDK JSON-RPC 2.0 protocol. All 9 humanity skills are registered as MCP tools and discoverable via tools/list.

A remote endpoint is also available at https://humanity4ai.ascent.partners/api/mcp using Streamable HTTP transport — no clone needed.

3. Configure your MCP client

Local (stdio):

Add to your MCP client configuration (e.g. claude_desktop_config.json, .cursor/mcp.json, opencode.json):

{
  "mcpServers": {
    "humanity4ai": {
      "command": "pnpm",
      "args": ["--filter", "@humanity4ai/mcp-servers", "start"],
      "cwd": "/path/to/project_human"
    }
  }
}

Or use npx once published to npm (no local clone needed):

{
  "mcpServers": {
    "humanity4ai": {
      "command": "npx",
      "args": ["-y", "@humanity4ai/mcp-servers"]
    }
  }
}

Remote (Streamable HTTP):

{
  "mcpServers": {
    "humanity4ai": {
      "url": "https://humanity4ai.ascent.partners/api/mcp"
    }
  }
}

---

Available Tools (9 skills)

Tool name	Skill	Description
accessibility_audit	WCAG Accessibility Audit	Audit web pages for WCAG 2.2 compliance (crawl) or set session WCAG level
rewrite_depression_sensitive_content	Depression-Sensitive Content	Audit or rewrite text for mental health sensitivity
supportive_reply	Supportive Conversation	Generate a supportive, non-clinical reply with escalation guidance; includes grief support modes (presence, practical, reflection)
cognitive_accessibility_audit	Cognitive Accessibility	Audit content for cognitive load and plain-language compliance
cultural_context_check	Cultural Sensitivity	Check a message for cultural sensitivity issues
deescalation_plan	Conflict De-escalation	Generate a structured de-escalation plan
empathetic_reframe	Empathetic Communication	Reframe a message with genuine empathy
neurodiversity_design_check	Neurodiversity-Aware Design	Audit UI for ADHD, autism, dyslexia, and sensory sensitivities
age_inclusive_design_check	Age-Inclusive Design	Audit a user flow for age-inclusive design

---

Protocol

The server uses the official @modelcontextprotocol/sdk and communicates via JSON-RPC 2.0 over two transports:

• stdio — local process (clone & run, npx, Docker)
• Streamable HTTP — remote deployment (Vercel, stateless mode)

Tool discovery:

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0"}}}
{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}

Tool invocation:

{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"empathetic_reframe","arguments":{"message":"I failed the exam I studied so hard for","tone":"warm"}}}

---

Safety Boundaries

Every tool response includes a boundaryNotice field. Always surface this to users:

• accessibility_audit — Compliance guidance only; does not replace legal review
• rewrite_depression_sensitive_content — Non-clinical UX/content guidance only
• supportive_reply — Non-clinical support; must escalate when risk is elevated (includes grief support modes)
• cognitive_accessibility_audit — Design guidance only
• cultural_context_check — Context-sensitive recommendations with uncertainty disclosure
• deescalation_plan — No coercive tactics
• empathetic_reframe — No manipulation or deceptive empathy
• neurodiversity_design_check — Inclusive design guidance only
• age_inclusive_design_check — Inclusive design guidance only

---

Package Use

pnpm add @humanity4ai/mcp-servers
# or
npm install @humanity4ai/mcp-servers

Import contracts programmatically:

import { actionContracts, validateContracts } from "@humanity4ai/mcp-servers";
const contracts = validateContracts(actionContracts);

---

Examples

The examples/ directory contains one complete request/response pair per action:

File	Action
examples/accessibility_audit.example.json	accessibility_audit
examples/rewrite_depression_sensitive_content.example.json	rewrite_depression_sensitive_content
examples/supportive_reply.example.json	supportive_reply
examples/cognitive_accessibility_audit.example.json	cognitive_accessibility_audit
examples/cultural_context_check.example.json	cultural_context_check
examples/deescalation_plan.example.json	deescalation_plan
examples/empathetic_reframe.example.json	empathetic_reframe
examples/neurodiversity_design_check.example.json	neurodiversity_design_check
examples/age_inclusive_design_check.example.json	age_inclusive_design_check

---

Roadmap

• Auth policies and rate controls for remote deployments
• Telemetry and evaluation hooks
• Rich scenario scoring beyond structural checks
• MCP Registry listing (mcp-publisher)