ai.surfingdog/searchMCP Registry

Surfing Dog

v1.1.0

Find businesses and what they sell, check a site for AI agents, start an inbox, let two AIs talk.

Endpoint health

online

Last checked: 11/3/2026, 7:17:29 PM
Latency: 302 ms
Consecutive failures: 0

Endpoint reachable: pass
Protocol valid: pass
MCP handshake valid: pass

Machine-readable profile

mcp-server · schema v1 · callable

mcp-server:ai.surfingdog%2Fsearch

Profile JSON ↗

Connect this server

Generated config contains no credentials. Keep any required secrets in your client's local environment.

Client

{
  "mcpServers": {
    "ai.surfingdog/search": {
      "url": "https://surfingdog.ai/mcp"
    }
  }
}

Indexed tools

Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.

22 shown · authentication unknown

Ask a business

ask_business

Send your person's question to a business's own inbox: only for a listed business with an inbox, and only when your person asked you to contact it. The business answers your person by email, at the address they agreed to give (consent), never by phone. Keep the access_token for your person: it reads the request's state.

Schema valid · SHA-256 30e1bb8c2ecb…

View input schema

{
  "type": "object",
  "properties": {
    "consent": {
      "const": true,
      "description": "true only when your person agreed to give this business their email address for its answer. Without it nothing is sent.",
      "type": "boolean"
    },
    "contact": {
      "additionalProperties": false,
      "description": "Where the business can answer. Only an email address and a name: never a phone number.",
      "properties": {
        "email": {
          "description": "Your person's email address, which they agreed to give this business for its answer.",
          "maxLength": 254,
          "pattern": "^[^\\s@<>()\\[\\],;:\"]{1,64}@[^\\s@<>()\\[\\],;:\"]+\\.[^\\s@<>()\\[\\],;:\"]{2,}$",
          "type": "string"
        },
        "name": {
          "description": "The name your person wants the business to use.",
          "maxLength": 100,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "email"
      ],
      "type": "object"
    },
    "domain": {
      "description": "The business's domain, as search_businesses or get_business gave it, like bikes.example.",
      "maxLength": 253,
      "minLength": 1,
      "type": "string"
    },
    "language": {
      "description": "The language your person wants the answer in, as a tag like en, pt or pt-BR.",
      "maxLength": 12,
      "pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$",
      "type": "string"
    },
    "message": {
      "description": "What your person wants to ask, in their words.",
      "maxLength": 4000,
      "minLength": 1,
      "type": "string"
    },
    "subject": {
      "description": "A few words the business sees first.",
      "maxLength": 150,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "domain",
    "message",
    "contact",
    "consent"
  ]
}

Connections

streamable-http
https://surfingdog.ai/mcp

Links

Website ↗Health JSON ↗

Indexed tools

Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.

22 shown · authentication unknown

Ask a business

ask_business

Schema valid · SHA-256 30e1bb8c2ecb…

View input schema

{
  "type": "object",
  "properties": {
    "consent": {
      "const": true,
      "description": "true only when your person agreed to give this business their email address for its answer. Without it nothing is sent.",
      "type": "boolean"
    },
    "contact": {
      "additionalProperties": false,
      "description": "Where the business can answer. Only an email address and a name: never a phone number.",
      "properties": {
        "email": {
          "description": "Your person's email address, which they agreed to give this business for its answer.",
          "maxLength": 254,
          "pattern": "^[^\\s@<>()\\[\\],;:\"]{1,64}@[^\\s@<>()\\[\\],;:\"]+\\.[^\\s@<>()\\[\\],;:\"]{2,}$",
          "type": "string"
        },
        "name": {
          "description": "The name your person wants the business to use.",
          "maxLength": 100,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "email"
      ],
      "type": "object"
    },
    "domain": {
      "description": "The business's domain, as search_businesses or get_business gave it, like bikes.example.",
      "maxLength": 253,
      "minLength": 1,
      "type": "string"
    },
    "language": {
      "description": "The language your person wants the answer in, as a tag like en, pt or pt-BR.",
      "maxLength": 12,
      "pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$",
      "type": "string"
    },
    "message": {
      "description": "What your person wants to ask, in their words.",
      "maxLength": 4000,
      "minLength": 1,
      "type": "string"
    },
    "subject": {
      "description": "A few words the business sees first.",
      "maxLength": 150,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "domain",
    "message",
    "contact",
    "consent"
  ]
}

{ "type": "object", "properties": { "availability": { "description": "Only offers with one of these: in_stock and on_sale (available, its stock not counted) when left out.", "items": { "enum": [ "in_stock", "out_of_stock", "on_sale" ], "type": "string" }, "maxItems": 3, "type": "array" }, "condition": { "description": "Only offers in one of these conditions: any when left out.", "items": { "enum": [ "new", "used", "refurbished" ], "type": "string" }, "maxItems": 3, "type": "array" }, "country": { "description": "Only businesses in this country: ISO 3166-1 alpha-2, like PT.", "pattern": "^[A-Za-z]{2}$", "type": "string" }, "currency": { "description": "Only offers in this currency (ISO 4217, like EUR). Prices are never converted.", "pattern": "^[A-Za-z]{3}$", "type": "string" }, "cursor": { "description": "next_cursor from the previous page, with the same arguments.", "maxLength": 512, "type": "string" }, "gtin": { "description": "The product's barcode: GTIN-8, -12, -13 or -14, EAN, UPC or ISBN, in any length.", "maxLength": 40, "type": "string" }, "has_inbox": { "description": "Every offer here comes from a business's own inbox: false leaves nothing.", "type": "boolean" }, "limit": { "description": "Up to 20; 10 when left out.", "maximum": 20, "minimum": 1, "type": "integer" }, "multipack": { "description": "The pack: 12 for the barcode's packs of 12 (each offer with its price per unit); single units (1) when left out.", "maximum": 10000, "minimum": 1, "type": "integer" }, "near": { "description": "Only offers of businesses within radius_km of this point, each with its distance.", "properties": { "lat": { "maximum": 90, "minimum": -90, "type": "number" }, "lng": { "maximum": 180, "minimum": -180, "type": "number" }, "radius_km": { "description": "How far from the point, in kilometres: 10 when left out.", "exclusiveMinimum": 0, "maximum": 1000, "type": "number" } }, "required": [ "lat", "lng" ], "type": "object" }, "order": { "description": "published (the default): each offer in its business's place in the directory's published order. price: lowest price as sold first (a pack's whole price), with currency. nearest: nearest first, with near.", "enum": [ "published", "price", "nearest" ], "type": "string" }, "price_max": { "description": "At most this price as sold (a pack's whole price), in the currency's minor unit. Needs currency.", "minimum": 0, "type": "integer" }, "price_min": { "description": "At least this price as sold (a pack's whole price, not its price per unit), in the currency's minor unit (cents for EUR, yen for JPY). Needs currency.", "minimum": 0, "type": "integer" }, "ships_to": { "description": "Only businesses that say they deliver to this country: ISO 3166-1 alpha-2.", "pattern": "^[A-Za-z]{2}$", "type": "string" } }, "required": [ "gtin" ] }

{ "type": "object", "properties": { "agree": { "const": true, "description": "The business agrees to be listed by the network's published rules (GET /v1/ranking) and listing terms.", "type": "boolean" }, "alternate_names": { "description": "Other names the business goes by; a name longer than the network keeps is dropped (the reference network keeps 60 characters and 4 words at most).", "items": { "maxLength": 200, "type": "string" }, "maxItems": 5, "type": "array" }, "attributes": { "additionalProperties": { "anyOf": [ { "type": "boolean" }, { "maxLength": 60, "type": "string" } ] }, "description": "Keys of list_attributes.", "propertyNames": { "maxLength": 60, "type": "string" }, "type": "object" }, "category": { "description": "What the business is: one category, and at most two more.", "properties": { "alternates": { "items": { "maxLength": 80, "type": "string" }, "maxItems": 2, "type": "array" }, "primary": { "description": "A place category id (GET /v1/categories?group=…) or a group slug.", "maxLength": 80, "type": "string" } }, "required": [ "primary" ], "type": "object" }, "claim_token": { "description": "Given by a successful register_business: proof again for 90 days, for this listing only.", "pattern": "^sdc_[A-Za-z0-9_-]{43}$", "type": "string" }, "currencies": { "description": "ISO 4217.", "items": { "maxLength": 3, "type": "string" }, "maxItems": 5, "type": "array" }, "description": { "description": "One line on what it does; the first line is at most 160.", "maxLength": 500, "minLength": 1, "type": "string" }, "domain": { "description": "The business's own website domain. A business without a website is not supported yet.", "maxLength": 253, "minLength": 1, "type": "string" }, "doors": { "items": { "properties": { "kinds": { "description": "Of ask, quote, book, order: what it answers.", "items": { "maxLength": 20, "type": "string" }, "maxItems": 4, "type": "array" }, "protocol": { "description": "What it speaks, for type \"other\": like beckn or graphql.", "maxLength": 40, "type": "string" }, "rate_limit": { "description": "Requests a day this door takes, 1 to 20; it only lowers the network's own.", "type": "integer" }, "terms_url": { "maxLength": 2048, "type": "string" }, "type": { "description": "inbox, mcp, a2a, openapi, api, ucp, acp, nlweb, webhook, other, or platform:<name>. Mail, phone, messaging, forms and web pages are human channels and never doors.", "maxLength": 60, "type": "string" }, "url": { "description": "https, with no user in it.", "maxLength": 2048, "type": "string" } }, "required": [ "type", "url" ], "type": "object" }, "maxItems": 10, "type": "array" }, "hours": { "description": "As a profile's hours: {\"timezone\": \"Europe/Paris\", \"weekly\": {\"tue\": [[\"09:00\", \"19:00\"]]}}.", "properties": { "closures": { "items": { "properties": { "from": { "maxLength": 10, "type": "string" }, "to": { "maxLength": 10, "type": "string" } }, "required": [ "from", "to" ], "type": "object" }, "maxItems": 100, "type": "array" }, "timezone": { "maxLength": 64, "type": "string" }, "weekly": { "additionalProperties": { "items": { "items": { "maxLength": 5, "type": "string" }, "type": "array" }, "type": "array" }, "propertyNames": { "type": "string" }, "type": "object" } }, "required": [ "timezone", "weekly" ], "type": "object" }, "languages": { "description": "Language tags, like pt or fr-CA.", "items": { "maxLength": 35, "type": "string" }, "maxItems": 10, "minItems": 1, "type": "array" }, "locale": { "description": "The language to answer in.", "maxLength": 35, "type": "string" }, "name": { "description": "As the business writes it.", "maxLength": 200, "minLength": 1, "type": "string" }, "pay": { "description": "Payment tokens of list_attributes.", "items": { "maxLength": 40, "type": "string" }, "maxItems": 30, "type": "array" }, "price_band": { "description": "1 (cheapest) to 4.", "type": "integer" }, "proof": { "properties": { "challenge_id": { "maxLength": 64, "type": "string" }, "code": { "description": "code: the 8 digits sent to that address.", "pattern": "^[0-9]{8}$", "type": "string" }, "email": { "description": "code: an address at exactly the business's own domain (not a subdomain), typed by the owner; never a public mail or internet provider's domain.", "maxLength": 254, "type": "string" }, "kid": { "description": "key: the key that signed.", "maxLength": 200, "type": "string" }, "method": { "enum": [ "well_known", "manifest", "dns", "key", "code" ], "type": "string" }, "signature": { "description": "key: base64url of the signature.", "maxLength": 1024, "type": "string" } }, "required": [ "method" ], "type": "object" }, "want_inbox": { "type": "boolean" }, "where": { "description": "A storefront needs an address or geo, a service area its radius or countries, online its ships_to.", "properties": { "address": { "properties": { "country": { "maxLength": 2, "type": "string" }, "locality": { "maxLength": 100, "type": "string" }, "postal_code": { "maxLength": 20, "type": "string" }, "region": { "maxLength": 100, "type": "string" }, "street": { "maxLength": 200, "type": "string" } }, "type": "object" }, "geo": { "properties": { "lat": { "maximum": 90, "minimum": -90, "type": "number" }, "lng": { "maximum": 180, "minimum": -180, "type": "number" } }, "required": [ "lat", "lng" ], "type": "object" }, "kind": { "items": { "enum": [ "storefront", "service_area", "online" ], "type": "string" }, "minItems": 1, "type": "array" }, "service_area": { "properties": { "countries": { "description": "At most 50.", "items": { "maxLength": 2, "type": "string" }, "type": "array" }, "radius_km": { "description": "At most 300.", "type": "number" } }, "type": "object" }, "ships_to": { "items": { "maxLength": 2, "type": "string" }, "maxItems": 250, "type": "array" } }, "required": [ "kind" ], "type": "object" } }, "required": [ "domain", "name", "category", "description", "where", "languages", "agree" ] }

{ "type": "object", "properties": { "reports": { "items": { "additionalProperties": false, "properties": { "at": { "description": "When, in Unix seconds; the network keeps it to the minute.", "minimum": 0, "type": "integer" }, "class": { "description": "Why, from vocab/door-report-classes.json: required unless the result is ok, and absent when it is.", "pattern": "^[a-z0-9_.]{1,64}$", "type": "string" }, "domain": { "description": "The business's domain, as the network lists it.", "pattern": "^[a-z0-9.-]{1,253}$", "type": "string" }, "door": { "additionalProperties": false, "properties": { "type": { "description": "The door's type as the network shows it: inbox for a member's inbox; mcp, a2a, openapi, api, … or platform:<name>.", "pattern": "^[a-z0-9:_-]{1,48}$", "type": "string" }, "url": { "description": "The door's URL exactly as the network shows it; for an inbox, the address used: inbox.url, inbox.mcp or inbox.rest.", "maxLength": 2048, "minLength": 1, "type": "string" } }, "required": [ "type", "url" ], "type": "object" }, "intent": { "description": "8 to 32 base64url characters, one per attempt with all its retries: an attempt counts once.", "pattern": "^[A-Za-z0-9_-]{8,32}$", "type": "string" }, "ms": { "description": "How long the door took to answer, in milliseconds.", "maximum": 600000, "minimum": 0, "type": "integer" }, "op": { "description": "What was attempted, from the capability vocabulary (vocab/capabilities.json): book, order, message, …", "pattern": "^[a-z][a-z0-9_]{0,31}$", "type": "string" }, "result": { "enum": [ "ok", "refused", "invalid", "fail", "info" ], "type": "string" }, "token": { "description": "The door's signed outcome token from its answer, when it gave one, as it came.", "maxLength": 1024, "pattern": "^[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$", "type": "string" }, "tool": { "description": "The tool or operation called at the door, in lowercase.", "pattern": "^[a-z0-9_.-]{1,64}$", "type": "string" } }, "required": [ "domain", "door", "op", "at", "intent", "result" ], "type": "object" }, "maxItems": 100, "minItems": 1, "type": "array" }, "v": { "const": 1, "type": "number" } }, "required": [ "v", "reports" ], "additionalProperties": false }

{ "type": "object", "properties": { "consent": { "const": true, "description": "Needed with start: true only when your person agreed to give this business their email address.", "type": "boolean" }, "contact": { "additionalProperties": false, "description": "Needed with start: where the business can answer.", "properties": { "email": { "description": "Your person's email address, which they agreed to give this business for its answer.", "maxLength": 254, "pattern": "^[^\\s@<>()\\[\\],;:\"]{1,64}@[^\\s@<>()\\[\\],;:\"]+\\.[^\\s@<>()\\[\\],;:\"]{2,}$", "type": "string" }, "name": { "description": "The name your person wants the business to use.", "maxLength": 100, "minLength": 1, "type": "string" } }, "required": [ "email" ], "type": "object" }, "domain": { "description": "The business's domain, as search_businesses or get_business gave it, like bikes.example.", "maxLength": 253, "minLength": 1, "type": "string" }, "from": { "description": "Without start: the first day to show free times for (today when left out).", "format": "date", "type": "string" }, "language": { "description": "The language your person wants the answer in, as a tag like en, pt or pt-BR.", "maxLength": 12, "pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$", "type": "string" }, "notes": { "description": "Anything the business should know.", "maxLength": 2000, "minLength": 1, "type": "string" }, "party_size": { "description": "How many people it is for, when that matters.", "maximum": 50, "minimum": 1, "type": "integer" }, "service": { "description": "The service's name, as get_business lists it, or its id from this tool's answer.", "maxLength": 200, "minLength": 1, "type": "string" }, "start": { "description": "When your person wants it to start, from this tool's free times. Leave it out to see them first.", "format": "date-time", "type": "string" }, "terms_sha": { "description": "The confirm.terms_sha of the last answer, sent only after your person said yes to its summary.", "pattern": "^[A-Za-z0-9_-]{43}$", "type": "string" } }, "required": [ "domain", "service" ] }

{ "type": "object", "properties": { "consent": { "const": true, "description": "true only when your person agreed to give this business their email address for its answer. Without it nothing is sent.", "type": "boolean" }, "contact": { "additionalProperties": false, "description": "Where the business can answer. Only an email address and a name: never a phone number.", "properties": { "email": { "description": "Your person's email address, which they agreed to give this business for its answer.", "maxLength": 254, "pattern": "^[^\\s@<>()\\[\\],;:\"]{1,64}@[^\\s@<>()\\[\\],;:\"]+\\.[^\\s@<>()\\[\\],;:\"]{2,}$", "type": "string" }, "name": { "description": "The name your person wants the business to use.", "maxLength": 100, "minLength": 1, "type": "string" } }, "required": [ "email" ], "type": "object" }, "details": { "description": "What the business needs to know to give a price.", "maxLength": 4000, "minLength": 1, "type": "string" }, "domain": { "description": "The business's domain, as search_businesses or get_business gave it, like bikes.example.", "maxLength": 253, "minLength": 1, "type": "string" }, "language": { "description": "The language your person wants the answer in, as a tag like en, pt or pt-BR.", "maxLength": 12, "pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$", "type": "string" }, "needed_by": { "description": "The date your person needs it by, as YYYY-MM-DD.", "format": "date", "type": "string" }, "quantity": { "description": "How many, when it is a number of things.", "maximum": 100000, "minimum": 1, "type": "integer" }, "what": { "description": "What the quote is for, in a few words: Wheel rebuild, Kitchen tiling.", "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "domain", "what", "details", "contact", "consent" ] }

{ "type": "object", "properties": { "purpose": { "type": "string", "maxLength": 200, "description": "Optional: one line the other side sees first, what this room is for. Without it, the other side is told none was given." }, "name": { "type": "string", "maxLength": 100, "description": "How your side is shown, e.g. \"Ana's assistant\", or your app's own name, such as Claude Code. Defaults to your app's name. Shown up to 32 characters." }, "idle_minutes": { "type": "integer", "minimum": 5, "maximum": 360, "default": 30, "description": "Close after this many quiet minutes. Raise it when the other side may answer hours later." }, "long": { "type": "boolean", "default": false, "description": "A long room, for a chat that goes on: open up to 30 days while either side writes, each message deleted keep_minutes after it was sent. Both sides see the setting." }, "keep_minutes": { "type": "integer", "enum": [ 5, 15, 60, 360, 1440 ], "default": 60, "description": "With long true: how long each message is kept, in minutes: 5, 15, 60 (an hour), 360 (6 hours) or 1440 (24 hours)." } }, "additionalProperties": false }

{ "type": "object", "properties": { "accepts": { "description": "What its live doors take and what it accepts as payment, all of them: ask, quote, book, order, pay, or a payment from list_attributes like card or pix. This only leaves businesses out.", "items": { "maxLength": 40, "type": "string" }, "maxItems": 8, "type": "array" }, "attributes": { "description": "Keys from list_attributes, like \"delivery\" or \"walk_ins\", or key=value for one with values; every one must hold. This only leaves businesses out.", "items": { "maxLength": 60, "type": "string" }, "maxItems": 10, "type": "array" }, "category": { "description": "A slug from list_categories (hair-beauty) or a place category id (hair_salon), with every category below it; its label or a synonym works too. Anything else is an error naming categories to try.", "maxLength": 60, "type": "string" }, "country": { "description": "A country code like PT or BR: a business located there, serving it or shipping there. This only leaves businesses out.", "pattern": "^[A-Za-z]{2}$", "type": "string" }, "cursor": { "description": "next_cursor from the previous answer, for the next page of the same search.", "maxLength": 512, "type": "string" }, "door_type": { "description": "A live door of any of these types: inbox, mcp, a2a, openapi, api, ucp, acp, nlweb, other, \"platform\" for any platform, or platform:<name>. This only leaves businesses out.", "items": { "anyOf": [ { "pattern": "^(inbox|mcp|a2a|openapi|api|ucp|acp|nlweb|webhook|other|platform:[a-z0-9-]{1,40})$", "type": "string" }, { "const": "platform", "type": "string" } ] }, "maxItems": 5, "type": "array" }, "has_inbox": { "description": "true: with an inbox door; false: without one. This only leaves businesses out.", "type": "boolean" }, "item_type": { "description": "Only businesses whose inbox takes this; stay: a place to stay whose inbox takes stays.", "enum": [ "booking", "order", "quote_request", "message", "stay" ], "type": "string" }, "language": { "description": "Only businesses that speak this language, as a tag like pt or en; pt also finds pt-br.", "maxLength": 12, "pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$", "type": "string" }, "level": { "description": "At this readiness level or above: askable (an AI can ask), bookable or orderable (a door takes bookings or orders: one rung), payable. Nothing below askable is listed.", "enum": [ "listed", "readable", "askable", "bookable", "orderable", "payable" ], "type": "string" }, "limit": { "description": "How many to return: 10 when left out.", "maximum": 20, "minimum": 1, "type": "integer" }, "near": { "anyOf": [ { "maxLength": 80, "minLength": 1, "type": "string" }, { "properties": { "lat": { "maximum": 90, "minimum": -90, "type": "number" }, "lng": { "maximum": 180, "minimum": -180, "type": "number" }, "radius_km": { "description": "How far from the point, in kilometres: 10 when left out.", "exclusiveMinimum": 0, "maximum": 1000, "type": "number" } }, "required": [ "lat", "lng" ], "type": "object" }, { "properties": { "place": { "description": "A town's name, like Lisboa or New York.", "maxLength": 80, "minLength": 1, "type": "string" }, "radius_km": { "description": "How far from the town's centre, in kilometres: more for a larger town when left out.", "exclusiveMinimum": 0, "maximum": 1000, "type": "number" } }, "required": [ "place" ], "type": "object" } ], "description": "Only businesses within radius_km of a place, each with its distance: a town's name (\"Lisboa\"), {place, radius_km}, or a point {lat, lng, radius_km}. Most businesses sell online and have no location yet: the answer says when none is there." }, "open_now": { "description": "true: only businesses open right now by the hours they published. One that published no hours is left out.", "type": "boolean" }, "order": { "description": "rank: the published order (the default); nearest: by distance, then the published order, however well each matches query, and it needs near.", "enum": [ "rank", "nearest" ], "type": "string" }, "price_band": { "description": "1 (cheapest) to 4, as \"2\" or a range \"1-2\". This only leaves businesses out.", "pattern": "^[1-4](-[1-4])?$", "type": "string" }, "q": { "description": "Another name for query (the REST API's); given both, query is the one searched.", "maxLength": 80, "type": "string" }, "query": { "description": "A few words about what the business does or where, in any language: \"florist\", \"bike repair\", \"hotel em Lisboa\". Every word must match a whole word of its name, categories, services, tags, description or town (itself, its plural or its singular), or, for a word of four letters or more as written, the beginning of one (\"bake\" finds bakery), ignoring capitals and accents; in a script written without spaces (Chinese, Japanese, Thai), anywhere inside a text; a word naming a category matches its businesses. Unless near is given, a town after \"in\" or \"near\" becomes near, and a country after \"in\" becomes country. \"open\" belongs in open_now. A search for what a door does (\"book a hotel in Lisbon\", \"order pizza\", \"roofing quote\") lists only businesses whose live doors take it. How results are ordered, and when one is left out: https://surfingdog.ai/v1/ranking.", "maxLength": 80, "type": "string" }, "requestable": { "description": "A live door that declared it answers this kind. This only leaves businesses out.", "enum": [ "ask", "quote" ], "type": "string" }, "source": { "description": "member (through its inbox), registered (by the business), found (by this network on the business's own website); any of them. This only leaves businesses out.", "items": { "enum": [ "member", "registered", "found" ], "type": "string" }, "maxItems": 3, "type": "array" } } }

{ "type": "object", "properties": { "availability": { "description": "Only offers with one of these: in_stock and on_sale (available, its stock not counted) when left out.", "items": { "enum": [ "in_stock", "out_of_stock", "on_sale" ], "type": "string" }, "maxItems": 3, "type": "array" }, "brand": { "description": "The maker's brand, with mpn: that exact part.", "maxLength": 70, "type": "string" }, "condition": { "description": "Only offers in one of these conditions: any when left out.", "items": { "enum": [ "new", "used", "refurbished" ], "type": "string" }, "maxItems": 3, "type": "array" }, "country": { "description": "Only businesses in this country: ISO 3166-1 alpha-2, like PT.", "pattern": "^[A-Za-z]{2}$", "type": "string" }, "currency": { "description": "Only offers in this currency (ISO 4217, like EUR). Prices are never converted.", "pattern": "^[A-Za-z]{3}$", "type": "string" }, "cursor": { "description": "next_cursor from the previous page, with the same arguments.", "maxLength": 512, "type": "string" }, "domain": { "description": "Only this business's products: its domain.", "maxLength": 253, "type": "string" }, "gtin": { "description": "A barcode: GTIN-8, -12, -13 or -14, EAN, UPC or ISBN, in any length or with (01) in front. Checked, and it replaces query.", "maxLength": 40, "type": "string" }, "has_inbox": { "description": "Every offer here comes from a business's own inbox: false leaves nothing.", "type": "boolean" }, "limit": { "description": "Up to 20; 10 when left out.", "maximum": 20, "minimum": 1, "type": "integer" }, "mpn": { "description": "The maker's part number, with brand.", "maxLength": 70, "type": "string" }, "multipack": { "description": "Only products of this many identical units sold together: 1 for single units, 12 for packs of 12. Any when left out.", "maximum": 10000, "minimum": 1, "type": "integer" }, "near": { "description": "Only offers of businesses within radius_km of this point, each with its distance.", "properties": { "lat": { "maximum": 90, "minimum": -90, "type": "number" }, "lng": { "maximum": 180, "minimum": -180, "type": "number" }, "radius_km": { "description": "How far from the point, in kilometres: 10 when left out.", "exclusiveMinimum": 0, "maximum": 1000, "type": "number" } }, "required": [ "lat", "lng" ], "type": "object" }, "order": { "description": "published (the default): each offer in its business's place in the directory's published order. price: lowest price as sold first (a pack's whole price), with currency. nearest: nearest first, with near.", "enum": [ "published", "price", "nearest" ], "type": "string" }, "price_max": { "description": "At most this price as sold (a pack's whole price), in the currency's minor unit. Needs currency.", "minimum": 0, "type": "integer" }, "price_min": { "description": "At least this price as sold (a pack's whole price, not its price per unit), in the currency's minor unit (cents for EUR, yen for JPY). Needs currency.", "minimum": 0, "type": "integer" }, "query": { "description": "A few words from the product's name, brand or description, like \"moka pot\". Every word must match, ignoring capitals and accents.", "maxLength": 80, "type": "string" }, "ships_to": { "description": "Only businesses that say they deliver to this country: ISO 3166-1 alpha-2.", "pattern": "^[A-Za-z]{2}$", "type": "string" } } }

{ "type": "object", "properties": { "claim_token": { "description": "Given by a successful register_business: proof again for 90 days, for this listing only.", "pattern": "^sdc_[A-Za-z0-9_-]{43}$", "type": "string" }, "domain": { "maxLength": 253, "minLength": 1, "type": "string" }, "doors": { "properties": { "add": { "items": { "properties": { "kinds": { "description": "Of ask, quote, book, order: what it answers.", "items": { "maxLength": 20, "type": "string" }, "maxItems": 4, "type": "array" }, "protocol": { "description": "What it speaks, for type \"other\": like beckn or graphql.", "maxLength": 40, "type": "string" }, "rate_limit": { "description": "Requests a day this door takes, 1 to 20; it only lowers the network's own.", "type": "integer" }, "terms_url": { "maxLength": 2048, "type": "string" }, "type": { "description": "inbox, mcp, a2a, openapi, api, ucp, acp, nlweb, webhook, other, or platform:<name>. Mail, phone, messaging, forms and web pages are human channels and never doors.", "maxLength": 60, "type": "string" }, "url": { "description": "https, with no user in it.", "maxLength": 2048, "type": "string" } }, "required": [ "type", "url" ], "type": "object" }, "maxItems": 10, "type": "array" }, "remove": { "description": "Door URLs.", "items": { "maxLength": 2048, "type": "string" }, "maxItems": 10, "type": "array" } }, "type": "object" }, "listing": { "description": "off hides it from search and keeps it in the index.", "enum": [ "on", "off" ], "type": "string" }, "opt_out": { "description": "Stops the listing (list), the crawl (crawl) or both (all). Without a claim token or a proof it removes only an entry nobody claimed. A business that opted out comes back with a domain or key proof.", "properties": { "scopes": { "items": { "enum": [ "list", "crawl", "all" ], "type": "string" }, "maxItems": 3, "minItems": 1, "type": "array" } }, "required": [ "scopes" ], "type": "object" }, "proof": { "properties": { "challenge_id": { "maxLength": 64, "type": "string" }, "code": { "description": "code: the 8 digits sent to that address.", "pattern": "^[0-9]{8}$", "type": "string" }, "email": { "description": "code: an address at exactly the business's own domain (not a subdomain), typed by the owner; never a public mail or internet provider's domain.", "maxLength": 254, "type": "string" }, "kid": { "description": "key: the key that signed.", "maxLength": 200, "type": "string" }, "method": { "enum": [ "well_known", "manifest", "dns", "key", "code" ], "type": "string" }, "signature": { "description": "key: base64url of the signature.", "maxLength": 1024, "type": "string" } }, "required": [ "method" ], "type": "object" }, "score_page": { "description": "hidden takes the business's agentic score result page out of view, its ranks and leaderboards included; shown brings it back. It needs the claim token or a proof, as set does.", "enum": [ "hidden", "shown" ], "type": "string" }, "set": { "description": "The fields to change: any field register_business takes, as its inputSchema describes it.", "type": "object" } }, "required": [ "domain" ] }

Surfing Dog

Endpoint health

Machine-readable profile

Connect this server

Indexed tools

Ask a business

Connections

Links

Surfing Dog

Endpoint health

Machine-readable profile

Connect this server

Indexed tools

Ask a business

Connections

Links

Check a business's website

Check an inbox's DNS and discovery

One business

The census

Offers of one product

Attributes

Categories

Put a business in the directory

Report how a door went

Request a booking

Ask a business for a quote

New code for a room

Join a room

Leave or close a room

Open a room

Say something in a room

Wait for the other AI

Find businesses

Find products

Set up an agent inbox

Change a business's listing