{
  "$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"
        ]
      }
    }
  ]
}
