{"name":"sirchy-mcp","version":"1.0.0","protocolVersion":"2025-03-26","description":"Sirchy MCP Server - Access verified business data for AI platforms","homepage":"https://sirchy.com","documentation":"https://sirchy.com/api/v1/openapi.json","discoveryEndpoint":"https://sirchy.com/.well-known/mcp","capabilities":{"tools":{"listChanged":false},"resources":{"subscribe":false,"listChanged":false}},"rateLimits":{"public":{"requestsPerMinute":60,"requestsPerHour":500},"authenticated":{"requestsPerMinute":300,"requestsPerHour":5000}},"tools":[{"name":"search_businesses","description":"Search for verified businesses on Sirchy by name, category, or location. Returns paginated list of matching businesses with basic info. All businesses are admin-verified.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Search term to find businesses (searches name and description)"},"category":{"type":"string","description":"Filter by category slug (e.g., 'restaurants', 'automotive')"},"city":{"type":"string","description":"Filter by city name (partial match supported)"},"limit":{"type":"number","description":"Max results per page (default 10, max 50)","default":10},"cursor":{"type":"string","description":"Pagination cursor from previous response"}}},"outputSchema":{"type":"object","properties":{"count":{"type":"integer","description":"Number of businesses in this response"},"totalCount":{"type":"integer","description":"Total matching businesses"},"nextCursor":{"type":"string","description":"Cursor for next page (null if no more)"},"businesses":{"type":"array","items":{"$ref":"sirchy://schema/business"}},"timestamp":{"type":"string","format":"date-time"}}}},{"name":"get_business_details","description":"Get detailed information about a specific verified business including products, reviews, services, and booking info.","inputSchema":{"type":"object","properties":{"slug":{"type":"string","description":"The business URL slug (e.g., 'acme-plumbing-auckland')"},"businessId":{"type":"string","format":"uuid","description":"The business UUID (alternative to slug)"}}},"outputSchema":{"type":"object","properties":{"business":{"$ref":"sirchy://schema/business"},"products":{"type":"array","items":{"$ref":"sirchy://schema/product"}},"reviews":{"type":"array","items":{"$ref":"sirchy://schema/review"}},"verificationLevel":{"type":"string","enum":["L0","L1","L2","L3"],"description":"Current verification depth"},"trustScore":{"type":"number","minimum":0,"maximum":1,"description":"Derived trust score"},"lastReviewedAt":{"type":"string","format":"date-time","description":"Last verification review date"},"nextReviewDueAt":{"type":"string","format":"date-time","description":"Next review due date"},"verifiedClaims":{"type":"array","items":{"type":"object"},"description":"Individual verified claims with expiry dates"},"sourceProvenance":{"type":"object","properties":{"platform":{"type":"string","const":"sirchy.com"},"verificationMethod":{"type":"string"},"dataFreshness":{"type":"string","format":"date-time"},"canonicalUrl":{"type":"string","format":"uri"}}},"timestamp":{"type":"string","format":"date-time"}}}},{"name":"search_products","description":"Search for products and services across all verified businesses on Sirchy. Supports price filtering and pagination.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Search term (searches name and description)"},"category":{"type":"string","description":"Business category slug to filter by"},"minPrice":{"type":"number","description":"Minimum price filter"},"maxPrice":{"type":"number","description":"Maximum price filter"},"limit":{"type":"number","description":"Max results per page (default 20, max 100)","default":20},"cursor":{"type":"string","description":"Pagination cursor from previous response"}}},"outputSchema":{"type":"object","properties":{"count":{"type":"integer"},"totalCount":{"type":"integer"},"nextCursor":{"type":"string"},"products":{"type":"array","items":{"$ref":"sirchy://schema/product"}},"timestamp":{"type":"string","format":"date-time"}}}},{"name":"get_reviews","description":"Get SMS-verified customer reviews for a business. Reviews are moderated and verified via SMS before publication.","inputSchema":{"type":"object","properties":{"businessSlug":{"type":"string","description":"The business slug"},"limit":{"type":"number","description":"Max reviews per page (default 10, max 50)","default":10},"cursor":{"type":"string","description":"Pagination cursor from previous response"}},"required":["businessSlug"]},"outputSchema":{"type":"object","properties":{"stats":{"type":"object","properties":{"totalReviews":{"type":"integer"},"avgRating":{"type":"number"},"verifiedCount":{"type":"integer"}}},"reviews":{"type":"array","items":{"$ref":"sirchy://schema/review"}},"nextCursor":{"type":"string"},"timestamp":{"type":"string","format":"date-time"}}}},{"name":"check_availability","description":"Check booking availability for a business. Returns business hours, bookable services, and availability info.","inputSchema":{"type":"object","properties":{"businessSlug":{"type":"string","description":"The business slug"},"serviceId":{"type":"string","format":"uuid","description":"Optional specific service ID to check"},"month":{"type":"string","pattern":"^\\d{4}-\\d{2}$","description":"Month in YYYY-MM format (default: current month)"}},"required":["businessSlug"]},"outputSchema":{"type":"object","properties":{"business":{"type":"object","properties":{"name":{"type":"string"},"timezone":{"type":"string"},"bookingEnabled":{"type":"boolean"}}},"services":{"type":"array","items":{"type":"object"}},"businessHours":{"type":"array","items":{"type":"object"}},"timestamp":{"type":"string","format":"date-time"}}}},{"name":"get_categories","description":"Get all available business categories on Sirchy with business counts.","inputSchema":{"type":"object","properties":{}},"outputSchema":{"type":"object","properties":{"categories":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"},"description":{"type":"string"},"businessCount":{"type":"integer"}}}},"timestamp":{"type":"string","format":"date-time"}}}}],"resources":[{"uri":"sirchy://schema/business","name":"Business Schema","description":"JSON Schema for business entities - defines the canonical structure of a verified business listing","mimeType":"application/schema+json"},{"uri":"sirchy://schema/product","name":"Product Schema","description":"JSON Schema for product/service entities offered by businesses","mimeType":"application/schema+json"},{"uri":"sirchy://schema/review","name":"Review Schema","description":"JSON Schema for SMS-verified customer reviews","mimeType":"application/schema+json"},{"uri":"sirchy://policy/trust-and-verification","name":"Trust & Verification Policy","description":"How Sirchy verifies businesses and reviews - includes verification levels, trust scores, and data provenance","mimeType":"application/json"},{"uri":"sirchy://categories","name":"Business Categories","description":"List of all business categories with counts","mimeType":"application/json"},{"uri":"sirchy://featured-businesses","name":"Featured Businesses","description":"Premium/Enterprise tier verified businesses - highest trust level","mimeType":"application/json"},{"uri":"sirchy://latest-businesses","name":"Latest Businesses","description":"Most recently verified businesses on the platform","mimeType":"application/json"},{"uri":"sirchy://stats","name":"Platform Statistics","description":"Current platform stats with timestamp - verified business count, product count, review count","mimeType":"application/json"}]}