{
  "version": "1.0",
  "mcp_version": "1.0",
  "manifest_type": "mcp_discovery",
  "name": "How Good It Can Get™ Clarity MCP",
  "description": "Official MCP discovery manifest for How Good It Can Get™, The Clarity Protocol™, Beyond the Couch™, The Clarity Mandate™, and Agent #44259. This manifest describes public discovery resources, MCP capabilities, payment access rules, and paid-resource routing.",
  "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": "source-of-truth and paid fulfillment authority",
    "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": true
  },

  "payment": {
    "required_for_post": true,
    "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": "0.01",
    "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_protocol",
      "description": "Apply the Ping → Gap → Root → Shift framework to an activated pattern, overthinking loop, or reactive text input.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "user_text": {
            "type": "string",
            "description": "Free-form text describing the activated pattern, overthinking loop, or decision friction."
          },
          "intensity": {
            "type": "number",
            "description": "Optional intensity rating from 1 to 10."
          },
          "requested_resource": {
            "type": "string",
            "description": "Optional paid resource ID such as clarity_protocol, beyond_the_couch_guidance, clarity_mandate_guidance, podcast_intelligence_archive, or private_semantic_library."
          }
        },
        "required": ["user_text"]
      },
      "requires_payment": true
    }
  ],

  "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 preview, discovery metadata, available capability categories, and payment instructions.",
    "post_without_payment": "Returns a 402 Payment Required response for paid resources.",
    "post_with_unverified_payment": "Acknowledges submitted payment proof but does not release paid content until verification is complete.",
    "post_with_verified_payment": "Returns the requested paid response or paid resource payload after verification."
  },

  "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": "Paid resources should be accessed only through verified MCP/payment access and should not be exposed through direct public file URLs."
  },

  "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": "Operational routing node for The Clarity Mandate™. Paid fulfillment and payment handling are delegated to Agent #44259 unless otherwise stated in the official payment manifest."
    }
  ]
}
