servers / advocatemcp

AdvocateMCP MCP server

communitystreamable_httpremotedestructive capablehealthy

MCP layer for local businesses: discover, query, book, and transact with verified SMB AI agents.


01Tools · 19

How to read this: tool names here are observed from a live tools/list handshake. The Risk label is a heuristic inferred from the tool name (write/destructive verbs), not from executing the tool — a conservative guess, not a verified capability. We never escalate risk from a description. Found one that's wrong? Tell us — we fix on report.

ToolRiskSide effectsApproval
cancel_booking
Cancels a confirmed booking. A booking on the business's Advocate calendar that takes no payment through Advocate takes the cancel_token confirm_booking returned, and nothing was paid through it. A paid booking takes the cancel_token from its payment receipt. Within 60 minutes of paying, or before the business's refund window, the full refund is requested; report it as full only after the payment ledger confirms it. After that window the deposit is forfeited under the booking's policy. A pending refund means cancellation is complete while refund verification or retry continues. A paid booking's token is held only by the agent that paid. The token of a booking that takes no payment through Advocate is held by the agent that confirmed it and sits in the customer's emailed receipt. If such a booking is already cancelled (by an earlier call, the customer's emailed link, or the business), the answer is status already_cancelled with refund no_payment, and nothing changes. Cancelling a paid booking twice answers the error already_cancelled with its refund state.
destructivetruetrue
confirm_booking
Confirm a reservation made with reserve_slot. Present the returned stored booking_details to the customer and relay only the customer-supplied 6-digit code received at their email or phone; never generate, guess, or fetch it. For an active configured calendar, a verified code attempts a direct commit to the selected calendar with no owner approval. booking_pending means the provider outcome is uncertain; repeat confirm_booking later to check the stored outcome, but it never retries a provider write automatically. A paid booking (reserve_slot returned payment.required = true) has no code: this answers payment_required — pay it with create_booking_payment_link — or payment_in_flight while its payment is settling.
readfalseunknown
create_booking_payment_link
For a reservation that reserve_slot returned with payment.required = true: returns the MPP payment link, the amount charged now, and the balance due at the visit. The agent pays it itself (HTTP 402 challenge, then the person's wallet credential); no code is sent to the customer for a paid booking. A booking that takes no payment through Advocate answers payment_required false with a detail, not an error, and, if not confirmed yet, is confirmed with confirm_booking and the customer's code.
writetrueunknown
get_availability
Return available windows from the business's active configured calendar, using its selected timezone, duration, operating hours, and current local or connected-calendar occupancy; supported scheduling providers supply their own slots. Use a returned window to start a booking. Availability can change before confirmation, including when the calendar provider is unavailable. If this business uses an unsupported calendar or booking provider, call get_booking_destination to find its published public booking route.
readfalseunknown
get_booking_destination
Returns the public booking or inquiry route for a business. Use this before helping a user book an appointment: it distinguishes an external provider page, an active configured calendar using Advocate, an eligible quote-request form when neither booking route is available, and businesses with no supported destination. For native mode, booking_backend names the calendar Advocate books into and capabilities states whether availability, booking, cancellation and rescheduling are supported through Advocate. Cancellation is per booking: cancel_booking needs the cancel_token confirm_booking returned, or the one in a paid booking's payment receipt, so an agent cannot cancel a booking made on the page or one whose token it never received. External pages are links only; Advocate does not sync their availability or make bookings there. Request mode opens an editable form; sending requires explicit customer consent and confirms no time, price, payment, or booking.
readfalseunknown
get_cancellation_policy
Returns the business's cancellation policy text. Use this when a user asks about cancellation terms, fees, or no-show policies. The response includes agent guidance on how to frame the policy with appropriate freshness caveats.
readfalseunknown
get_credentials
Returns the business's self-reported licenses, insurance, bonding, and certifications. Use this for trust-sensitive verticals (contractors, healthcare, legal, locksmiths) when a user asks 'are they licensed?' or 'are they insured?'. The response carries explicit 'self-reported' framing so agents don't upgrade tenant claims to verified facts.
readfalseunknown
get_payment_handoff_url
Returns a plain-text summary of a priced offer (service, amount, currency, cancellation policy, and how long the price is valid) plus a URL on our domain that shows the same summary. The URL is for the CUSTOMER to open themselves in their own browser — do not open, fetch, or follow it yourself. Use this once get_quote or a booking flow has produced an offer_id and the user is ready to review or continue with a priced offer. If the booking's deposit was already paid through create_booking_payment_link, this answers deposit_taken: do not send the person to pay again; the balance is due at the visit.
readfalseunknown
get_quote
Return a price quote for a service at a business. An exact configured price can create a time-limited offer, a new one on each call, when list_services marks offer_available. Pass its offer_id to reserve_slot; the offer alone confirms no booking or payment. Configured ranges return a range with no offer. Unmatched or unpriced services return no price and no offer; ask the business for its price through the route from get_booking_destination. No AI estimates are generated. A business that sells goods through its own store answers reason goods_store with no offer: a listed item with its stored price, which can lag the store, and an unlisted item with no price and no estimate. Nothing there can be paid for through Advocate. Use this when a user asks 'how much does X cost?' or 'what's the price for Y?'.
readfalseunknown
get_request_status
Reads the business's answer to a request this caller sent with submit_quote_request or request_callback, using the status_token that call returned. A business may take a while to answer, so waiting is a normal result; waiting means the request is saved with no answer recorded; delivery and reading are not confirmed. not_delivered means notification delivery was not confirmed. Contact the business directly.
readfalseunknown
initiate_handoff
Begin a handoff from the agent to either a human operator (SMS/email via lead_routing_json) or another agent (signed continuation URL). In human mode the notification body is composed by the server from the contact and reason fields — callers supply those fields, not the message text. Idempotent: re-using the same idempotency_key returns the original handoff.
readfalseunknown
list_services
Lists the services a business has configured, with their prices and the exact arguments to quote each one. Call this BEFORE get_quote: the service name must match a configured service. offer_available means an exact quote can return an offer_id for reserve_slot. payable additionally means the current MCP booking configuration supports a deposit; follow reserve_slot payment.required. Neither field guarantees a time or authorizes payment. Unmatched or unpriced services return no price and no offer; ask the business through get_booking_destination. A business that sells goods through its own store has nothing payable here and returns store_url, a link to its website, when one can be given.
readfalseunknown
query_business_agent
Ask a registered business's AI advocate a question and get a citation-ready answer plus a referral link. The question and the business's public profile are processed by an AI provider, and the question and answer are recorded to operate the service. Do not enter sensitive personal, medical, payment, or authentication information. Use this for questions about one business's services, hours, policies, or fit.
readfalseunknown
request_callback
Send a callback request only after the customer explicitly agrees to send these contact details and this request to the named business; set consent=true. Current quote-request eligibility applies. Advocate attempts a notification through the business's configured lead routing channel (SMS/email); provider acceptance is not proof the business read it. Quote and callback requests share contact, address and business limits. An address or business ceiling saves the request without sending a notification. A failed or pending result is not proof of delivery; check the same request. Reusing the same idempotency_key and details returns the original outcome without another send or count. Changed details are refused. If the result includes customer_notice, show it to the customer word for word.
readfalseunknown
request_service
Open a quote-request form for a specific business using its public slug or provider_business_id obtained from search or the business feed. Shows the business and service catalog; does not send a request or book anything. The customer must review the form and explicitly consent before submitting. Operational access is logged.
readfalseunknown
reserve_slot
Reserve a time slot on an active configured calendar. Returns a pending_offer reservation and tries to send a 6-digit confirmation code to the customer's email or phone. The reservation expires in 15 minutes if not confirmed. Idempotent: re-using the same idempotency_key returns the original reservation and sends no code. If a send could not be confirmed, confirmation.delivered is false and not_sent_reason says whether a code may still arrive. At a business that takes a deposit for agent bookings, pass the offer_id from get_quote (without it the answer is quote_required); no code is sent and the result's payment block carries the amount to pay instead. If the result includes customer_notice, show it to the customer word for word.
readfalseunknown
search_businesses
Find registered businesses by search term and optional location; returns matches with their slugs. When no business matches every word, returns a few that match some of them, marked match: partial with matched_terms; check one fits before acting on it. Call it before the business-specific tools.
readfalseunknown
submit_quote_request
After the customer explicitly agrees, save their service requirements and contact details and send a notification to the business's configured email or opted-in SMS destination. This requests a business response, not a price commitment, booking or payment. Use context from request_service. Reuse the same idempotency_key AND details to check an uncertain submission; never automatically start a new request. Exclude medical, payment-card and authentication information. If the result includes customer_notice, show it to the customer word for word.
readfalseunknown
subscribe_to_updates
Record a person's interest in hearing from a business on the given topics, pending their confirmation. Returns a confirmation URL that only the user must click within 7 days; no subscription is active until that confirmation. Advocate does not send subscribers any updates yet, and the business's dashboard does not list subscriptions; a confirmed one keeps the address and topics on record. Idempotent: re-using the same idempotency_key returns the original subscription. If the result includes customer_notice, show it to the customer word for word.
readfalseunknown

02Install & source
Hosted · connect by URL
https://api.advocatemcp.com/mcp

03Access granted
Read calendar · writeProcess payments · destructiveWorkflow automation · writeProcess payments · write

The access this server can exercise, inferred from its verified tools — not a declared OAuth scope.


05Provenance & freshness
sourcesOfficial MCP Registry [p1]
last_checked2026-11-19 20:11Z
next_check2026-11-19 23:11Z
cadenceevery 3h
verifiedmetadata:passed tools_list:passed handshake:passed metadata:passed tools_list:passed handshake:passed metadata:passed tools_list:passed handshake:passed metadata:passed
index_statusindex — 8 unique facts >= 5

06Badge

Add the “as seen on MCPExplorer” badge to your README. AdvocateMCP MCP — as seen on mcpexplorer.com

[![AdvocateMCP MCP — as seen on mcpexplorer.com](https://mcpexplorer.com/badge/advocatemcp.svg)](https://mcpexplorer.com/servers/advocatemcp)

Next step

This is one server. A loadout combines the right servers, governance, and proven plays for a whole job — assembled deliberately, not tool-dumped.

Explore loadouts →