closecadence-mcp 0.2.0 → 0.2.1

package/README.md

@@ -4,11 +4,11 @@ Use your **Close Cadence** real-estate tools from your own Claude. This is a tin
 Claude (Desktop / Code) call your Close Cadence tools — listings, CMAs, social, follow-ups, flyers,
 photo enhancement — directly, in your saved voice, on your plan's credits.
 
-It's a thin client: it only forwards your authenticated requests to `closecadence.ai`. No tool logic or
+It's a thin client: it only forwards your authenticated requests to `tools.closecadence.com`. No tool logic or
 data lives in this package.
 
 ## Setup (about 1 minute)
-1. Get your key in the portal → **API key** (format `cck.cus_….…`).
+1. Get your key in the portal → **Use in Claude** (format `cck.cus_….…`).
 2. Add this to your Claude config (Claude Desktop → Settings → Developer → Edit Config):
 
 ```json

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "closecadence-mcp",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Use your Close Cadence real-estate tools from your own Claude (MCP server).",
   "type": "module",
   "bin": { "closecadence-mcp": "src/index.js" },

package/src/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 // Close Cadence MCP server — lets an agent's own Claude call the Close Cadence tools.
-// THIN CLIENT ONLY: it proxies authenticated calls to the licensed API at closecadence.ai. No business
+// THIN CLIENT ONLY: it proxies authenticated calls to the licensed API at tools.closecadence.com. No business
 // logic, prompts, or comp/CMA data live here (that's protected, server-side IP) — this just forwards the
 // agent's key + inputs and returns the result. Auth: env CC_API_KEY (cck.cus_xxx.yyy). stdio transport.
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
@@ -10,7 +10,7 @@ import { writeFileSync, mkdirSync, readFileSync, existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
 
-const API = process.env.CC_API_BASE || 'https://closecadence.ai';
+const API = process.env.CC_API_BASE || 'https://tools.closecadence.com';
 const KEY = process.env.CC_API_KEY || '';
 
 // ---- Pillar 2: brand + market profiles travel with every job ----
@@ -50,8 +50,8 @@ const errText = (m) => ({ content: [{ type: 'text', text: m }], isError: true })
 async function handle(r) {
   let j = {};
   try { j = await r.json(); } catch { /* non-JSON */ }
-  if (r.status === 401) return errText('Your Close Cadence membership isn’t active, or the key is invalid. Renew or rotate your key in the portal (closecadence.ai/portal → API key).');
-  if (r.status === 402) return errText((j && j.error) || 'You’re out of credits for this month. Top up at closecadence.ai/portal → Credits (or turn on auto-refill).');
+  if (r.status === 401) return errText('Your Close Cadence membership isn’t active, or the key is invalid. Renew or rotate your key in the portal (tools.closecadence.com/portal → Use in Claude).');
+  if (r.status === 402) return errText((j && j.error) || 'You’re out of credits for this month. Top up at tools.closecadence.com/portal → Credits (or turn on auto-refill).');
   if (r.status === 429) return errText((j && j.error) || 'Rate limited, or this key was flagged for use from too many places. Try again shortly, or rotate it in the portal.');
   if (r.status === 503) return errText((j && j.error) || 'This tool is being set up — check back shortly.');
   if (!r.ok || (j && j.error)) return errText((j && j.error) || ('Close Cadence error ' + r.status + '.'));
@@ -60,7 +60,7 @@ async function handle(r) {
 }
 
 function requireKey() {
-  return KEY ? null : errText('No CC_API_KEY set. Add your Close Cadence key (portal → API key) to the MCP config "env", e.g. { "CC_API_KEY": "cck...." }.');
+  return KEY ? null : errText('No CC_API_KEY set. Add your Close Cadence key (portal → Use in Claude) to the MCP config "env", e.g. { "CC_API_KEY": "cck...." }.');
 }
 async function callTool(tool, inputs) {
   const miss = requireKey(); if (miss) return miss;
@@ -98,6 +98,7 @@ const NAMED = [
   ['cc_open_house', 'open-house-kit', 'Open-house kit: social + email + neighbor invite + visitor follow-up.', 'address, details'],
   ['cc_prospecting', 'prospecting', 'Expired / FSBO outreach: letter + call script + texts.', 'type, context'],
   ['cc_listing_presentation', 'listing-presentation', 'Win-the-listing presentation content, slide by slide.', 'address, property, seller_goal, market, differentiators'],
+  ['cc_avatar_report', 'avatar-marketing-report', 'Two-presenter AI-avatar marketing report script from your numbers (Studio) — feeds the avatar video renderer.', 'agent_name, co_presenter, market, period, total_volume, sales_count, avg_price, top_sale, wins, focus'],
 ];
 for (const [name, id, desc, fields] of NAMED) {
   server.registerTool(
@@ -118,6 +119,12 @@ server.registerTool('cc_property', { title: 'cc_property', description: 'Propert
 server.registerTool('cc_flyer', { title: 'cc_flyer', description: 'Generate a "just listed" card / flyer image (readable text).', inputSchema: { prompt: z.string().optional(), headline: z.string().optional() } }, async (a) => callPath('/api/media/flyer', a));
 server.registerTool('cc_enhance', { title: 'cc_enhance', description: 'Enhance a listing photo (sky replacement / HDR / declutter).', inputSchema: { imageUrl: z.string().url() } }, async (a) => callPath('/api/media/enhance', a));
 
+// Avatar Studio (Studio tier): generate a branded talking-head marketing VIDEO or REEL in your own
+// voice from your numbers. Rendering is async — cc_avatar_render enqueues + returns a job id; poll
+// cc_avatar_status for the finished video url. Each render uses plan credits (video 500 / reel 120).
+server.registerTool('cc_avatar_render', { title: 'cc_avatar_render', description: 'Generate an on-brand AI-avatar marketing VIDEO or REEL in your voice from your numbers (Studio). Async — returns a job id; poll cc_avatar_status. Uses plan credits.', inputSchema: { kind: z.enum(['report', 'reel']).optional().describe('report (full) or reel (short)'), fmt: z.enum(['video', 'reel']).optional().describe('video = 16:9, reel = 9:16') } }, async ({ kind, fmt }) => callPath('/api/avatar/request', { kind: kind || 'report', fmt: fmt || (kind === 'reel' ? 'reel' : 'video') }));
+server.registerTool('cc_avatar_status', { title: 'cc_avatar_status', description: 'Check an avatar render job by id (or omit to list your recent renders). Returns status + the finished video url when ready.', inputSchema: { job: z.string().optional().describe('job id from cc_avatar_render') } }, async ({ job }) => getPath('/api/avatar/status' + (job ? ('?job=' + encodeURIComponent(job)) : '')));
+
 // Discovery + escape hatch.
 server.registerTool('cc_list_tools', { title: 'cc_list_tools', description: 'List every Close Cadence tool available to your plan.', inputSchema: {} }, async () => {
   const miss = requireKey(); if (miss) return miss;