Spur
Server Details
Real estate leads, skip tracing, direct mail, SMS & email outreach, and marketing automations
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 154 tools
The surface has many overlapping families: generic fetch/search vs. specific get/list tools, multiple campaign manage/preview/send/dispatch paths, and several search/data-job/table tools that are easy to confuse. Detailed descriptions help, but with 154 tools an agent will often struggle to choose the right boundary.
Nearly all tools use a consistent snake_case spur_verb_noun pattern (spur_get_owner, spur_list_workflows, spur_create_postcard_template). The main deviations are the two unprefixed generic tools, fetch and search, plus some synonym verbs like manage/control/update, but the overall convention is readable and predictable.
154 tools is far beyond the appropriate range for a single server and is an extreme mismatch for the apparent scope. Even though the platform is broad, this should be split into smaller coherent tool sets or consolidated into fewer multi-action tools.
Coverage is extensive across properties, owners, lists, templates, workflows, campaigns, billing, texting, QR codes, data providers, and analytics, with create/read/update/delete/preview/send operations present. Some operations are buried inside broad manage/control tools, but there are no obvious major dead ends.
Publisher details
- Operator
- Spur · Publisher source
- Operator website
- https://usespur.com
- Vendor relationship
- Not available
- Documentation
- Not available
- Privacy policy
- Not provided
- Trust center
- Not available
- Restrictions
- Not available
Available Tools
154 toolsfetchFetch Spur recordARead-onlyIdempotentInspect
Fetch a record returned by search, including list, workflow, table, job, letter, message_template or personalization IDs.
Inputs: id (required).
searchSearch SpurARead-onlyIdempotentInspect
Search the user's saved Spur properties, owners, lists, workflows, research jobs/tables and templates by keyword (address, city, owner name, phone, email, template name). Returns ids for the fetch tool. For new properties use spur_data_search.
Inputs: query (required), limit, offset, list_id.
spur_add_manual_propertiesAdd properties or import mapped rowsAInspect
Preview a typed address for free, create a property with manually supplied facts/contacts, or import up to 100 mapped rows from CSV. No provider lookup. CSV rows use the documented address/details/owner shape; do not invent missing data.
spur_add_postcard_qr_codeAdd QR code to postcardAIdempotentInspect
Put a tracked QR code on the back of one of the user's postcard templates and show the preview. Each mailed postcard gets its own code under the chosen QR code, so scans are tracked per recipient (spur_get_qr_code_activity).
Placement: position="auto" fills the back's QR slot (an element with class qr-box, qr-code-box, qr-placeholder or qr-callout-box, as Spur's gallery designs have) and otherwise goes in the bottom-right of the message area, left of the address block and above the USPS barcode. Corners (top_left, top_right, bottom_left, bottom_right) and x_inches/y_inches place it in the message area; spots in the USPS clear zone are refused. Replaces any QR already on the card. If it lands on the message text, call again with another corner or move the text.
Create a QR code first with spur_create_qr_code if spur_list_qr_codes has none that fits.
Inputs: qr_code_id (required), template_id (required), position, x_inches, +2 more.
spur_add_properties_to_listAdd properties to listBIdempotentInspect
Add saved properties to an existing property list.
Inputs: list_id (required), property_ids (required).
spur_buy_credit_packBuy Data Credit or Action packsAInspect
Create a Stripe checkout link for metric packs at the account's current price. Adds dollars to the shared wallet; it does not increase monthly allowances or reserve units. Free accounts must upgrade. No charge occurs until the user pays on Stripe.
Inputs: metric_key (required), pack_count (required).
spur_buy_phone_numberBuy phone numberADestructiveInspect
Buy a local number for the user's account (it's theirs immediately and replies land in their SMS inbox). It can't send texts until their carrier registration is approved. Plans include some numbers; beyond that each costs $5/mo from the Spur wallet, first month charged now (spur_get_texting_setup shows the user's price). Tell the user the price and get explicit approval for this exact number first.
Inputs: confirm (required), phone_number (required), region, locality.
spur_calculate_mortgageCalculate mortgage paymentARead-onlyIdempotentInspect
Estimate the monthly payment on a home the way Zillow's mortgage calculator does: principal & interest, PMI, property tax, homeowners insurance and HOA, plus total interest and a yearly amortization schedule. Free and runs instantly.
Pass home_price, or property_id to use a saved Spur property's price (falls back to its Zestimate). Anything left out uses these defaults: 20% down, 30-year fixed, 6.25% rate, property tax 1.1% of price/yr, insurance 0.5% of price/yr, PMI 0.5% of the loan/yr when under 20% down (dropped at 78% loan-to-value). The default rate is a placeholder, not a live quote: tell the user which defaults were used and use their own rate when they give one.
Inputs: pmi_rate, home_price, term_years, hoa_monthly, +9 more.
spur_change_planUpgrade or change planADestructiveInspect
Moves the user to another Spur plan (ids from spur_show_billing_options; usually team or brokerage).
No paid subscription yet: returns a Stripe checkout link. No confirmation needed.
Already subscribed: switches the plan immediately and charges or credits the prorated difference to the saved card. Call once without confirm to get the exact change, ask the user to approve it, then call again with confirm=true.
Moving to the Free plan returns a billing-portal link where the user cancels the paid subscription.
Inputs: plan_id (required), confirm, action_tier, billing_interval, +1 more.
spur_check_paymentCheck paymentAIdempotentInspect
After the user pays a Stripe checkout link from spur_top_up_wallet or spur_change_plan, confirms the payment went through and returns the new wallet balance and plan. Safe to call repeatedly.
Inputs: session_id (required).
spur_check_property_dncCheck property phone numbers against DNCADestructiveInspect
Run approved DNC checks with the quoted credit ceiling. Retains suppression and partial results if a provider fails. Requires approval of the quote.
Inputs: confirm (required), max_credits (required), property_id (required).
spur_connect_list_automationConnect lists to outreach and searchesBDestructiveInspect
Link/unlink a workflow, enroll a whole list, attach/detach a search automation. Linking a workflow immediately enrolls current members. Approve the audience, workflow and future automatic outreach before connecting.
spur_control_data_jobPause, resume or cancel researchADestructiveInspect
Pause/cancel a job, or resume it with an optional revised budget. Resume can spend credits and requires confirm=true. Preserves completed results.
spur_control_mail_orderCancel mail or refresh trackingADestructiveInspect
Cancel an eligible order with its provider or request fresh tracking for one mailpiece. Cancellation availability is decided by Spur and the provider; never claim a delivered piece can be recalled.
spur_control_table_runRead, resume or cancel a column runADestructiveInspect
Get progress/changed rows, resume under a credit ceiling, or cancel. Resume requires approval and is safe to retry without double charging.
spur_create_email_templateCreate email templateAInspect
Save a new email template and show its inbox preview. Ways to start:
From blank: start_from_blank=true gives a tested 600px responsive layout with greeting, signature and a compliant footer; pass html to replace it.
Redesign: base_template_id copies one of the user's email templates.
From scratch: pass html (or only text_body for a plain-text email). The saved template can then be used by outreach workflows (spur_create_workflow / spur_set_workflow_step_template).
Email HTML guidance (see spur://email-design-guide): full HTML document, table-based layout 600px wide, inline styles on elements (a small block in is fine for resets/media queries), web-safe font stacks, no JavaScript, no forms, no external CSS. Images as absolute https URLs with alt text and width attributes. The user's own images (logo, headshot, property photos): spur_list_images gives their URLs; if they want to use an image they have, call spur_upload_image (or spur_save_image for a link) and use the saved URL. Use PNG or JPG in emails, not SVG. A hidden preheader right after sets the inbox snippet. Include an opt-out line ("Reply STOP" or an unsubscribe link) and the sender's postal address in the footer. Keep it under 50,000 characters. Use merge fields like {{owner_first_name}}, {{property_address}}, {{your_name}}, {{your_phone}}, {{company_name}} (see spur://merge-variables). The plain-text version is generated from the HTML unless you pass text_body.
Inputs: name (required), html, subject, text_body, +4 more.
spur_create_letter_templateCreate letter templateAInspect
Create a letter template and show a preview. Pick the letter type first (top_first_page or insert_blank_page); it decides where the address prints and how much of the page the design can use. Three ways to start:
From blank: start_from_blank=true gives an empty one-page letter laid out for the letter type.
Redesign an existing template: base_template_id (yours, a Spur default or a gallery id) copies its HTML and letter type; override html or letter_type as needed.
From scratch: pass html.
HTML guidance (see spur://letter-design-guide): one US Letter page (8.5"×11"), full HTML document with inline , "@page { size: 8.5in 11in; margin: 0; }", no scripts. One root 8.5in wide; px/in units only (no vh/vw); no box-shadow, transforms or manual page breaks. top_first_page: leave the first 3.15in blank (an empty ), body ≈ 3–4 short paragraphs. insert_blank_page: no address zone; letterhead up to 1.8in, body up to ~400 words. Images as absolute https URLs. The user's own images (logo, headshot, property photos): spur_list_images gives their URLs; if they want to use an image they have, call spur_upload_image (or spur_save_image for a link) and use the saved URL. Use merge fields such as {{owner_first_name}}, {{property_address}}, {{your_name}}, {{your_phone}}, {{company_name}} (see spur://merge-variables).
Inputs: name (required), html, category, description, +3 more.
spur_create_postcard_templateCreate postcard templateAInspect
Create a postcard template and show a preview. Three ways to start:
From blank: start_from_blank=true gives an empty, correctly sized canvas for the size (any side you pass HTML for replaces the blank side).
Redesign an existing template: base_template_id (yours, a Spur default or a gallery id) copies its HTML; override front_html/back_html/size as needed.
From scratch: pass both front_html and back_html.
HTML guidance (see spur://postcard-design-guide): full HTML documents, inline , no scripts. Fixed pixel sizing on html, body and a root .postcard at 300 px/in including 0.125" bleed: 6x4 → 1875×1275, 6x9 → 2775×1875, 6x11 → 3375×1875. Keep text 0.25" inside the edge. USPS clear zone on the back, measured from the bleed edges (Spur prints over it and covers anything there): postage 1.25"×1.25" in the top-right corner; address block 3.5"×2", 0.5" from the right edge and 1.35" from the top; USPS barcode strip 4.75"×0.625" along the bottom-right edge. Keep all text, logos, photos and QR codes out of it; a background color or texture under it is fine. The safe message area is left of the address block and above the barcode strip. Images as absolute https URLs. The user's own images (logo, headshot, property photos): spur_list_images gives their URLs; if they want to use an image they have, call spur_upload_image (or spur_save_image for a link) and use the saved URL. Use merge fields such as {{owner_first_name}}, {{property_address}}, {{your_name}}, {{your_phone}}, {{company_name}} (see spur://merge-variables). QR code box by default: unless the user says they don't want a QR code, every back you design includes an empty square in the message area (≥ 0.75in, e.g. 225×225 px at 300 px/in) with a short call to action beside it ("Scan to see your home's value"). Never write QR markup or {{qrUrl}} yourself: after saving, call spur_add_postcard_qr_code and the tracked QR fills the box (pick the code with spur_list_qr_codes, or ask the user where scans should go and spur_create_qr_code). When resending full back_html, keep the qr-box and any <img data-spur-qr-merge…> inside it, or the QR is dropped.
Inputs: name (required), size, category, back_html, +4 more.
spur_create_property_listCreate property listAInspect
Create a property list, optionally seeding it with saved property ids.
Inputs: name (required), description, property_ids.
spur_create_qr_codeCreate QR codeAInspect
Create a tracked QR code that sends scans to destination_url. Then add it to a postcard back with spur_add_postcard_qr_code; each mailed postcard gets its own code under it so scans are tracked per recipient.
Inputs: name (required), destination_url (required), background_color, foreground_color.
spur_create_search_automationCreate search automationADestructiveInspect
Schedule a recurring property search. Event automations default to the legacy engine to retain event tracking. Data-platform mode supports recipe_key/params/selections, credit budgets, unknown-result lists, automatic contacts with a credit cap and conditions, and channel outreach routes. Each enabled run spends credits/actions and can contact people; approve the settings before enabling. Use params={source:"data_search",location:{...},filters:{...}} for exact Data Search filters. Legacy listing/event filters remain supported.
Examples:
"every Monday 8am Central, Dallas rentals under $2k" -> frequency="weekly", day_of_week=1, run_time="08:00", timezone="America/Chicago", location="Dallas, TX", max_amount=2000
"last Friday of each month" -> frequency="monthly", day_of_week=5, week_of_month=-1
"every morning, new pre-foreclosures and price drops in Houston, save to my Distress list" -> frequency="daily", run_time="07:00", location="Houston, TX", events=["preforeclosure","price_drop"], list_id=…
Accepts the same advanced and event filters as spur_search_properties (min_amount / max_amount instead of min_price / max_price). Run the search once with spur_data_search first so the user can check the results before scheduling.
In automations each event fires once, on the run that first sees it, so the same property isn't saved twice; change events start reporting from the second run. "delisted" is only available here.
Events (pass in events; a listing matches when ANY selected event fired, and is tagged with each):
Listing lifecycle: new_listing, coming_soon, coming_soon_active, price_drop, price_increase, pending, sold, back_on_market, delisted (automations only), open_house, rental_listed, rent_change, move_in_moved_up
Distress & motivation: preforeclosure, foreclosure, auction, bank_owned, distress_escalated, fsbo, agent_to_fsbo, stale_listing, new_construction
Valuation & tax: tax_assessment_posted, assessed_value_jump, tax_paid_dropped (weak), sale_recorded, zestimate_moved, equity_gap, price_below_assessed Direct events (price_drop, pending, sold, preforeclosure, fsbo, new_listing, …) work on the first search. Change events (price_increase, back_on_market, distress_escalated, agent_to_fsbo, rent_change, zestimate_moved, …) compare against what Spur saw on an earlier search of the same area, so the first search only records a baseline. Motivated-seller research usually combines price_drop, back_on_market, stale_listing, agent_to_fsbo and the distress stages.
Inputs: name (required), location (required), run_time (required), frequency (required), +65 more.
spur_create_sms_templateCreate SMS templateAInspect
Save a new SMS template and show its phone preview with segment count and checks. The saved template can then be used by outreach workflows (spur_create_workflow / spur_set_workflow_step_template).
SMS guidance: plain text, ideally one segment (160 GSM characters, or 70 if it uses emoji or other non-GSM characters; longer messages are billed per segment). Identify yourself, keep it conversational, and include opt-out wording ("Reply STOP to opt out") on first-touch messages. Links in texts from unverified numbers can be blocked, so give link-free fallback_body text when the body has a URL. Use merge fields like {{owner_first_name}}, {{property_address}}, {{your_name}} (see spur://merge-variables).
Inputs: name (required), text (required), is_default, description, +1 more.
spur_create_workflowCreate outreach workflowAInspect
Create a multi-step outreach sequence from saved templates. It's saved as an inactive draft: nothing sends until it's activated (spur_set_workflow_active) and owners are enrolled.
Send steps take a saved template: email/SMS from spur_list_message_templates (design new ones with spur_create_email_template / spur_create_sms_template), direct mail from the user's saved postcard or letter templates. Wait steps space them out. Add reply/open/click/scan branches and edit timing afterwards with spur_edit_workflow.
Example: "text, wait 2 days, email, wait 5 days, postcard" -> steps=[{type:"send_sms",template_id:…},{type:"wait",days:2},{type:"send_email",template_id:…},{type:"wait",days:5},{type:"send_direct_mail",template_id:…}]
Inputs: name (required), steps (required), description.
spur_data_searchData SearchAInspect
Search properties across Spur's data providers in one search. Set listing_status to search current listings (ZHomes); leave it out to search off-market and owner records, routed automatically to the best source (county records, distress data) or to the provider the user named.
Each value is labeled with the provider that supplied it. Filters return three states: matched, unknown (could not be checked, shown separately), or excluded. Costs 1 search credit plus data credits per record returned; an empty page is free. Requires confirm=true after the user approved running the search. Follow with spur_save_data_results to keep results as properties.
Inputs: confirm (required), location (required), cursor, filters, +6 more.
spur_delete_imageDelete imageADestructiveIdempotentInspect
Permanently delete one of the user's saved images. Refused while one of their postcard, letter or email templates still uses it, since those would show a broken image. Confirm with the user first.
Inputs: confirm (required), image_id (required).
spur_delete_letter_templateDelete letter templateADestructiveIdempotentInspect
Permanently delete one of the user's letter templates. Spur defaults can't be deleted. Confirm with the user first.
Inputs: confirm (required), template_id (required).
spur_delete_message_templateDelete email or SMS templateADestructiveIdempotentInspect
Delete one of the user's email or SMS templates. Workflow steps that use it will fail until they get another template, so check spur_list_workflows and confirm with the user first.
Inputs: confirm (required), template_id (required).
spur_delete_postcard_templateDelete postcard templateADestructiveIdempotentInspect
Permanently delete one of the user's postcard templates. Spur defaults can't be deleted. Confirm with the user first.
Inputs: confirm (required), template_id (required).
spur_delete_qr_codeDelete QR codeADestructiveIdempotentInspect
Permanently delete a QR code. Refused while one of the user's postcard templates still prints it: remove it from those first with spur_remove_postcard_qr_code. Postcards already mailed keep redirecting. Confirm with the user first.
Inputs: confirm (required), qr_code_id (required).
spur_dispatch_mail_campaignDispatch approved postcard campaignADestructiveInspect
Dispatch exactly the staged campaign reviewed by spur_preview_mail_campaign. Rejects changed jobs/artwork/address and expired or cross-purpose tokens. Confirm only after the user approves the artwork and cost.
Inputs: confirm (required), confirmation_token (required).
spur_draft_messageDraft outreach messageADestructiveInspect
Draft an email, SMS or direct-mail message with Spur's AI. Returns text only; nothing is sent. Pass owner_id/property_id to personalize with real owner and property data.
Uses 2 actions from the user's Actions pool. Use {{merge_fields}} like {{owner_first_name}} and {{property_address}} to keep it reusable (see resource spur://merge-variables).
Inputs: prompt (required), channel (required), confirm (required), owner_id, +1 more.
spur_edit_workflowEdit workflow steps and branchesADestructiveInspect
Insert/update steps, change waits and branches, remove named steps, reorder, or rename a workflow. Unmentioned steps are retained. New IDs must start step_. Branch parent IDs must exist. Editing a live workflow requires confirmation. Activation is a separate tool.
Inputs: workflow_id (required), name, confirm, description, +3 more.
spur_enrichSkip trace / enrichADestructiveInspect
Run skip tracing to find owners and their phone numbers, emails and mailing addresses.
property_ids: find the owner of saved properties (creates/links owner records)
owner_ids: refresh contact details for existing owners
Costs enrichment credits per record (check spur_get_billing_summary). Ask the user to approve the count first, then call with confirm=true.
Inputs: confirm (required), owner_ids, property_ids.
spur_enroll_owners_in_workflowEnroll owners in workflowADestructiveInspect
Enroll owners in an outreach workflow. The workflow will start emailing/texting/mailing them on its schedule, which uses credits. Confirm the workflow name and owner count with the user first.
Inputs: confirm (required), owner_ids (required), workflow_id (required).
spur_estimate_data_jobEstimate a research jobARead-onlyIdempotentInspect
Get the credit estimate without creating, running, saving, or charging a recipe job. Execution is a separate call to spur_run_data_job and starts immediately.
Inputs: params (required), recipe_key (required), selections.
spur_estimate_table_columnQuote search-table enrichmentARead-onlyIdempotentInspect
Estimate a contacts column for selected/all loaded rows, with optional conditions and provider order. Free; skipped rows and maximum credits are returned.
Inputs: table_id (required), all, column, row_ids, +3 more.
spur_export_contactsExport saved contacts as CSVARead-onlyIdempotentInspect
Export selected saved properties or one list as CSV. DNC/TCPA-blocked, invalid and disallowed numbers never enter callable Phone columns. Blocked numbers are labeled separately; spreadsheet formulas are escaped. Returns an inline text/csv resource, with pagination for large lists. Makes no provider call.
Inputs: limit, offset, list_id, property_ids, +1 more.
spur_find_ownersFind ownersARead-onlyIdempotentInspect
Find property owners in the user's Spur account by name, phone, email or mailing address text. Use spur_get_owner for full details and portfolio.
Inputs: limit, query, offset, has_dnc, +5 more.
spur_generate_personalizationGenerate personalizationADestructiveInspect
Try settings on one property, generate a list preview (up to 10 records), generate all selected list records, or regenerate one saved line. Generation can spend Actions even in preview mode. Requires approval. Never sends outreach; review/edit/approve the stored lines separately.
spur_get_automation_logsAutomation run historyARead-onlyIdempotentInspect
Recent runs of a search automation: when, how many found/saved/enriched, and errors.
Inputs: automation_id (required), limit.
spur_get_billing_summaryBilling summaryARead-onlyIdempotentInspect
Plan, wallet balance, and this period's usage and remaining allowance per feature (searches, enrichment, SMS, postcards, letters, AI). Check this before large sends.
Inputs: no named parameters.
spur_get_campaign_statsCampaign statsBRead-onlyIdempotentInspect
Delivery and run statistics for one campaign.
Inputs: campaign_id (required).
spur_get_data_catalogData catalog and usageBRead-onlyIdempotentInspect
Read the full field catalog, live recipes and credit sheets, industry waterfall, or dated data usage. Free.
Inputs: section (required), from.
spur_get_data_jobGet a Data Search jobARead-onlyIdempotentInspect
Status, counts, and results of a Data Search job. Results are available while the job runs. Each value names its provider. Free.
Inputs: job_id (required), limit, state, offset.
spur_get_direct_mail_analyticsDirect mail analyticsBRead-onlyIdempotentInspect
Letters and postcards sent, delivered, in transit and returned, plus USPS tracking totals and spend.
Inputs: no named parameters.
spur_get_email_setupEmail setup and delivery healthBRead-onlyIdempotentInspect
Read sender identities, domain DNS/verification instructions, rotation settings, email analytics or sender stats. Free.
spur_get_field_sourcesGet sources for one fieldARead-onlyIdempotentInspect
Show every stored value for one field of a saved property, with its provider and date, plus which other providers could supply it and how many data credits a lookup uses. Free. Use this to answer "where did this number come from?" or before switching provider.
Inputs: data_point (required), property_id (required).
spur_get_letter_templateGet letter template HTMLARead-onlyIdempotentInspect
Fetch a letter template's HTML for reading or editing. For small text changes prefer spur_update_letter_template with replacements instead of resending the whole HTML.
Inputs: template_id (required).
spur_get_mail_trackingMail orders and USPS trackingARead-onlyIdempotentInspect
List orders or mailpieces, inspect one order/piece, or read a piece's tracking events. Returns pagination metadata for list views.
spur_get_message_templateGet email or SMS templateARead-onlyIdempotentInspect
Fetch an email template's subject, HTML and plain text, or an SMS template's text, for reading or editing. For small changes prefer the update tool's replacements over resending everything.
Inputs: template_id (required).
spur_get_outreach_messageInspect outreach messageBRead-onlyIdempotentInspect
Read a sent message's body, delivery details and response context.
Inputs: message_id (required).
spur_get_outreach_reportOutreach reportBRead-onlyIdempotentInspect
Outreach performance (sent, delivered, opened, replied, by channel) for all workflows or one, over an optional date range.
Inputs: date_to, date_from, workflow_id.
spur_get_ownerGet ownerBRead-onlyIdempotentInspect
Full owner record: contact details, mailing address, enrichment status and their property portfolio in Spur.
Inputs: owner_id (required).
spur_get_personalizationRead personalizationARead-onlyIdempotentInspect
Read the live angle/goal/tone/token catalog, current settings, a list's review queue, a saved line, or angle performance. Free. New merge fields include ai_opener, ai_reason, ai_cta, ai_ps, ai_subject, ai_first_name and ai_custom_.
spur_get_postcard_templateGet postcard template HTMLARead-onlyIdempotentInspect
Fetch a postcard template's HTML for reading or editing. For small text changes prefer spur_update_postcard_template with replacements instead of resending whole HTML.
Inputs: template_id (required), side.
spur_get_propertyGet propertyARead-onlyIdempotentInspect
Show one saved Spur property as a detailed card by property_id, with owner links and enrichment status. (zpid lookups were removed; save a listing first.)
Inputs: zpid, property_id.
spur_get_property_dncProperty DNC statusARead-onlyIdempotentInspect
Stored per-number DNC result, blocked state, provider, check date and expiry. Free; requires the account's restricted-contact permission. A clear DNC check does not establish consent to text.
Inputs: property_id (required).
spur_get_property_eventsProperty timelines and recent eventsBRead-onlyIdempotentInspect
Read an individual property's event history, recent portfolio events, or the event-type catalog. Free. Event dates and detection dates are distinct.
Inputs: basis, limit, types, catalog, +2 more.
spur_get_property_sourcesGet property data with sourcesARead-onlyIdempotentInspect
Read a saved property's data with the source beside every value: which provider supplied it, when, how it was selected, whether it is a fallback or a calculation, and which fields are still unknown. Free, makes no paid lookups.
Always tell the user the source of any number you repeat (e.g. "Estimated value $505,000 from RealEstateAPI, retrieved Nov 3"). Calculated values such as estimated equity are Spur's calculation from the listed inputs, never one provider's figure. Unknown means Spur has no value; never present it as zero.
Inputs: property_id (required), data_points, reveal_contacts.
spur_get_property_statsProperty statsARead-onlyIdempotentInspect
Totals for the user's saved properties: counts by status, enrichment progress and similar portfolio-level numbers.
Inputs: no named parameters.
spur_get_qr_code_activityQR code scansARead-onlyIdempotentInspect
Scan activity for a QR code: totals, which mailed recipients (owners) scanned their postcard, and recent scans of the code itself. Use it to find warm leads from a postcard campaign.
Inputs: qr_code_id (required), limit.
spur_get_qr_managerQR redirects, recipient codes and scansARead-onlyIdempotentInspect
Read standalone redirects, recipients, manager activity, scan events, or dated analytics, including codes not attached to postcards. List results retain server pagination.
spur_get_sms_conversationSMS threadBRead-onlyIdempotentInspect
The full SMS thread with one owner, oldest first.
Inputs: owner_id (required).
spur_get_texting_setupTexting setup statusARead-onlyIdempotentInspect
The user's texting setup: phone numbers bought in Spur (and which can send), carrier (A2P 10DLC) registration status, carrier notes, what's still missing, and the next step. Call this before helping with numbers or registration.
Inputs: refresh.
spur_get_usage_analyticsBilling usage analyticsCRead-onlyIdempotentInspect
Read dated usage, spend and wallet activity. Free.
Inputs: end, start, group_by.
spur_get_workflowGet outreach workflowARead-onlyIdempotentInspect
One outreach workflow's steps in order (including reply/open branches built in the app), with the email, SMS or mail template each send step uses and its step_id.
Inputs: workflow_id (required).
spur_get_workspaceProfile and onboardingARead-onlyIdempotentInspect
Read your profile/business identity, onboarding checklist, available outreach strategies, or monday.com connection and list-sync status. Never returns another user's account.
Inputs: section (required), refresh.
spur_launch_campaignLaunch approved campaignADestructiveInspect
Launch the exact sequence reviewed by spur_preview_campaign. Refuses expired tokens or changed configuration, template content or audience counts. Can send and spend credits; do not automatically retry a timed-out launch.
Inputs: confirm (required), confirmation_token (required).
spur_list_campaignsList campaignsBRead-onlyIdempotentInspect
The user's campaigns (bulk email, SMS, direct mail, outreach) with status and recipient progress.
Inputs: limit, offset, status.
spur_list_data_jobsList research jobsBRead-onlyIdempotentInspect
Recover job IDs, statuses and budgets, including jobs started in the app. Free.
Inputs: limit, offset, status.
spur_list_data_providersList data providersARead-onlyIdempotentInspect
List the property and contact data providers connected to Spur, what each can supply, its status, and known limitations. Free. Use the names here when telling the user where data comes from.
Inputs: no named parameters.
spur_list_imagesList imagesARead-onlyIdempotentInspect
The user's saved images (logos, headshots, property photos) with their public URLs, newest first. Use it as (or a CSS background-image) in postcard, letter or email HTML. To add one, use spur_upload_image (from the user's device) or spur_save_image (from a URL).
Inputs: limit.
spur_list_letter_templatesList letter templatesARead-onlyIdempotentInspect
Letter templates available to the user, with their letter type (Top First Page or Insert Blank Page): their own (editable), Spur defaults, and Spur's built-in gallery. Copy one with spur_create_letter_template base_template_id to redesign it, or start from blank with start_from_blank.
Inputs: category, letter_type, include_gallery.
spur_list_message_templatesList email and SMS templatesCRead-onlyIdempotentInspect
The user's saved email and SMS templates. These are what outreach workflow send_email / send_sms steps use.
Inputs: channel.
spur_list_postcard_templatesList postcard templatesARead-onlyIdempotentInspect
Postcard templates available to the user: their own (editable), Spur defaults, and Spur's built-in gallery. Copy a default or gallery design with spur_create_postcard_template base_template_id to redesign it, or start from blank with start_from_blank.
Inputs: size, category, include_gallery.
spur_list_property_listsList property listsARead-onlyIdempotentInspect
All of the user's property lists with ids and sizes. Use the id with spur_list_saved_properties, spur_add_properties_to_list or outreach tools.
Inputs: no named parameters.
spur_list_qr_codesList QR codesARead-onlyIdempotentInspect
The user's tracked QR codes: destination URL, colors, and which of their postcard templates print each one. Put one on a postcard with spur_add_postcard_qr_code; see scans with spur_get_qr_code_activity.
Inputs: no named parameters.
spur_list_return_addressesList return addressesARead-onlyIdempotentInspect
Return addresses saved for direct mail. The default one is used when a campaign doesn't specify one.
Inputs: no named parameters.
spur_list_saved_propertiesList saved propertiesBRead-onlyIdempotentInspect
List properties the user has saved in Spur, optionally filtered by city, state, list, or enrichment status. Shows cards and a map.
Inputs: city, limit, query, state, +13 more.
spur_list_search_automationsList search automationsARead-onlyIdempotentInspect
Scheduled property searches with their schedule, filters, and next/last run times.
Inputs: no named parameters.
spur_list_search_tablesList saved searchesCRead-onlyIdempotentInspect
Reopen saved search tables from the app or MCP. Free.
Inputs: limit, offset.
spur_list_sms_conversationsSMS inboxARead-onlyIdempotentInspect
SMS conversations with owners, newest first, with unread counts and the last message. Good for triaging replies (hot leads, not interested, wrong number).
Inputs: limit, offset, unread_only.
spur_list_workflowsList outreach workflowsARead-onlyIdempotentInspect
The user's multi-step outreach workflows (email/SMS/mail sequences) with status and enrollment counts.
Inputs: no named parameters.
spur_manage_billingBilling portalBInspect
Link to the user's Stripe billing portal: update the card on file, download invoices, change or cancel the subscription.
Inputs: no named parameters.
spur_manage_campaignCampaign drafts, recipients and runsADestructiveInspect
Create/update/delete a campaign draft, inspect a campaign/runs, stage consenting recipients respecting opt-outs, cancel, or retry failed runs. Launch requires a separate preview token. Retrying can send and needs approval.
spur_manage_data_preferencesManage source preferencesAInspect
Get, save, or delete persistent source preferences. Saving preferences makes no paid lookup. Read the segment/catalog first.
spur_manage_email_domainConnect and verify sending domainsBDestructiveInspect
Create/update a sending domain and return DNS instructions, verify DNS records, or delete a custom domain. No email is sent. If credentials are required, complete that step in Spur settings.
spur_manage_email_senderConfigure email identitiesADestructiveInspect
Create/update/delete senders, set a default, verify a sender domain, or update rotation settings. Changes affect subsequent sends. Domain credentials stay in the Spur app; no API keys or SMTP passwords are accepted here.
spur_manage_mail_campaignPostcard campaign templates and jobsADestructiveInspect
Manage campaign-specific templates, stage owner recipients, inspect jobs and summary. Staging verifies addresses and can spend personalization Actions; requires approval. Dispatch uses a separate mail preview and token. These templates are distinct from normal direct-mail templates.
spur_manage_monday_syncConnect monday.com and synchronize listsADestructiveInspect
Get a secure OAuth handoff link, disconnect, enable list-to-board sync, run sync now, or disable it. Sync writes prospect data to monday.com; approve the exact list/board first. No tokens or credentials are accepted in chat.
spur_manage_ownerMaintain owner recordsADestructiveInspect
Create/edit an owner, correct manual contacts, link a saved property, soft-delete, or preview enrichment without running it. Owner/property ownership is checked before linking.
spur_manage_property_listManage property listsADestructiveInspect
Read a list and its stats, rename it, delete it, remove members, or copy/move members to another list. Moves add to the destination before removing from the source; a partial failure reports progress. Does not send outreach.
spur_manage_qr_recipientsManage recipient QR codesADestructiveInspect
Create one or up to 500 recipient codes under a redirect, update a code, or delete it. No outreach is sent. Edits/deletion affect printed codes.
spur_manage_qr_redirectManage QR redirectsADestructiveInspect
Create or edit a standalone redirect, or delete it and its recipient codes. Edits affect already printed codes. Postcard-linked parent codes should use spur_update_qr_code to keep their linked redirect synchronized.
spur_manage_return_addressMaintain return addressesADestructiveInspect
Create/edit/delete a return address, or verify a recipient address. Creation and address edits use Spur's provider verification. Review verification feedback before sending mail.
spur_manage_search_automationManage search automationADestructiveInspect
Get full settings, update/enable/disable, delete, or preview/apply migration to Data Search. Updating an enabled automation or applying migration needs approval because subsequent runs can spend/contact people. Disable is immediate.
spur_manage_search_tableManage saved search rowsADestructiveInspect
Reopen, delete, record signed search results into a table, or save selected rows to properties/a list for free. Create tables with spur_data_search keep_table=true. Deleting a table does not delete saved properties.
spur_manage_sms_inboxManage unread SMSAInspect
Read the unread count, page inbound replies, or mark specific messages read after triage.
spur_manage_texting_registrationSync or discard texting registrationADestructiveInspect
Refresh registration status from the carrier, or discard a draft registration after confirmation. Existing save/submit/pay/resend tools cover the rest of setup.
spur_manage_trashDeleted-item recoveryADestructiveInspect
List deleted records or restore a property, owner, or list. Permanent deletion and empty-trash require explicit confirmation.
spur_manage_workflowWorkflow operations and diagnosticsADestructiveInspect
Read enrollments, execution logs or stats; duplicate as a draft; delete; unenroll one contact; retry failed enrollments. Retrying can resume real sends and requires approval.
spur_parse_data_searchPreview a Data SearchARead-onlyIdempotentInspect
Turn a plain-English request into a Data Search (filters, recipe, and provider choice) without searching or charging. Recipe requests can run directly with spur_run_data_job; other searches require confirmation before spur_data_search. Providers are only fixed when the user named one.
Inputs: query (required).
spur_parse_search_queryPreview search filtersARead-onlyIdempotentInspect
Show how Spur interprets a plain-English property search (filters and events) without running it. Free: uses no data credits.
Use it to confirm intent before spending a credit, or to turn a vague request into explicit filters you can adjust. The returned arguments can be passed straight to spur_search_properties (keep the same location / status unless the user says otherwise). Exclusions ("no condos", "not foreclosures") are honoured by leaving those filters out.
Inputs: query (required).
spur_pay_texting_feesPay overdue texting feesADestructiveInspect
Retry overdue monthly number and registration fees from the Spur wallet right away (normally retried daily). Use after the user adds funds. Restores paused numbers once paid. Charges the wallet: confirm the amount with the user first.
Inputs: confirm (required).
spur_plan_property_dataPreview a property data lookupARead-onlyIdempotentInspect
Show which providers Spur would use to fill the requested fields of a saved property, which stored values would be reused for free, and what it would cost. Makes no paid call. Always run this and show the user the result before spur_refresh_property_data.
Inputs: data_points (required), property_id (required), selections, cross_validate.
spur_plan_property_dncPreview DNC checksARead-onlyIdempotentInspect
Quote checks for unchecked or expired numbers. Free. Show the credits before calling spur_check_property_dnc.
Inputs: property_id (required).
spur_preview_campaignReview campaign before launchARead-onlyIdempotentInspect
Review current configuration, channel content, recipient count and billing. Mail-containing sequences show sample postcard artwork and clear zones. Returns a 30-minute token bound to the campaign, channel templates and mail return address. Nothing launches.
Inputs: campaign_id (required).
spur_preview_letter_campaignPreview letter mailingARead-onlyInspect
Required step before mailing letters. Renders the letter with the first recipient's real data in its letter type's layout, checks which owners have mailing addresses, estimates the cost from the user's plan (Insert Blank Page letters include the extra address page), and returns a confirmation_token.
Show the preview, then ask the user to approve. Only after they approve, call spur_send_letters with the token (the widget's Send button does the same). The token expires in 30 minutes and only covers this exact template, letter type, print options, recipient set and return address.
Inputs: owner_ids (required), template_id (required), color, double_sided, +1 more.
spur_preview_letter_templatePreview letter templateARead-onlyIdempotentInspect
Show any letter template (yours, a Spur default or a gallery design) rendered with sample data, without changing anything.
Inputs: template_id (required).
spur_preview_mail_campaignPreview staged postcard campaignARead-onlyIdempotentInspect
Show staged postcard artwork, recipient count, return address, cost and USPS clear zones. Returns a token tied to all sendable jobs, template and return address. Nothing dispatches until approval.
Inputs: campaign_id (required), return_address_id (required).
spur_preview_message_draftPreview unsaved email or SMSARead-onlyIdempotentInspect
Preview email HTML or SMS text before saving it: renders it with sample or real owner data and runs the design checks. Nothing is saved; iterate here, then save with spur_create_email_template / spur_create_sms_template.
Email HTML guidance (see spur://email-design-guide): full HTML document, table-based layout 600px wide, inline styles on elements (a small block in is fine for resets/media queries), web-safe font stacks, no JavaScript, no forms, no external CSS. Images as absolute https URLs with alt text and width attributes. The user's own images (logo, headshot, property photos): spur_list_images gives their URLs; if they want to use an image they have, call spur_upload_image (or spur_save_image for a link) and use the saved URL. Use PNG or JPG in emails, not SVG. A hidden preheader right after sets the inbox snippet. Include an opt-out line ("Reply STOP" or an unsubscribe link) and the sender's postal address in the footer. Keep it under 50,000 characters. Use merge fields like {{owner_first_name}}, {{property_address}}, {{your_name}}, {{your_phone}}, {{company_name}} (see spur://merge-variables). The plain-text version is generated from the HTML unless you pass text_body.
SMS guidance: plain text, ideally one segment (160 GSM characters, or 70 if it uses emoji or other non-GSM characters; longer messages are billed per segment). Identify yourself, keep it conversational, and include opt-out wording ("Reply STOP to opt out") on first-touch messages. Links in texts from unverified numbers can be blocked, so give link-free fallback_body text when the body has a URL. Use merge fields like {{owner_first_name}}, {{property_address}}, {{your_name}} (see spur://merge-variables).
Inputs: channel (required), html, text, subject, +2 more.
spur_preview_message_templatePreview email or SMS templateARead-onlyIdempotentInspect
Show a saved email (inbox view, desktop and mobile) or SMS (phone view, segment count) rendered with sample data or a real owner's data, plus design checks. Changes nothing.
Inputs: template_id (required), owner_id.
spur_preview_postcard_campaignPreview postcard mailingARead-onlyInspect
Required step before mailing postcards. Renders the postcard with the first recipient's real data, checks which owners have mailing addresses, estimates the cost from the user's plan, and returns a confirmation_token.
Show the preview, then ask the user to approve. Only after they approve, call spur_send_postcards with the token (the widget's Send button does the same). The token expires in 30 minutes and only covers this exact template, recipient set, return address and size.
Inputs: owner_ids (required), template_id (required), size, return_address_id.
spur_preview_postcard_templatePreview postcard templateARead-onlyIdempotentInspect
Show any postcard template (yours, a Spur default or a gallery design) rendered with sample data, without changing anything.
Inputs: template_id (required).
spur_refresh_property_dataFetch property data from providersADestructiveInspect
Run the lookup previewed by spur_plan_property_data and return the updated values with their sources. Can spend the user's credits and provider costs. Requires the user's explicit approval of the preview (confirm=true). A provider with no record is never charged and never silently replaced by another one.
Inputs: confirm (required), data_points (required), property_id (required), selections, +1 more.
spur_refresh_property_eventsRefresh property timelineBDestructiveInspect
Fetch current listing/record events. Can spend data credits; approve the selected sources first.
Inputs: confirm (required), sources (required), property_id (required).
spur_release_phone_numberRelease phone numberADestructiveIdempotentInspect
Permanently give up one of the user's bought numbers. They may never get it back, and contacts texting it will no longer reach them. Confirm with the user first.
Inputs: confirm (required), number_id (required).
spur_remove_postcard_qr_codeRemove QR code from postcardAIdempotentInspect
Remove the tracked QR code from one of the user's postcard templates (both sides) and show the preview. A QR slot from the design stays, empty.
Inputs: template_id (required).
spur_resend_texting_verificationResend verification textAInspect
Sole proprietors only: re-send the carrier's verification text (the user replies YES) when the previous one expired after 24 hours.
Inputs: no named parameters.
spur_review_personalizationEdit or approve personalized linesAInspect
Edit per-channel copy/custom fields or approve saved records after reviewing them. Reviewed lines are preserved by generation. Does not send outreach.
spur_route_table_outreachRoute search rows into outreachBDestructiveInspect
Enroll each selected owner in the first reachable configured channel in order. Skips duplicate enrollments. This can start real outreach; approve the workflows and audience first.
Inputs: order (required), routes (required), confirm (required), table_id (required), +2 more.
spur_run_data_jobRun a Data Search jobADestructiveInspect
Start a recipe job immediately. Every enabled step runs automatically, including owner contact enrichment and Do Not Call checks by default; set includeContacts=false to skip contacts. Recipes (key: params besides location, maxCandidates, unknownPolicy, includeContacts):
motivated_seller: off-market, owned a long time, high estimated equity (minTenureYears, minEquityPercent)
absentee_owner: owner lives elsewhere, usually landlords (minTenureYears)
pre_foreclosure: recent default or foreclosure filing with equity left (withinDays, minEquityPercent)
free_and_clear: owned outright or nearly paid off (maxLtvPercent)
vacant_property: reported vacant
entity_owned: owned by an LLC, corporation or trust; includeContacts finds the people behind it (entityTypes, minTenureYears)
neighbor_farming: every home within radiusMiles (default 0.25) of one property, with owner names, owner mailing address and estimated loan balance; location must include street plus state or ZIP; includeContacts adds phones and emails (radiusMiles) Uses data credits as lookups complete. No separate approval or confirm flag is required to run the recipe. A job_id starts a legacy job that is still awaiting approval. Poll with spur_get_data_job. Matched items are always saved to the user's properties when the job finishes (free), and also added to save_to_list_id when given; unknown items are saved to unknown_list_id only when given.
Inputs: job_id, params, confirm, location, +6 more.
spur_run_search_automationRun search automation nowADestructiveInspect
Run an approved search automation now. Can spend credits/actions and enroll owners in outreach according to its settings. Inspect it with spur_manage_search_automation get first; confirm the exact run.
Inputs: confirm (required), automation_id (required).
spur_run_table_columnEnrich search-table contactsBDestructiveInspect
Start the approved contacts column as a background run under a credit ceiling. Saves rows for free, then enriches; poll with spur_control_table_run action=get.
Inputs: confirm (required), table_id (required), credit_limit (required), all, +5 more.
spur_save_data_resultsSave Data Search resultsAInspect
Save Data Search results (from spur_data_search) or a job's matched items (from spur_run_data_job) as the user's properties, with owners that outreach can use. Free: the search already paid for the data. Unknown job items can go to a separate list for review.
Inputs: job_id, list_id, results, entity_ids, +2 more.
spur_save_imageSave image from URLAInspect
Download an image from a public https URL (the user's website, a shared photo link) and save it to the user's Spur image library, so it stays available for printing and sending. Returns the saved image's URL. JPG, PNG, WebP, GIF or SVG, up to 20 MB. For a file on the user's device, use spur_upload_image instead. Only save images the user provided or asked for.
Inputs: url (required), filename.
spur_save_propertiesSave propertiesAInspect
Save search results into the user's Spur properties (and optionally a property list). Pass listing objects from spur_search_properties structuredContent.cards[].listing. Free. Already-saved properties are updated, not duplicated.
Inputs: listings (required), list_id.
spur_save_texting_registrationSave texting registrationAInspect
Create or update the user's carrier (A2P 10DLC) registration draft. Pass only the fields to change; nested objects merge. Pick registration_type from two questions: has an EIN? (no → sole_proprietor) and more than ~2,000 texts/day? (yes → standard, else low_volume_standard). Business details must match IRS records exactly. Only record consent methods the user actually uses: carriers reject texting purchased or skip-traced lists without consent. write_campaign_text=true then reads their website and drafts the campaign description, opt-in flow and sample messages (needs message_types and consent_channels). Show that text to the user to review.
Inputs: address, contact, messaging, business_info, +2 more.
spur_save_uploaded_imageSave uploaded imageAInspect
Used by the upload widget to save the file the user picked. Not for the assistant.
Inputs: filename (required), data_base64 (required).
spur_search_phone_numbersFind phone numbersARead-onlyIdempotentInspect
Search local US numbers the user can buy, by area code, state, city or digits. Show the options and let the user pick before spur_buy_phone_number. Prefer an area code in the user's market.
Inputs: city, limit, state, contains, +1 more.
spur_search_propertiesSearch properties (deprecated)ADestructiveInspect
DEPRECATED: use spur_parse_data_search to preview and spur_data_search to run searches. This tool stays for existing prompts and the property explorer cards, and now runs on Data Search: the same filters, mapped by Spur, with each value labeled by its provider.
listing_status (forRent / forSale / sold) searches current listings on ZHomes; without it the search covers off-market and owner records with automatic provider routing. Costs 1 search credit plus data credits per record returned (limit caps it); an empty page is free. Listing event filters (price drops, back on market, ...) are not available here: use spur_create_search_automation for those.
Follow up with spur_save_properties (pass the cards' listing objects) or spur_save_data_results. Saving is free.
Inputs: confirm (required), limit, query, views, +50 more.
spur_select_property_fieldSelect field source or primary contactADestructiveInspect
Choose a stored observation, lock a field to a provider, restore Automatic, or choose/clear a primary contact item. Paid provider selection requires confirm=true; inspect sources and the lookup plan first.
spur_send_bulk_emailSend approved bulk emailBDestructiveInspect
Queue the exact approved subject/content and recipient set. Show the email preview (spur_preview_message_draft) and audience before approval. Recipients can be mapped CSV rows. Charges email usage; never automatically retry a timed-out send.
Inputs: confirm (required), subject (required), recipients (required), html, +5 more.
spur_send_bulk_smsSend approved bulk SMSADestructiveInspect
Queue the exact approved message and recipient set, including mapped CSV rows. Show the text, audience and segment cost first. Requires recipient consent; a clear DNC result does not establish opt-in. Never automatically retry a timed-out send.
Inputs: confirm (required), message (required), recipients (required), from, +1 more.
spur_send_lettersSend lettersADestructiveInspect
Mail the letters approved in spur_preview_letter_campaign. Irreversible and charges the user's account. Requires the preview's confirmation_token and the user's explicit approval (confirm=true).
Inputs: confirm (required), confirmation_token (required).
spur_send_postcardsSend postcardsADestructiveInspect
Mail the postcards approved in spur_preview_postcard_campaign. Irreversible and charges the user's account. Requires the preview's confirmation_token and the user's explicit approval (confirm=true).
Inputs: confirm (required), confirmation_token (required).
spur_send_smsSend SMSADestructiveInspect
Text an owner from the user's default approved number (or Spur's workspace number if they have none; see spur_get_texting_setup). Show the user the exact message and recipient and get approval before calling with confirm=true. Billed per 160-character segment (70 if it has emoji or special characters), so a 200-character text costs 2.
Inputs: confirm (required), message (required), owner_id (required).
spur_send_test_emailSend test email to yourselfAInspect
Send an email template, filled with sample data (or one owner's data), to the user's own Spur account email from their email sender, to check it in a real inbox. Never goes to owners. Confirm with the user first.
Inputs: confirm (required), template_id (required), owner_id, sender_id.
spur_set_auto_rechargeAuto-rechargeADestructiveInspect
Turns wallet auto-recharge on or off. When on, Spur charges the saved card amount_usd whenever the balance drops below threshold_usd, so sends never fail for lack of funds. Needs a saved card (the first spur_top_up_wallet payment saves one). Turning it on needs the user's approval of the amount and threshold (confirm=true); turning it off doesn't.
Inputs: enabled (required), confirm, amount_usd, threshold_usd.
spur_set_default_phone_numberSet default numberAIdempotentInspect
Make one of the user's bought numbers the default sender for their texts.
Inputs: number_id (required).
spur_set_workflow_activeActivate or pause workflowADestructiveInspect
Activate a workflow (enrolled owners start receiving its emails, texts and mail on schedule, which uses credits) or pause it. Activating requires every send step to have a template and the user's explicit approval.
Inputs: active (required), workflow_id (required), confirm.
spur_set_workflow_step_templateUse template in workflow stepAIdempotentInspect
Set which saved template a workflow's send step uses (send_email ← email template, send_sms ← SMS template, send_direct_mail ← postcard/letter template). Get step_ids from spur_get_workflow. If the workflow is active, enrolled owners get the new template from their next send.
Inputs: step_id (required), template_id (required), workflow_id (required), confirm.
spur_show_billing_optionsTop up or upgradeARead-onlyIdempotentInspect
Shows the user's wallet balance, one-click top-up amounts, auto-recharge status and every Spur plan with prices, in a widget with Pay/Upgrade buttons. Use whenever the user wants to add funds, buy credits, upgrade, change or compare plans, or a send failed for billing reasons.
Inputs: no named parameters.
spur_submit_texting_registrationSubmit texting registrationADestructiveInspect
Send the user's registration to the carriers (also resubmits a rejected one after fixes). Charges the Spur wallet: $29 one-time for low volume / sole proprietor or $79 for standard (includes the first month, then $3 or $15/mo), or $15 to resubmit after a carrier rejection; spur_get_texting_setup shows the exact amount due now. Tell the user the amount. Walk the user through the full details first, and only call after they explicitly approve and personally confirm both statements: they only text people who agreed to receive their messages and honor STOP, and they won't send prohibited content (cannabis, firearms, high-risk loans or debt collection, gambling, sexual content, hate speech).
Inputs: confirm (required), user_confirms_consent (required), user_confirms_no_prohibited_content (required).
spur_top_up_walletTop up walletAInspect
Creates a Stripe checkout link to add funds to the user's Spur wallet (pays for postcards, letters, SMS, data credit and action top-ups, and other usage beyond the plan). No money moves until the user pays on Stripe, so no confirmation is needed. If the user didn't name an amount, suggest $25, $50 or $100, or enough to cover the send they're planning.
Inputs: amount_usd (required).
spur_update_email_templateEdit email templateAIdempotentInspect
Edit one of the user's email templates and show the updated inbox preview. For tweaks pass replacements (exact find → replace in "html", "subject" or "text"); to redesign pass full html. When the HTML changes, the plain-text version is regenerated unless it was hand-written or you pass text_body. Workflows using this template send the new version from their next step.
Example: replacements=[{target:"html", find:"<p style="margin:0 0 16px;">", replace:"<p style="margin:0 0 16px;">I'd like to make a cash offer on {{property_address}}."}]
Email HTML guidance (see spur://email-design-guide): full HTML document, table-based layout 600px wide, inline styles on elements (a small block in is fine for resets/media queries), web-safe font stacks, no JavaScript, no forms, no external CSS. Images as absolute https URLs with alt text and width attributes. The user's own images (logo, headshot, property photos): spur_list_images gives their URLs; if they want to use an image they have, call spur_upload_image (or spur_save_image for a link) and use the saved URL. Use PNG or JPG in emails, not SVG. A hidden preheader right after sets the inbox snippet. Include an opt-out line ("Reply STOP" or an unsubscribe link) and the sender's postal address in the footer. Keep it under 50,000 characters. Use merge fields like {{owner_first_name}}, {{property_address}}, {{your_name}}, {{your_phone}}, {{company_name}} (see spur://merge-variables). The plain-text version is generated from the HTML unless you pass text_body.
Inputs: template_id (required), html, name, subject, +4 more.
spur_update_letter_templateEdit letter templateAIdempotentInspect
Edit one of the user's letter templates and show the updated preview. For text tweaks pass replacements (exact find → replace); to redesign, pass full html. letter_type switches between top_first_page and insert_blank_page. Spur default and gallery templates can't be edited: copy them first with spur_create_letter_template base_template_id.
HTML guidance (see spur://letter-design-guide): one US Letter page (8.5"×11"), full HTML document with inline , "@page { size: 8.5in 11in; margin: 0; }", no scripts. One root 8.5in wide; px/in units only (no vh/vw); no box-shadow, transforms or manual page breaks. top_first_page: leave the first 3.15in blank (an empty ), body ≈ 3–4 short paragraphs. insert_blank_page: no address zone; letterhead up to 1.8in, body up to ~400 words. Images as absolute https URLs. The user's own images (logo, headshot, property photos): spur_list_images gives their URLs; if they want to use an image they have, call spur_upload_image (or spur_save_image for a link) and use the saved URL. Use merge fields such as {{owner_first_name}}, {{property_address}}, {{your_name}}, {{your_phone}}, {{company_name}} (see spur://merge-variables).
Inputs: template_id (required), html, name, category, +3 more.
spur_update_personalization_settingsUpdate personalization settingsADestructiveInspect
Set voice, goal, approved angles, fallbacks, custom AI fields and human review. Read the catalog first. Enabling auto_generate can spend Actions on subsequent list additions; confirm the settings with the user.
Inputs: confirm (required), settings (required).
spur_update_postcard_templateEdit postcard templateAIdempotentInspect
Edit one of the user's postcard templates and show the updated preview. For text tweaks pass replacements (exact find → replace on a side); to redesign, pass full front_html/back_html. Spur default and gallery templates can't be edited: copy them first with spur_create_postcard_template base_template_id.
Example: change the headline -> replacements=[{side:"front", find:"Just Sold!", replace:"Just Listed!"}]
HTML guidance (see spur://postcard-design-guide): full HTML documents, inline , no scripts. Fixed pixel sizing on html, body and a root .postcard at 300 px/in including 0.125" bleed: 6x4 → 1875×1275, 6x9 → 2775×1875, 6x11 → 3375×1875. Keep text 0.25" inside the edge. USPS clear zone on the back, measured from the bleed edges (Spur prints over it and covers anything there): postage 1.25"×1.25" in the top-right corner; address block 3.5"×2", 0.5" from the right edge and 1.35" from the top; USPS barcode strip 4.75"×0.625" along the bottom-right edge. Keep all text, logos, photos and QR codes out of it; a background color or texture under it is fine. The safe message area is left of the address block and above the barcode strip. Images as absolute https URLs. The user's own images (logo, headshot, property photos): spur_list_images gives their URLs; if they want to use an image they have, call spur_upload_image (or spur_save_image for a link) and use the saved URL. Use merge fields such as {{owner_first_name}}, {{property_address}}, {{your_name}}, {{your_phone}}, {{company_name}} (see spur://merge-variables). QR code box by default: unless the user says they don't want a QR code, every back you design includes an empty square in the message area (≥ 0.75in, e.g. 225×225 px at 300 px/in) with a short call to action beside it ("Scan to see your home's value"). Never write QR markup or {{qrUrl}} yourself: after saving, call spur_add_postcard_qr_code and the tracked QR fills the box (pick the code with spur_list_qr_codes, or ask the user where scans should go and spur_create_qr_code). When resending full back_html, keep the qr-box and any <img data-spur-qr-merge…> inside it, or the QR is dropped.
Inputs: template_id (required), name, size, category, +4 more.
spur_update_propertyUpdate saved propertyADestructiveInspect
Edit saved property fields, correct manually entered owner contacts, or soft-delete a property. Manual corrections are user-supplied facts and make no paid lookup.
spur_update_qr_codeEdit QR codeAIdempotentInspect
Rename a QR code, change where scans go, or change its colors. A new destination also applies to postcards already mailed with this code. Templates pick up new colors at send time.
Inputs: qr_code_id (required), name, destination_url, background_color, +1 more.
spur_update_sms_templateEdit SMS templateAIdempotentInspect
Edit one of the user's SMS templates and show the updated preview. Pass full text / fallback_body, or replacements (exact find → replace in "text" or "fallback"). Pass fallback_body="" to remove the fallback.
SMS guidance: plain text, ideally one segment (160 GSM characters, or 70 if it uses emoji or other non-GSM characters; longer messages are billed per segment). Identify yourself, keep it conversational, and include opt-out wording ("Reply STOP to opt out") on first-touch messages. Links in texts from unverified numbers can be blocked, so give link-free fallback_body text when the body has a URL. Use merge fields like {{owner_first_name}}, {{property_address}}, {{your_name}} (see spur://merge-variables).
Inputs: template_id (required), name, text, is_default, +3 more.
spur_update_workspaceUpdate profile and onboardingAInspect
Edit your business identity, email preferences, market/outreach intent, or dismiss/restore the checklist. Identity is used by template merge fields. Does not change credentials or account permissions.
spur_upload_imageUpload imageARead-onlyIdempotentInspect
Show an upload box where the user picks or drops an image from their device (logo, headshot, property photo); it's saved to their Spur image library. Use this whenever the user wants to use their own image, including one they attached to the chat: attachments don't reach Spur, so ask them to drop it into the box. After uploading, the user can click "Use this image", or call spur_list_images to get the URL.
Inputs: purpose.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Real estate data for AI agents: property lookup, comps, search, skip tracing, phone/address checks
AI phone calls, SMS and CRM records in one Lead Friendly account, compliance-checked on every send
B2B lead generation, email verification, company enrichment, and agentic GTM Ops.
Ringless voicemail and SMS follow-up for AI agents, with consent checks and confirmed bulk sends.
Related MCP Servers
AlicenseNot gradedqualityBmaintenanceEnables AI assistants and agents to query U.S. real estate data, including property lookups, comparables, property searches, skip tracing, phone/address verification, and investor buy boxes, through plain-language requests.1MIT- AlicenseNot gradedqualityBmaintenanceEnables users to pierce anonymous real estate LLCs to resolve owner names, wireless phone numbers, and deliverable emails, enrich addresses with Census geocoding and GLEIF LEI data, and run OFAC SDN KYB compliance checks.MIT
- FlicenseNot gradedqualityDmaintenanceEnables automated lead generation, AI enrichment, personalized messaging, and outreach orchestration through MCP tools and n8n workflows.-

scrapercity-cliofficial
AlicenseBqualityBmaintenanceB2B lead generation MCP server with 20+ lead generation tools - Apollo scraping, Google Maps, email finder, email validator, mobile finder, skip trace, ecommerce store data, and more.251,012 npm2MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.