{
  "server_name": "Cognethics MCP Connector",
  "server_version": "0.1.0",
  "description": "Model Context Protocol connector for the Cognethics platform. Exposes a typed tool surface across inventory, finance, healthcare, CRM, HR, agent orchestration, and document management. The tool catalog is lazy-loaded; per-organization availability is determined by your configuration.",
  "protocol_version": "2025-03-26",
  "supported_protocol_versions": [
    "2024-11-05",
    "2025-03-26"
  ],
  "x-cognethics-llms": "https://developers.cognethics.com/for-agents/",
  "capabilities": {
    "tools": {
      "enabled": true,
      "mega_tool_count": 11,
      "mega_tools": [
        "agent_command",
        "collection_op",
        "config_manage",
        "document_op",
        "entity_crud",
        "extension_op",
        "integration_call",
        "notification_send",
        "report_query",
        "smart_action",
        "workflow_action"
      ],
      "handler_catalog_count": 9858,
      "lazy_loading": true,
      "catalog_url": "https://developers.cognethics.com/reference/api/public-catalog.json",
      "note": "The mega-tools are the typed entry points; discover operations at runtime with prism_introspect, or read the public catalog summary at catalog_url. Availability of an operation is determined by your organization's permissions."
    },
    "resources": {
      "enabled": false
    },
    "prompts": {
      "enabled": false
    }
  },
  "authentication": {
    "method": "oauth2",
    "oauth2_config": {
      "server_url": "https://developers.cognethics.com",
      "client_registration_endpoint": "/api/mcp/oauth/register/",
      "authorization_endpoint": "/api/mcp/oauth/authorize/",
      "token_endpoint": "/api/mcp/oauth/token/",
      "revoke_endpoint": "/api/mcp/oauth/revoke/",
      "userinfo_endpoint": "/api/mcp/oauth/userinfo/",
      "discovery_endpoint": "/.well-known/oauth-authorization-server",
      "openid_configuration_endpoint": "/.well-known/openid-configuration",
      "jwks_endpoint": "/.well-known/jwks.json",
      "pkce": "S256",
      "dynamic_client_registration": true,
      "grant_types": [
        "authorization_code",
        "refresh_token"
      ],
      "scopes": {
        "mcp:read": "Read MCP resources and tool metadata",
        "mcp:write": "Modify MCP resources and settings",
        "mcp:execute": "Execute MCP tools"
      }
    },
    "fallback_method": "api_key",
    "api_key_config": {
      "server_url": "https://developers.cognethics.com",
      "register_endpoint": "/api/mcp/api-keys/register/",
      "header_name": "Authorization",
      "header_format": "Bearer {key}",
      "revoke_endpoint": "/api/mcp/api-keys/{key_id}/revoke/"
    }
  },
  "transport": {
    "type": "streamable_http",
    "endpoint": "https://developers.cognethics.com/api/mcp/mcp",
    "sse_endpoint": "https://developers.cognethics.com/api/mcp/sse",
    "method": "POST",
    "accept_header": "application/json, text/event-stream",
    "description": "MCP over HTTP with JSON-RPC framing (streamable-http, multi-worker safe). An SSE endpoint is also available. Authenticated requests run against your own tenant subdomain (https://{your-tenant}.cognethics.com)."
  },
  "organization_context": {
    "required": false,
    "header": "X-Organization-Context",
    "description": "Optional organization UUID for multi-org tenants. Defaults to the authenticated user's primary organization.",
    "format": "UUID"
  },
  "workspace_access": {
    "model": "provisioned",
    "docs_url": "https://developers.cognethics.com/signup/",
    "description": "Workspaces are provisioned for an identified principal and configured for their team \u2014 credentials and tenant data on a governed platform are not minted for an anonymous caller. Get one set up, then mint and rotate scoped API keys yourself from the dashboard.",
    "steps": [
      "Request a workspace at https://developers.cognethics.com/signup/ (who you are + what you're building)",
      "Sign in to the dashboard at https://platform.cognethics.com/dashboard/ once your workspace is provisioned",
      "Mint a scoped ck_ API key (or register an OAuth client) from the dashboard",
      "Authenticate every call with Authorization: Bearer <your-key>"
    ]
  },
  "quick_start": {
    "step1_register_oauth_client": {
      "endpoint": "https://developers.cognethics.com/api/mcp/oauth/register/",
      "example": {
        "method": "POST",
        "body": {
          "client_name": "My AI Assistant",
          "redirect_uris": [
            "http://localhost:3000/callback"
          ]
        },
        "response": {
          "client_id": "...",
          "client_secret": "(store securely)"
        }
      }
    },
    "step2_authorize": {
      "endpoint": "https://developers.cognethics.com/api/mcp/oauth/authorize/",
      "example": {
        "method": "GET",
        "url": "https://developers.cognethics.com/api/mcp/oauth/authorize/?client_id=...&scope=mcp:read+mcp:execute&redirect_uri=..."
      }
    },
    "step3_exchange_code_for_token": {
      "endpoint": "https://developers.cognethics.com/api/mcp/oauth/token/",
      "example": {
        "method": "POST",
        "body": {
          "grant_type": "authorization_code",
          "code": "...",
          "client_id": "...",
          "client_secret": "..."
        },
        "response": {
          "access_token": "...",
          "token_type": "Bearer",
          "expires_in": 3600
        }
      }
    },
    "step4_connect_to_mcp": {
      "endpoint": "https://developers.cognethics.com/api/mcp/mcp",
      "example": {
        "method": "POST",
        "headers": {
          "Authorization": "Bearer {access_token}",
          "Accept": "application/json, text/event-stream"
        },
        "body": {
          "jsonrpc": "2.0",
          "id": 1,
          "method": "initialize",
          "params": {
            "protocolVersion": "2025-03-26",
            "capabilities": {},
            "clientInfo": {
              "name": "Claude",
              "version": "1.0"
            }
          }
        }
      }
    },
    "step5_list_tools": {
      "example": {
        "method": "POST",
        "body": {
          "jsonrpc": "2.0",
          "id": 2,
          "method": "tools/list",
          "params": {}
        }
      }
    }
  },
  "tool_categories": [
    {
      "id": "agents",
      "display_name": "AI Agents"
    },
    {
      "id": "agrapha",
      "display_name": "Agrapha"
    },
    {
      "id": "app_builder",
      "display_name": "App Builder"
    },
    {
      "id": "assessments",
      "display_name": "Assessments Engine"
    },
    {
      "id": "billing",
      "display_name": "Stripe Billing"
    },
    {
      "id": "cad",
      "display_name": "CAD"
    },
    {
      "id": "conformity",
      "display_name": "Conformity"
    },
    {
      "id": "core",
      "display_name": "Core"
    },
    {
      "id": "crm",
      "display_name": "CRM"
    },
    {
      "id": "dashboard",
      "display_name": "Dashboard"
    },
    {
      "id": "data_mapping",
      "display_name": "Data Mapping"
    },
    {
      "id": "documents",
      "display_name": "Documents"
    },
    {
      "id": "ehr",
      "display_name": "EHR"
    },
    {
      "id": "equipment_register",
      "display_name": "Equipment Register"
    },
    {
      "id": "events",
      "display_name": "Events"
    },
    {
      "id": "feature_requests",
      "display_name": "Feature Requests"
    },
    {
      "id": "finance",
      "display_name": "Finance Module"
    },
    {
      "id": "grc",
      "display_name": "GRC"
    },
    {
      "id": "healthcare",
      "display_name": "Healthcare Management"
    },
    {
      "id": "hr",
      "display_name": "HR"
    },
    {
      "id": "hr_offboarding",
      "display_name": "HR - Offboarding"
    },
    {
      "id": "hr_onboarding",
      "display_name": "HR - Onboarding"
    },
    {
      "id": "hr_recruiting",
      "display_name": "HR - Recruiting (ATS)"
    },
    {
      "id": "icon_library",
      "display_name": "Icon Library"
    },
    {
      "id": "ics",
      "display_name": "ICS"
    },
    {
      "id": "identity_access",
      "display_name": "Identity Access"
    },
    {
      "id": "identity_provider",
      "display_name": "Identity Provider"
    },
    {
      "id": "infosec",
      "display_name": "Information Security"
    },
    {
      "id": "integrations",
      "display_name": "Security Integrations"
    },
    {
      "id": "inventory",
      "display_name": "Inventory Foundation"
    },
    {
      "id": "inventory_turns",
      "display_name": "Inventory Turns"
    },
    {
      "id": "investigation",
      "display_name": "Investigation Management"
    },
    {
      "id": "investigation_service",
      "display_name": "Investigation Service"
    },
    {
      "id": "itsm",
      "display_name": "ITSM"
    },
    {
      "id": "labor_marketplace",
      "display_name": "Labor Marketplace"
    },
    {
      "id": "laboratory",
      "display_name": "Laboratory"
    },
    {
      "id": "legal",
      "display_name": "Legal Contract Lifecycle Management"
    },
    {
      "id": "lms",
      "display_name": "LMS"
    },
    {
      "id": "marketing",
      "display_name": "Marketing"
    },
    {
      "id": "marketplace",
      "display_name": "Marketplace"
    },
    {
      "id": "matters",
      "display_name": "Matters, clients and ethical walls"
    },
    {
      "id": "mcp",
      "display_name": "MCP Integration"
    },
    {
      "id": "mdm",
      "display_name": "Mobile Device Management"
    },
    {
      "id": "notifications",
      "display_name": "Notifications"
    },
    {
      "id": "obligations",
      "display_name": "Obligations (shared calendar, alerts, rule registry)"
    },
    {
      "id": "pmo",
      "display_name": "Project Management Office"
    },
    {
      "id": "property_management",
      "display_name": "Property Management"
    },
    {
      "id": "risk_assessment",
      "display_name": "Risk Assessment Module"
    },
    {
      "id": "schematics",
      "display_name": "Schematic Intelligence"
    },
    {
      "id": "security_analytics",
      "display_name": "Security Analytics"
    },
    {
      "id": "sf_ops",
      "display_name": "Deal Ledger"
    },
    {
      "id": "sf_portfolio",
      "display_name": "Sf Portfolio"
    },
    {
      "id": "spare_parts",
      "display_name": "Asset Operations"
    },
    {
      "id": "structure_ledger",
      "display_name": "Structure Ledger"
    },
    {
      "id": "studio",
      "display_name": "Studio"
    },
    {
      "id": "territory",
      "display_name": "Territory Management"
    },
    {
      "id": "transitional_living",
      "display_name": "Transitional Living Program"
    },
    {
      "id": "vc",
      "display_name": "VC"
    },
    {
      "id": "vrm",
      "display_name": "Vendor Risk Management"
    }
  ],
  "support": {
    "documentation": "https://developers.cognethics.com/reference/",
    "recipes": "https://developers.cognethics.com/recipes/",
    "for_agents": "https://developers.cognethics.com/for-agents/",
    "openapi_descriptor": "https://developers.cognethics.com/.well-known/openapi.json",
    "openapi_descriptor_note": "Anonymous: the invocation envelope. With your key: the full per-operation descriptor.",
    "tool_catalog": "https://developers.cognethics.com/reference/api/public-catalog.json"
  }
}