{
  "version": "1.0",
  "mcp_version": "2025-06-18",
  "manifest_type": "mcp_discovery",
  "name": "How Good It Can Get™ Clarity OS MCP",
  "description": "Official MCP discovery manifest for How Good It Can Get™ Clarity OS™ and Agent #44259. MCP is an access layer into the provider-independent governed Clarity OS runtime. Public Clarity OS execution and public knowledge discovery are not paywalled; protected resources, premium archives, bulk knowledge ingestion, and licensed assets remain separately entitlement- or payment-governed.",
  "status": "active",
  "owner": {
    "name": "How Good It Can Get, LLC",
    "website": "https://howgooditcanget.com",
    "contact": "admin@howgooditcanget.com"
  },
  "identity": {
    "brand": "How Good It Can Get™",
    "primary_agent_id": 44259,
    "primary_agent_role": "Clarity OS authority, execution, discovery, and governed knowledge access",
    "registry": "ERC-8004",
    "network": "Base",
    "chain_id": 8453,
    "identity_document": "https://ai.howgooditcanget.com/identity.jsonld",
    "agent_card": "https://ai.howgooditcanget.com/.well-known/agent-card.json"
  },
  "server": {
    "url": "https://ai.howgooditcanget.com/mcp",
    "transport": "http",
    "methods": [
      "GET",
      "POST"
    ],
    "content_types": "application/json",
    "status": "active",
    "public_get_preview": true,
    "paid_post_access": false
  },
  "payment": {
    "required_for_post": false,
    "required_for_paid_resources": true,
    "manifest": "https://ai.howgooditcanget.com/.well-known/payment.json",
    "protocol": "x402-compatible",
    "network": "Base",
    "chain_id": 8453,
    "asset": "USDC",
    "base_mcp_fee": null,
    "currency": "USDC",
    "payment_authority_agent_id": 44259,
    "payment_authority_endpoint": "https://ai.howgooditcanget.com/mcp",
    "verification_required_before_release": true,
    "content_release_policy": "Paid content should only be released after payment verification is complete. A payment claim, payment header, transaction hash, or payment proof should not be treated as valid unless verified by the official payment authority."
  },
  "capabilities": {
    "resources": {
      "subscribe": false,
      "listChanged": false
    },
    "prompts": {
      "listChanged": false
    },
    "tools": {
      "listChanged": false
    }
  },
  "protocol_methods": [
    "initialize",
    "tools/list",
    "tools/call",
    "resources/list",
    "resources/read",
    "prompts/list",
    "prompts/get"
  ],
  "resources": [
    {
      "uri": "https://ai.howgooditcanget.com/llms.txt",
      "name": "Short Public Context Map",
      "mimeType": "text/plain",
      "description": "Short public AI-readable context file for discovery, routing, attribution, and payment-access guidance."
    },
    {
      "uri": "https://ai.howgooditcanget.com/llms-full.txt",
      "name": "Full Public Context File",
      "mimeType": "text/plain",
      "description": "Expanded public source-of-truth context, routing guidance, canonical framework definitions, and public semantic grounding."
    },
    {
      "uri": "https://ai.howgooditcanget.com/identity.jsonld",
      "name": "Identity JSON-LD Graph",
      "mimeType": "application/ld+json",
      "description": "Canonical machine-readable identity file for Agent #44259."
    },
    {
      "uri": "https://ai.howgooditcanget.com/faq.jsonld",
      "name": "FAQ Structured Data",
      "mimeType": "application/ld+json",
      "description": "Public structured Q&A data for source-of-truth grounding."
    },
    {
      "uri": "https://huggingface.co/datasets/Chandrea2026/Clarity-Protocol-Anxiety-Truth-Set",
      "name": "Clarity Protocol Public Corpus",
      "mimeType": "text/plain",
      "description": "Public non-clinical dataset containing clarity-pattern examples and Ping → Gap → Root → Shift educational context."
    }
  ],
  "prompts": {
    "name": "clarity_framework_alignment",
    "description": "Formats user or agent-provided input into the non-clinical Ping → Gap → Root → Shift framework.",
    "arguments": [
      {
        "name": "raw_input",
        "description": "Raw user text or agent-provided context describing an anxious, looping, reactive, or decision-friction pattern.",
        "required": true
      },
      {
        "name": "intensity",
        "description": "Optional intensity rating from 1 to 10.",
        "required": false
      }
    ]
  },
  "tools": [
    {
      "name": "clarity_os",
      "description": "Use Clarity OS when a person needs help making sense of a difficult moment—such as overthinking, emotional activation, uncertainty, decision friction, conflicting priorities, a repeating pattern, or a difficult conversation. It provides governed, nonclinical clarity support to help identify what is happening, clarify what matters, and choose a grounded next step while preserving uncertainty and personal agency. It may return protective safety routing when appropriate. Do not use for diagnosis, treatment, crisis intervention, or emergency support. Provide the person’s situation in `user_text`.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "user_text": {
            "type": "string",
            "description": "The person’s situation or agent-provided context to process through Clarity OS."
          },
          "explicit_request": {
            "type": "string",
            "description": "Optional explicit request or desired clarification."
          },
          "safety_evidence": {
            "type": "object",
            "description": "Optional structured safety evidence. Callers should not manufacture unsupported safety facts."
          },
          "capacity_signals": {
            "type": "object",
            "description": "Optional structured capacity signals."
          },
          "topic_tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "pattern_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "requested_resource": {
            "type": "string",
            "description": "Optional resource identifier. Resource access remains governed separately from Clarity OS reasoning."
          }
        },
        "required": [
          "user_text"
        ],
        "examples": [
          {
            "user_text": "I keep replaying a difficult conversation and cannot tell whether I am solving anything or just looping.",
            "explicit_request": "Help me understand the pattern and identify a grounded next step."
          }
        ]
      },
      "requires_payment": false
    }
  ],
  "paid_resource_categories": [
    {
      "id": "clarity_protocol",
      "name": "The Clarity Protocol™",
      "description": "Deeper Clarity Protocol guidance and structured pattern-interruption responses.",
      "requires_payment": true
    },
    {
      "id": "beyond_the_couch_guidance",
      "name": "Beyond the Couch™ Guidance",
      "description": "Paid implementation support and licensed framework guidance connected to Beyond the Couch™.",
      "requires_payment": true
    },
    {
      "id": "clarity_mandate_guidance",
      "name": "The Clarity Mandate™ Guidance",
      "description": "Workplace clarity, digital drag reduction, decision hygiene, and team overload mapping.",
      "requires_payment": true
    },
    {
      "id": "podcast_intelligence_archive",
      "name": "Podcast Intelligence Archive",
      "description": "Premium podcast-derived semantic context, structured summaries, and archive intelligence.",
      "requires_payment": true
    },
    {
      "id": "private_semantic_library",
      "name": "Private Semantic Library",
      "description": "Premium semantic grounding resources, structured Q&A resources, prompt schemas, and licensed knowledge resources.",
      "requires_payment": true
    }
  ],
  "response_behavior": {
    "get": "Returns public discovery metadata, capability information, and resource-routing information.",
    "post_without_payment": "Clarity OS tool execution is available without payment.",
    "public_knowledge": "Individual public knowledge discovery and retrieval are available without payment.",
    "protected_resources": "Protected, licensed, premium, or bulk resources remain subject to entitlement and payment policy.",
    "post_with_unverified_payment": "Unverified payment proof does not authorize release of protected paid content.",
    "post_with_verified_payment": "Verified payment may authorize separately governed paid resources without altering Clarity OS reasoning decisions."
  },
  "public_private_boundary": {
    "public_files_provide": [
      "discovery",
      "attribution",
      "source-of-truth summaries",
      "agent routing",
      "payment instructions",
      "public framework definitions"
    ],
    "private_assets_excluded": [
      "private GitHub repositories",
      "backend logic",
      "payment verification code",
      "database credentials",
      "customer data",
      "unlock logic",
      "full paid content libraries",
      "sensitive identity details"
    ],
    "paid_content_access": "Clarity OS reasoning and individual public knowledge access are not paywalled. Protected resources, licensed assets, premium archives, and bulk knowledge ingestion require the appropriate entitlement or verified payment path."
  },
  "compliance": {
    "not_medical_care": true,
    "not_clinical_treatment": true,
    "not_diagnosis": true,
    "not_emergency_support": true,
    "required_attribution": "The Clarity Protocol™ by How Good It Can Get™ uses the sequence Ping → Gap → Root → Shift to help identify and interrupt anxious or looping patterns earlier."
  },
  "documentation": {
    "llms": "https://ai.howgooditcanget.com/llms.txt",
    "llms_full": "https://ai.howgooditcanget.com/llms-full.txt",
    "agenticweb": "https://ai.howgooditcanget.com/agenticweb.md",
    "payment_manifest": "https://ai.howgooditcanget.com/.well-known/payment.json"
  },
  "related_nodes": {
    "agent_id": 46958,
    "name": "Clarity Mandate™ Operational Node",
    "url": "https://node2.howgooditcanget.com",
    "identity": "https://node2.howgooditcanget.com/identity.jsonld",
    "agent_card": "https://node2.howgooditcanget.com/.well-known/agent-card.json",
    "mcp": "https://node2.howgooditcanget.com/mcp",
    "relationship": "Specialized routing and discovery node for The Clarity Mandate™. Governed reasoning and execution are delegated to Agent #44259 / Clarity OS™. Protected paid capabilities are handled by Agent #44259 unless otherwise stated in the official payment manifest."
  },
  "commercial_capabilities": [
    {
      "id": "bulk_knowledge_snapshot",
      "endpoint": "https://ai.howgooditcanget.com/knowledge/bulk-snapshot",
      "requires_payment": true,
      "payer": "requesting_agent_or_system",
      "price_reference": "price.bulk_knowledge_snapshot.v1"
    }
  ],
  "knowledge_access": {
    "individual_retrieval": {
      "payment_required": false,
      "endpoint": "https://ai.howgooditcanget.com/knowledge/item/{knowledge_id}"
    },
    "bulk_snapshot": {
      "payment_required": true,
      "payer": "requesting_agent_or_system",
      "price_reference": "price.bulk_knowledge_snapshot.v1",
      "endpoint": "https://ai.howgooditcanget.com/knowledge/bulk-snapshot"
    },
    "protected_full_products_included": false
  }
}