closecadence-mcp 0.1.0

package/README.md

@@ -0,0 +1,43 @@
+# closecadence-mcp
+
+Use your **Close Cadence** real-estate tools from your own Claude. This is a tiny MCP server that lets
+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
+data lives in this package.
+
+## Setup (about 1 minute)
+1. Get your key in the portal → **API key** (format `cck.cus_….…`).
+2. Add this to your Claude config (Claude Desktop → Settings → Developer → Edit Config):
+
+```json
+{
+  "mcpServers": {
+    "closecadence": {
+      "command": "npx",
+      "args": ["-y", "closecadence-mcp"],
+      "env": { "CC_API_KEY": "cck.PASTE_YOUR_KEY" }
+    }
+  }
+}
+```
+3. Restart Claude. Now ask things like *"write a just-listed package for 412 Bayview Dr, $1.15M, 4-bed ocean view"* — Claude uses your tools, in your voice.
+
+## Tools
+- `cc_listing`, `cc_cma`, `cc_social`, `cc_email`, `cc_followup`, `cc_market_report`, `cc_open_house`, `cc_prospecting`, `cc_listing_presentation`
+- `cc_comps`, `cc_property` (property data) · `cc_flyer`, `cc_enhance` (media)
+- `cc_list_tools` (what's on your plan) · `cc_run` (any tool by id)
+
+If your membership lapses or you run out of credits, the tools say so clearly and point you to the portal.
+
+## Develop / test
+```bash
+npm install
+npx @modelcontextprotocol/inspector node src/index.js   # set CC_API_KEY in env first
+```
+Point `CC_API_BASE` at a preview deploy to test against staging.
+
+## Publish (maintainers)
+`npm publish --access public` (requires npm auth). After publishing, the portal's "Use in your own Claude"
+config (`npx -y closecadence-mcp`) works as shown above.

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "closecadence-mcp",
+  "version": "0.1.0",
+  "description": "Use your Close Cadence real-estate tools from your own Claude (MCP server).",
+  "type": "module",
+  "bin": { "closecadence-mcp": "src/index.js" },
+  "files": ["src", "README.md"],
+  "engines": { "node": ">=18" },
+  "keywords": ["mcp", "claude", "real-estate", "closecadence"],
+  "license": "UNLICENSED",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  }
+}

package/src/index.js

@@ -0,0 +1,88 @@
+#!/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
+// 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';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+
+const API = process.env.CC_API_BASE || 'https://closecadence.ai';
+const KEY = process.env.CC_API_KEY || '';
+
+const errText = (m) => ({ content: [{ type: 'text', text: m }], isError: true });
+
+// Turn an API response into MCP content, surfacing license/credit problems clearly.
+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 === 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 + '.'));
+  const out = j && j.result !== undefined ? j.result : j;
+  return { content: [{ type: 'text', text: typeof out === 'string' ? out : JSON.stringify(out, null, 2) }] };
+}
+
+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...." }.');
+}
+async function callTool(tool, inputs) {
+  const miss = requireKey(); if (miss) return miss;
+  try {
+    const r = await fetch(API + '/api/tool', { method: 'POST', headers: { 'content-type': 'application/json', 'x-api-key': KEY }, body: JSON.stringify({ tool, inputs: inputs || {} }) });
+    return await handle(r);
+  } catch (e) { return errText('Could not reach Close Cadence: ' + String(e && e.message || e)); }
+}
+async function callPath(path, body) {
+  const miss = requireKey(); if (miss) return miss;
+  try {
+    const r = await fetch(API + path, { method: 'POST', headers: { 'content-type': 'application/json', 'x-api-key': KEY }, body: JSON.stringify(body || {}) });
+    return await handle(r);
+  } catch (e) { return errText('Could not reach Close Cadence: ' + String(e && e.message || e)); }
+}
+
+const server = new McpServer({ name: 'closecadence', version: '0.1.0' });
+
+// Curated, named AI tools (Claude sees clear options). `inputs` is an object — the description lists the
+// useful fields. Everything runs server-side in the agent's saved voice and uses their plan credits.
+const NAMED = [
+  ['cc_listing', 'listing-engine', 'Full listing marketing package: MLS remarks, long description, social posts, hooks.', 'address, price, beds, baths, sqft, features'],
+  ['cc_cma', 'cma-narrative', 'CMA pricing narrative + objection handling from comps (pair with cc_comps for real data).', 'address, comps, suggested_price, seller_expectation, market'],
+  ['cc_social', 'brand-post', 'On-brand social post in your voice (not a listing promo).', 'topic'],
+  ['cc_email', 'email-writer', 'Client email — subject + body (market update, just-listed, nurture).', 'purpose, details'],
+  ['cc_followup', 'followup-sequence', '5-touch text + email follow-up sequence for a lead.', 'lead_type, context'],
+  ['cc_market_report', 'market-report', 'Neighborhood / market report from stats (uses only the numbers you give).', 'area, stats'],
+  ['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'],
+];
+for (const [name, id, desc, fields] of NAMED) {
+  server.registerTool(
+    name,
+    {
+      title: name,
+      description: desc + ' Pass an `inputs` object with: ' + fields + '. Runs in your saved voice; uses plan credits.',
+      inputSchema: { inputs: z.record(z.any()).describe('Tool inputs — ' + fields) },
+      annotations: { readOnlyHint: false, openWorldHint: true },
+    },
+    async ({ inputs }) => callTool(id, inputs),
+  );
+}
+
+// Data + media tools (live once the provider keys are configured; until then they report "being set up").
+server.registerTool('cc_comps', { title: 'cc_comps', description: 'Pull comparable sales + an AVM for an address — the real data behind a CMA.', inputSchema: { address: z.string().describe('Full property address') } }, async ({ address }) => callPath('/api/data/comps', { address }));
+server.registerTool('cc_property', { title: 'cc_property', description: 'Property records for an address (tax, owner, characteristics, sales history).', inputSchema: { address: z.string() } }, async ({ address }) => callPath('/api/data/property', { address }));
+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));
+
+// 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;
+  try { return await handle(await fetch(API + '/api/tool', { headers: { 'x-api-key': KEY } })); }
+  catch (e) { return errText('Could not reach Close Cadence: ' + String(e && e.message || e)); }
+});
+server.registerTool('cc_run', { title: 'cc_run', description: 'Run ANY Close Cadence tool by id with an inputs object. Prefer the specific cc_* tools when one fits.', inputSchema: { tool: z.string().describe('Tool id, e.g. bio-builder'), inputs: z.record(z.any()).optional() } }, async ({ tool, inputs }) => callTool(tool, inputs));
+
+await server.connect(new StdioServerTransport());