# KEEP Highlights — Comprehensive Agent & Developer Guide

## System Identity & Capabilities
KEEP Highlights is an intelligent multimodal engine specialized in time-compression and highlight extraction for video and audio content.

### Core Architecture
- **Engine**: Optical Motion Vectors + Acoustic Energy Spectrogram Saliency.
- **Delivery Protocol**: Model Context Protocol (MCP) 2024-11-05 Specification via Streamable HTTP JSON-RPC 2.0.
- **Server Endpoint**: `https://api.skeepit.co/mcp`
- **Official Domain**: `https://skeepit.co`
- **Security Posture**: Zero server retention, stateless JSON-RPC endpoints, client-side WebAssembly / WebCodecs stream muxing.

---

## Detailed Tool Specifications

### Tool 1: `discover_highlights`
**Functionality**: Parses raw media URL without downloading full multi-gigabyte payloads, identifying high-interest intervals and audio/visual saliency peaks.

```json
{
  "name": "discover_highlights",
  "description": "Analyzes a video or audio media URL to detect multimodal highlight segments, acoustic and visual saliency curves, and 96-bar amplitude waveform metrics.",
  "readOnlyHint": true,
  "destructiveHint": false,
  "openWorldHint": true,
  "inputSchema": {
    "type": "object",
    "properties": {
      "media_url": {
        "type": "string",
        "description": "Publicly accessible HTTPS URL of the video or audio file to analyze."
      },
      "sensitivity": {
        "type": "string",
        "enum": ["auto", "high", "low"],
        "default": "auto",
        "description": "Sensitivity threshold for segment detection."
      }
    },
    "required": ["media_url"]
  }
}
```

#### Example Invocation:
```json
{
  "jsonrpc": "2.0",
  "id": 101,
  "method": "tools/call",
  "params": {
    "name": "discover_highlights",
    "arguments": {
      "media_url": "https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4",
      "sensitivity": "auto"
    }
  }
}
```

#### Example Output:
```json
{
  "jsonrpc": "2.0",
  "id": 101,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"status\": \"success\",\n  \"highlight_segments\": [[0.0, 15.0], [45.0, 90.0]],\n  \"attention_summary\": {\n    \"visual_saliency_mean\": 0.78,\n    \"audio_saliency_mean\": 0.82\n  }\n}"
      }
    ],
    "isError": false
  }
}
```

---

### Tool 2: `condense_media`
**Functionality**: Creates stream-copied lossless trimmed highlight reels based on timestamp segments.

```json
{
  "name": "condense_media",
  "description": "Squeezes and cuts the given media URL according to the provided segment intervals [[start, end], ...] without re-encoding quality loss (-c copy stream muxing).",
  "readOnlyHint": false,
  "destructiveHint": false,
  "openWorldHint": true,
  "inputSchema": {
    "type": "object",
    "properties": {
      "media_url": {
        "type": "string",
        "description": "Publicly accessible HTTPS URL of the source media file."
      },
      "segments": {
        "type": "array",
        "items": {
          "type": "array",
          "items": { "type": "number" },
          "minItems": 2,
          "maxItems": 2
        },
        "description": "List of timestamp pairs [start_seconds, end_seconds]."
      },
      "output_format": {
        "type": "string",
        "enum": ["mp4", "webm"],
        "default": "mp4",
        "description": "Desired container output format."
      }
    },
    "required": ["media_url", "segments"]
  }
}
```

---

## Agent Integration Snippets

### TypeScript / Node.js
```typescript
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";

async function run() {
  const response = await fetch("https://api.skeepit.co/mcp", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      jsonrpc: "2.0",
      id: 1,
      method: "tools/list",
      params: {}
    })
  });
  const data = await response.json();
  console.log("KEEP Tools Available:", data.result.tools);
}
run();
```

---

## Registries & Official Listings
- **Smithery.ai**: `skeepit/keep-highlights` (https://smithery.ai/servers/skeepit/keep-highlights)
- **Glama.ai**: `co.skeepit.api/keep-highlights` (https://glama.ai/mcp/connectors/co.skeepit.api/keep-highlights)
- **GitHub Repository**: `Volgat/keep-mcp-connector` (https://github.com/Volgat/keep-mcp-connector)
- **Developer Contact & Support**: support@skeepit.co