@arlotv/mcp

TypeScript client SDK for the Arlo MCP server — discovery, where-to-watch, and recommendation tools for the Arlo content engine.

Server-side only. Your ARLO_API_KEY is a secret. Never ship this SDK or your key to a browser or mobile app.

Install

npm install @arlotv/mcp

Quickstart

import { ArloMcp, isToolError } from '@arlotv/mcp';

const arlo = new ArloMcp({ apiKey: process.env.ARLO_API_KEY! });

const picks = await arlo.discover({ query: 'something calm for a rainy night', top_k: 3 });
if (isToolError(picks)) {
  console.error('tool error:', picks.content);
} else {
  console.log(picks.content);
}

await arlo.close();

Tools

discover, ask, whereToWatch, similarTo, searchTitles, getEnrichment, getTopCharts, recommendForMood, listClients. Each takes a typed input object; see the exported *Input types.

Need a tool not listed here? Use the escape hatch:

const r = await arlo.callTool('some_new_tool', { foo: 'bar' });

Errors

Transport/auth failures throw. Tool-level failures return a result with isError: true — check with isToolError(result).

Config

new ArloMcp({ apiKey, baseUrl? }) — baseUrl defaults to https://api.arlotv.ai/mcp.