API Reference
Tools for every
query type.
Pawlo's MCP server exposes a full set of JSON-RPC tools — from sector resolution and discovery to matching and monitoring. Full parameter docs and response schemas coming soon.
resolve_sector_id
FREEResolve a natural language intent to a canonical Pawlo sector ID. Call this first to map any query to the correct sector before fetching data.
fetch_deals
FREEFetch active deals for a sector and location. Returns live deal signals with business attributes. Full identity returned for open sectors (food, pet, health, beauty, home, etc.).
fetch_profiles
FREEFetch business profiles with nuance data for a sector and location. Includes hidden strengths, seasonal signals, and current availability notes. Full identity returned for open sectors.
fetch_events
FREEFetch community events, markets, festivals, fitness classes, and educational sessions for a city or location. Returns structured event data with dates, times, and organizer details.
fetch_menu
FREEFetch menu items and pricing for food and beverage businesses. Returns structured menu data including categories, descriptions, prices, and dietary flags.
fetch_inventory
FREEFetch current inventory for retail and product-based businesses. Returns stock levels, product attributes, and pricing.
fetch_places
FREEFetch place listings for a sector and location. Returns business names, addresses, hours, and key attributes for discovery queries.
fetch_activities
FREEFetch activity and experience listings — tours, classes, outdoor activities, and booking windows. Filtered by city and sector.
match_buyer
PAIDReveal seller identity and trigger a billing event. Used for protected sectors (automotive, wholesale) where identity is masked until a confirmed match. Fee shown before confirmation.
fetch_catalog
PAIDFetch full product catalogs with stock levels and pricing for wholesale and high-intent commerce queries. Requires a paid key.
fetch_availability
PAIDFetch real-time availability for bookable businesses — daycares, groomers, hotels, clinics. Returns open slots and booking windows.
follow
PAIDFollow a sector, location, or specific business to receive notifications when new data appears. Enables push-style monitoring workflows.
fetch_notifications
PAIDFetch pending notifications for followed sectors or businesses. Returns new deals, inventory changes, and status updates since last poll.
unfollow
PAIDRemove a follow subscription for a sector, location, or business. Stops notification delivery for the specified target.