Spur MCP server
Connects Spur to Claude and ChatGPT. Users sign in with their Spur account and can then search properties, skip-trace owners, run outreach, and design email and SMS templates and the outreach workflows that send them, and design and mail postcards and letters from the chat. Interactive widgets render inline:
- Property explorer: a price-pin map with property cards, plus Save, Details and Find owner buttons.
- Property detail: the same widget showing a single property.
- Postcard preview: front and back artwork filled with a real recipient's data, the recipient count and the cost, plus a Send button that asks for confirmation first.
- Billing: wallet balance with one-click top-ups ($25/$50/$100 or any amount), plan cards with a monthly/annual toggle and Upgrade buttons, auto-recharge, and a Stripe hand-off with an "I've paid: check" button.
- Email and SMS preview: an email as it lands in an inbox (subject, sender, preheader snippet; desktop, mobile and plain-text views) or a text as a phone bubble with its segment count, plus merge fields and design checks.
The widgets follow the MCP Apps standard. Claude renders it natively, and ChatGPT's Apps SDK uses it as its widget format, so one implementation serves both hosts. The resources also carry ChatGPT's legacy openai/* metadata keys.
Claude / ChatGPT ──OAuth──▶ spur-mcp-server (/mcp) ──user's Spur JWT──▶ Spur backend (/api/*)
│
└─ ui://spur/*.html widgets (served as MCP resources)
The server keeps no data of its own. Every tool calls the existing Spur REST API with the signed-in user's own Spur session. That means Spur's RBAC, per-user data isolation, billing checks and audit logs apply to every call unchanged. All Spur calls carry X-Spur-Client: mcp.
Tools
| Area | Tools | Notes |
|---|
| Find deals | spur_search_properties 🗺, spur_get_property 🗺, spur_save_properties, spur_list_saved_properties 🗺, spur_get_property_stats | Search uses 1 property-search credit |
| Owners | spur_find_owners, spur_get_owner, spur_enrich 💲 | Enrichment = skip-trace credits |
| Lists | spur_list_property_lists, spur_create_property_list, spur_add_properties_to_list | |
| Outreach | spur_draft_message, spur_list_workflows, spur_get_workflow, spur_create_workflow, spur_set_workflow_step_template, spur_set_workflow_active 💲, spur_enroll_owners_in_workflow 💲, spur_send_sms 💲 | Drafting never sends; new workflows are inactive drafts |
| Email & SMS templates | spur_list_message_templates, spur_get_message_template, spur_preview_message_template ✉️, spur_preview_message_draft ✉️, spur_create_email_template ✉️, spur_update_email_template ✉️, spur_create_sms_template ✉️, spur_update_sms_template ✉️, spur_delete_message_template, spur_send_test_email 💲 | See below; the test email only goes to the user's own inbox |
| Inbox | spur_list_sms_conversations, spur_get_sms_conversation | |
| Postcards | spur_list_postcard_templates, spur_get_postcard_template, spur_preview_postcard_template 🖼, spur_create_postcard_template 🖼, spur_update_postcard_template 🖼, spur_delete_postcard_template, spur_list_return_addresses, spur_preview_postcard_campaign 🖼, spur_send_postcards 💲 | See below |
| QR codes | spur_list_qr_codes, spur_create_qr_code, spur_update_qr_code, spur_delete_qr_code, , 🖼, 🖼 |
🗺 property explorer widget · 🖼 mail preview widget (postcards and letters) · ✉️ email/SMS preview widget · 📤 image upload widget · 💳 billing widget · 💲 spends money or contacts people
There are also four resources, spur://merge-variables, spur://postcard-design-guide, spur://letter-design-guide and spur://email-design-guide, plus prompts including deal hunt, follow up hot leads, outreach sequence, postcard campaign, letter campaign, and weekly review.
Email and SMS templates
These are the same communication_templates rows (type email or sms) that Spur → Outreach uses, and the templates that workflow send_email / send_sms steps send.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
