Skip to main content
Glama

Server Details

Real estate leads, skip tracing, direct mail, SMS & email outreach, and marketing automations

Ownership verified
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
ChatGPT
–
Claude
–

TDQS

B3.2/5.0

Scored across 154 tools

Disambiguation2/5

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.

Naming Consistency4/5

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.

Tool Count1/5

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.

Completeness4/5

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 tools
fetchFetch Spur recordA
Read-onlyIdempotent
Inspect

Fetch a record returned by search, including list, workflow, table, job, letter, message_template or personalization IDs.

Inputs: id (required).

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 postcardA
Idempotent
Inspect

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 listB
Idempotent
Inspect

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 numberA
Destructive
Inspect

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 paymentA
Read-onlyIdempotent
Inspect

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 planA
Destructive
Inspect

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 paymentA
Idempotent
Inspect

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 DNCA
Destructive
Inspect

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 searchesB
Destructive
Inspect

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 researchA
Destructive
Inspect

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 trackingA
Destructive
Inspect

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 runA
Destructive
Inspect

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 automationA
Destructive
Inspect

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_delete_imageDelete imageA
DestructiveIdempotent
Inspect

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 templateA
DestructiveIdempotent
Inspect

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 templateA
DestructiveIdempotent
Inspect

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 templateA
DestructiveIdempotent
Inspect

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 codeA
DestructiveIdempotent
Inspect

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 campaignA
Destructive
Inspect

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 messageA
Destructive
Inspect

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 branchesA
Destructive
Inspect

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 / enrichA
Destructive
Inspect

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 workflowA
Destructive
Inspect

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 jobA
Read-onlyIdempotent
Inspect

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 enrichmentA
Read-onlyIdempotent
Inspect

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 CSVA
Read-onlyIdempotent
Inspect

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 ownersA
Read-onlyIdempotent
Inspect

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 personalizationA
Destructive
Inspect

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 historyA
Read-onlyIdempotent
Inspect

Recent runs of a search automation: when, how many found/saved/enriched, and errors.

Inputs: automation_id (required), limit.

spur_get_billing_summaryBilling summaryA
Read-onlyIdempotent
Inspect

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 statsB
Read-onlyIdempotent
Inspect

Delivery and run statistics for one campaign.

Inputs: campaign_id (required).

spur_get_data_catalogData catalog and usageB
Read-onlyIdempotent
Inspect

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 jobA
Read-onlyIdempotent
Inspect

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 analyticsB
Read-onlyIdempotent
Inspect

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 healthB
Read-onlyIdempotent
Inspect

Read sender identities, domain DNS/verification instructions, rotation settings, email analytics or sender stats. Free.

spur_get_field_sourcesGet sources for one fieldA
Read-onlyIdempotent
Inspect

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 HTMLA
Read-onlyIdempotent
Inspect

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 trackingA
Read-onlyIdempotent
Inspect

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 templateA
Read-onlyIdempotent
Inspect

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 messageB
Read-onlyIdempotent
Inspect

Read a sent message's body, delivery details and response context.

Inputs: message_id (required).

spur_get_outreach_reportOutreach reportB
Read-onlyIdempotent
Inspect

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 ownerB
Read-onlyIdempotent
Inspect

Full owner record: contact details, mailing address, enrichment status and their property portfolio in Spur.

Inputs: owner_id (required).

spur_get_personalizationRead personalizationA
Read-onlyIdempotent
Inspect

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 HTMLA
Read-onlyIdempotent
Inspect

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 propertyA
Read-onlyIdempotent
Inspect

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 statusA
Read-onlyIdempotent
Inspect

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 eventsB
Read-onlyIdempotent
Inspect

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 sourcesA
Read-onlyIdempotent
Inspect

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 statsA
Read-onlyIdempotent
Inspect

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 scansA
Read-onlyIdempotent
Inspect

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 scansA
Read-onlyIdempotent
Inspect

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 threadB
Read-onlyIdempotent
Inspect

The full SMS thread with one owner, oldest first.

Inputs: owner_id (required).

spur_get_texting_setupTexting setup statusA
Read-onlyIdempotent
Inspect

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 analyticsC
Read-onlyIdempotent
Inspect

Read dated usage, spend and wallet activity. Free.

Inputs: end, start, group_by.

spur_get_workflowGet outreach workflowA
Read-onlyIdempotent
Inspect

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 onboardingA
Read-onlyIdempotent
Inspect

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 campaignA
Destructive
Inspect

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 campaignsB
Read-onlyIdempotent
Inspect

The user's campaigns (bulk email, SMS, direct mail, outreach) with status and recipient progress.

Inputs: limit, offset, status.

spur_list_data_jobsList research jobsB
Read-onlyIdempotent
Inspect

Recover job IDs, statuses and budgets, including jobs started in the app. Free.

Inputs: limit, offset, status.

spur_list_data_providersList data providersA
Read-onlyIdempotent
Inspect

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 imagesA
Read-onlyIdempotent
Inspect

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 templatesA
Read-onlyIdempotent
Inspect

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 templatesC
Read-onlyIdempotent
Inspect

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 templatesA
Read-onlyIdempotent
Inspect

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 listsA
Read-onlyIdempotent
Inspect

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 codesA
Read-onlyIdempotent
Inspect

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 addressesA
Read-onlyIdempotent
Inspect

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 propertiesB
Read-onlyIdempotent
Inspect

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 automationsA
Read-onlyIdempotent
Inspect

Scheduled property searches with their schedule, filters, and next/last run times.

Inputs: no named parameters.

spur_list_search_tablesList saved searchesC
Read-onlyIdempotent
Inspect

Reopen saved search tables from the app or MCP. Free.

Inputs: limit, offset.

spur_list_sms_conversationsSMS inboxA
Read-onlyIdempotent
Inspect

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 workflowsA
Read-onlyIdempotent
Inspect

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 runsA
Destructive
Inspect

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 domainsB
Destructive
Inspect

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 identitiesA
Destructive
Inspect

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 jobsA
Destructive
Inspect

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 listsA
Destructive
Inspect

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 recordsA
Destructive
Inspect

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 listsA
Destructive
Inspect

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 codesA
Destructive
Inspect

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 redirectsA
Destructive
Inspect

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 addressesA
Destructive
Inspect

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 automationA
Destructive
Inspect

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 rowsA
Destructive
Inspect

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 registrationA
Destructive
Inspect

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 recoveryA
Destructive
Inspect

List deleted records or restore a property, owner, or list. Permanent deletion and empty-trash require explicit confirmation.

spur_manage_workflowWorkflow operations and diagnosticsA
Destructive
Inspect

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_search_queryPreview search filtersA
Read-onlyIdempotent
Inspect

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 feesA
Destructive
Inspect

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 lookupA
Read-onlyIdempotent
Inspect

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 checksA
Read-onlyIdempotent
Inspect

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 launchA
Read-onlyIdempotent
Inspect

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 mailingA
Read-only
Inspect

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 templateA
Read-onlyIdempotent
Inspect

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 campaignA
Read-onlyIdempotent
Inspect

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 SMSA
Read-onlyIdempotent
Inspect

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 templateA
Read-onlyIdempotent
Inspect

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 mailingA
Read-only
Inspect

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 templateA
Read-onlyIdempotent
Inspect

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 providersA
Destructive
Inspect

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 timelineB
Destructive
Inspect

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 numberA
DestructiveIdempotent
Inspect

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 postcardA
Idempotent
Inspect

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 outreachB
Destructive
Inspect

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 jobA
Destructive
Inspect

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 nowA
Destructive
Inspect

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 contactsB
Destructive
Inspect

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 numbersA
Read-onlyIdempotent
Inspect

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)A
Destructive
Inspect

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 contactA
Destructive
Inspect

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 emailB
Destructive
Inspect

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 SMSA
Destructive
Inspect

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 lettersA
Destructive
Inspect

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 postcardsA
Destructive
Inspect

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 SMSA
Destructive
Inspect

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-rechargeA
Destructive
Inspect

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 numberA
Idempotent
Inspect

Make one of the user's bought numbers the default sender for their texts.

Inputs: number_id (required).

spur_set_workflow_activeActivate or pause workflowA
Destructive
Inspect

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 stepA
Idempotent
Inspect

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 upgradeA
Read-onlyIdempotent
Inspect

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 registrationA
Destructive
Inspect

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 templateA
Idempotent
Inspect

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 templateA
Idempotent
Inspect

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 settingsA
Destructive
Inspect

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 templateA
Idempotent
Inspect

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 propertyA
Destructive
Inspect

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 codeA
Idempotent
Inspect

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 templateA
Idempotent
Inspect

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 imageA
Read-onlyIdempotent
Inspect

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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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.
      1
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      B2B 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.
      25
      1,012 npm
      2
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources