{"$schema":"https://modelcontextprotocol.io/schemas/server-card.json","name":"restosignals","title":"RestoSignals: restaurant opening leads","version":"0.2.0","description":"Find US restaurants, bars and cafes 1-6 months before they open, as scored, fused venue leads with owner contact from public filings. Fuses liquor-license, food-permit and new-business-filing open data into one deduped venue with an opening_score (0-100).","websiteUrl":"https://restosignals.com","documentation":"https://restosignals.com/agents/","endpoint":"https://api.restosignals.com/mcp","transport":"streamable-http","protocolVersion":"2025-06-18","serverInfo":{"name":"restosignals","version":"0.2.0"},"authentication":{"type":"oauth2","scheme":"Bearer","authorizationServer":"https://api.restosignals.com/.well-known/oauth-authorization-server","protectedResource":"https://api.restosignals.com/.well-known/oauth-protected-resource","alternatives":[{"type":"apiKey","header":"Authorization","scheme":"Bearer","description":"Bearer pk_... key. Free trial key: POST https://api.restosignals.com/v1/register."}],"description":"OAuth 2.1 with PKCE and dynamic client registration, or a pk_ API key. initialize/tools/list and the coverage tool need no credential."},"provider":{"name":"RestoSignals by Paper and Beyond","url":"https://restosignals.com","email":"support@restosignals.com"},"pricing":{"freeTier":"100 lead credits on email signup, no card (15 for a no-email trial key)","model":"1 credit per returned lead; empty results free","url":"https://restosignals.com/pricing/"},"coverage":"US states NY, TX, IL, CA, OR, CO, WA","tags":["restaurants","bars","new-openings","sales-leads","liquor-licenses","permits","open-data","lead-generation","api","mcp"],"capabilities":{"tools":{"listChanged":false}},"tools":[{"name":"coverage","description":"List the states RestoSignals currently has data for and how many scored venues each holds (with a count of hot leads, opening_score >= 80). Call this FIRST to see live inventory before new_openings — querying a state with no data returns nothing. Free (0 credits) and needs no API key.","inputSchema":{"type":"object","properties":{}}},{"name":"new_openings","description":"Find restaurants/bars about to open in a state, ranked by opening_score (0-100). Fuses liquor licenses, food permits and new-business filings into one scored venue. signal_types on each lead are 'liquor', 'food_permit' and 'business'. Live states: NY, TX, IL, OR, CO, WA, CA (call `coverage` for the current list). 1 credit per returned lead. Each lead has a `contact` block: subscribers get the owner name from the filing plus phone (many NYC venues) and owner mailing address (most TX venues) where public records carry them; trial keys see contact.locked with contact.available telling whether details exist.","inputSchema":{"type":"object","properties":{"state":{"type":"string","description":"Two-letter state, e.g. NY, TX, IL, OR, CO, WA, CA. Use `coverage` to see live states."},"min_score":{"type":"integer","default":30,"description":"Minimum opening_score (0-100). Fused multi-signal venues rank highest; 30 includes recent issued-liquor leads, 80+ is a hot multi-signal lead."},"limit":{"type":"integer","default":10,"description":"Max leads to return (<=100). Each lead costs 1 credit."}},"required":["state"]}},{"name":"watch_area","description":"Register a webhook that fires when a new matching venue opens in an area. criteria = {state, city, signal_type, min_opening_score}. Free.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"HTTPS endpoint to POST matching venues to."},"criteria":{"type":"object","description":"{state, city, signal_type, min_opening_score}."}},"required":["url","criteria"]}},{"name":"venue_signals","description":"Return the raw underlying signals (liquor/permit/business filings) that were fused into one venue, for transparency. 1 credit.","inputSchema":{"type":"object","properties":{"venue_id":{"type":"integer","description":"A venue id from new_openings."}},"required":["venue_id"]}}]}