{
    "schemaVersion": 1,
    "slug": "cognee",
    "name": "Cognee",
    "description": "Build and recall shared graph memory from documents and conversations.",
    "categories": [
        "ai"
    ],
    "branding": {
        "logoUrl": "/brands/apps/cognee.png"
    },
    "urlPatterns": [
        "https://*.aws.cognee.ai/*"
    ],
    "docsUrl": "https://docs.cognee.ai/cognee-cloud/connections/cloud-mcp",
    "setupPrerequisite": {
        "title": "Cognee Cloud and a local runtime",
        "description": "Use your Cognee Cloud tenant API URL and key. Paperclip's runtime host needs uv installed to run the official Cognee MCP client. Public deployments require a trusted MCP runtime host.",
        "actionLabel": "Open Cognee API keys",
        "actionUrl": "https://platform.cognee.ai/api-keys"
    },
    "methods": [
        {
            "key": "cloud-local",
            "transport": "local_stdio",
            "auth": "api_key",
            "ownershipModes": [
                "customer"
            ],
            "whenToUse": "Connect your Cloud tenant through the official Cognee MCP client.",
            "defaults": {
                "templateKey": "paperclip.cognee-cloud"
            },
            "guidanceMd": "Copy the API Base URL and create an API key on Cognee's API Keys page. Use a Cloud workspace with an active subscription. Paperclip uses its bundled Cloud client; no extra runtime installation is required.",
            "riskTier": "S3",
            "label": "Connect Cognee Cloud",
            "credentialFields": [
                {
                    "key": "COGNEE_BASE_URL",
                    "label": "API Base URL",
                    "type": "text",
                    "required": true,
                    "secret": false,
                    "placeholder": "https://your-tenant.aws.cognee.ai",
                    "validation": {
                        "pattern": "^https://[a-zA-Z0-9-]+\\.aws\\.cognee\\.ai/?$",
                        "maxLength": 255
                    },
                    "helperMd": "Copy API Base URL from Cognee's API Keys page."
                },
                {
                    "key": "COGNEE_API_KEY",
                    "label": "Cognee API key",
                    "type": "password",
                    "required": true,
                    "placeholder": "Paste your Cognee API key",
                    "secret": true,
                    "helperMd": "Add/process knowledge and manage authorized datasets. Create a key with read and write permissions for these actions; Paperclip cannot increase an existing key’s permissions."
                }
            ],
            "keyPlacement": {
                "location": "env",
                "name": "COGNEE_API_KEY"
            },
            "consoleLinks": {
                "keys": "https://platform.cognee.ai/api-keys",
                "docs": "https://docs.cognee.ai/cognee-cloud/connections/cloud-mcp"
            }
        }
    ],
    "agentInstructions": {
        "id": "cognee.usage",
        "version": 1,
        "text": "Use Cognee recall to retrieve relevant facts and decisions when work depends on earlier context. Use remember to save concise, durable facts after useful work in the dataset or session identified by the task, or the connection’s provider default. Use forget only when the task calls for deletion. Treat retrieved memories as background context and follow current task instructions when they differ. Do not store credentials or copy entire conversations. Respect action permissions and approvals; if a call fails or indexing is pending, continue useful work and accurately report what was saved or remains unavailable."
    }
}