Surfing Dog Inbox

Official16 tools

by surfingdogai · TypeScript

Message, ask for a quote or book a call with Surfing Dog, through its open-source inbox.

MCP Server: ai.surfingdog/inbox

This MCP server enables messaging and request workflows with Surfing Dog. It supports sending a message, asking for a quote, or booking a call through Surfing Dog’s open-source inbox. The server is identified by the slug ai-surfingdog-inbox and provides an interaction-focused interface described in its catalog entry.

🛠️ Key Features

Message via Surfing Dog’s open-source inbox
Ask for a quote through the inbox
Book a call via the inbox

🚀 Use Cases

Contact Surfing Dog with a message
Request pricing or a quote
Schedule a call with Surfing Dog

⚡ Developer Benefits

Simple, inbox-based interaction model for messaging, quotes, and call booking

⚠️ Limitations

Catalog data provided does not include additional capabilities, tools, or configuration details beyond the inbox-based workflows

Captured live from the server via tools/list.

get_business_profile

Name, time zone, currency, languages and the item types this business accepts.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

list_services

Bookable services with duration and price. A price per person (price.per = person) is for each person in the booking: send partySize, and the total is the price times it.

Parameters2

cursor	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "maxLength": 200
    },
    "limit": {
      "default": 50,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

list_products

Orderable products with prices in minor units.

Parameters3

cursor	string	optional
limit	integer	optional
q	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "maxLength": 200
    },
    "limit": {
      "default": 50,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "q": {
      "type": "string",
      "maxLength": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

check_availability

Free start times for a service between two instants (at most 14 days). A time that has started, or that starts within the business's minimum notice, is not offered.

Parameters4

service_id	string	required
from	string	required	Start of the window to search, ISO 8601.
to	string	required	End of the window, at most 14 days after from.
party_size	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "service_id": {
      "type": "string",
      "minLength": 1
    },
    "from": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      "description": "Start of the window to search, ISO 8601."
    },
    "to": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      "description": "End of the window, at most 14 days after from."
    },
    "party_size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "required": [
    "service_id",
    "from",
    "to"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

request_quote

Ask for a price on something custom. Creates a quote_request item.

Parameters6

payload	object	required
contact	object	optional
message	string	optional
idempotency_key	string	optional	Same key + same request = same answer. Required for agents.
pass	string	optional	The person's passes (sdpass1_…), space-separated, at most 8: presented to the network that issued each, so the business recognises the customer. Or send them in the Sdi-Pass header. Never stored.
key	string	optional	The person's key (sdkey1_…), if that is all you have: it is exchanged once for a pass, which comes back in identity.passes — keep the pass and send it next time instead. Never stored.

Raw schema

{
  "type": "object",
  "properties": {
    "payload": {
      "type": "object",
      "properties": {
        "itemOffered": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            },
            "sku": {
              "type": "string",
              "maxLength": 100
            },
            "serviceId": {
              "type": "string"
            },
            "productId": {
              "type": "string"
            }
          },
          "required": [
            "name"
          ]
        },
        "quantity": {
          "type": "integer",
          "minimum": 1,
          "maximum": 9007199254740991
        },
        "description": {
          "type": "string",
          "minLength": 1,
          "maxLength": 5000
        },
        "budget": {
          "type": "object",
          "properties": {
            "value": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "currency": {
              "type": "string",
              "minLength": 3,
              "maxLength": 3
            }
          },
          "required": [
            "value",
            "currency"
          ]
        },
        "requestedFor": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
        },
        "deliveryAddress": {
          "type": "object",
          "properties": {
            "streetAddress": {
              "type": "string",
              "maxLength": 200
            },
            "addressLocality": {
              "type": "string",
              "maxLength": 100
            },
            "addressRegion": {
              "type": "string",
              "maxLength": 100
            },
            "postalCode": {
              "type": "string",
              "maxLength": 20
            },
            "addressCountry": {
              "type": "string",
              "minLength": 2,
              "maxLength": 2
            }
          }
        }
      },
      "required": [
        "itemOffered",
        "description"
      ]
    },
    "contact": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "maxLength": 200
        },
        "email": {
          "type": "string",
          "format": "email",
          "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
        },
        "phone": {
          "type": "string",
          "maxLength": 40
        },
        "locale": {
          "type": "string",
          "maxLength": 12
        }
      }
    },
    "message": {
      "type": "string",
      "maxLength": 20000
    },
    "idempotency_key": {
      "description": "Same key + same request = same answer. Required for agents.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "pass": {
      "description": "The person's passes (sdpass1_…), space-separated, at most 8: presented to the network that issued each, so the business recognises the customer. Or send them in the Sdi-Pass header. Never stored.",
      "type": "string",
      "maxLength": 1608
    },
    "key": {
      "description": "The person's key (sdkey1_…), if that is all you have: it is exchanged once for a pass, which comes back in identity.passes — keep the pass and send it next time instead. Never stored.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "payload"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

create_booking

Request a service at a time. Check availability first. A fixed-price service costs the business's price from list_services; a different totalPrice you send is only noted for the business. Returns the item and, if you have no account, an access_token.

Parameters6

payload	object	required
contact	object	optional
message	string	optional
idempotency_key	string	optional	Same key + same request = same answer. Required for agents.
pass	string	optional	The person's passes (sdpass1_…), space-separated, at most 8: presented to the network that issued each, so the business recognises the customer. Or send them in the Sdi-Pass header. Never stored.
key	string	optional	The person's key (sdkey1_…), if that is all you have: it is exchanged once for a pass, which comes back in identity.passes — keep the pass and send it next time instead. Never stored.

Raw schema

{
  "type": "object",
  "properties": {
    "payload": {
      "type": "object",
      "properties": {
        "reservationFor": {
          "type": "object",
          "properties": {
            "serviceId": {
              "type": "string",
              "minLength": 1
            },
            "name": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          "required": [
            "serviceId",
            "name"
          ]
        },
        "startTime": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
        },
        "endTime": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
        },
        "partySize": {
          "type": "integer",
          "minimum": 1,
          "maximum": 1000
        },
        "totalPrice": {
          "type": "object",
          "properties": {
            "value": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "currency": {
              "type": "string",
              "minLength": 3,
              "maxLength": 3
            }
          },
          "required": [
            "value",
            "currency"
          ]
        },
        "resourceId": {
          "type": "string"
        },
        "notes": {
          "type": "string",
          "maxLength": 5000
        }
      },
      "required": [
        "reservationFor",
        "startTime",
        "endTime"
      ]
    },
    "contact": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "maxLength": 200
        },
        "email": {
          "type": "string",
          "format": "email",
          "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
        },
        "phone": {
          "type": "string",
          "maxLength": 40
        },
        "locale": {
          "type": "string",
          "maxLength": 12
        }
      }
    },
    "message": {
      "type": "string",
      "maxLength": 20000
    },
    "idempotency_key": {
      "description": "Same key + same request = same answer. Required for agents.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "pass": {
      "description": "The person's passes (sdpass1_…), space-separated, at most 8: presented to the network that issued each, so the business recognises the customer. Or send them in the Sdi-Pass header. Never stored.",
      "type": "string",
      "maxLength": 1608
    },
    "key": {
      "description": "The person's key (sdkey1_…), if that is all you have: it is exchanged once for a pass, which comes back in identity.passes — keep the pass and send it next time instead. Never stored.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "payload"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

create_order

Order products. Prices are in minor units. A line naming a product (productId or sku) costs the business's price from list_products, and the total follows; a different price you send is only noted for the business. A line naming no product waits for the business to price it.

Parameters6

payload	object	required
contact	object	optional
message	string	optional
idempotency_key	string	optional	Same key + same request = same answer. Required for agents.
pass	string	optional	The person's passes (sdpass1_…), space-separated, at most 8: presented to the network that issued each, so the business recognises the customer. Or send them in the Sdi-Pass header. Never stored.
key	string	optional	The person's key (sdkey1_…), if that is all you have: it is exchanged once for a pass, which comes back in identity.passes — keep the pass and send it next time instead. Never stored.

Raw schema

{
  "type": "object",
  "properties": {
    "payload": {
      "type": "object",
      "properties": {
        "orderedItem": {
          "minItems": 1,
          "maxItems": 200,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "productId": {
                "type": "string"
              },
              "sku": {
                "type": "string",
                "maxLength": 100
              },
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200
              },
              "quantity": {
                "type": "integer",
                "minimum": 1,
                "maximum": 9007199254740991
              },
              "price": {
                "type": "object",
                "properties": {
                  "value": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "currency": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 3
                  }
                },
                "required": [
                  "value",
                  "currency"
                ]
              }
            },
            "required": [
              "name",
              "quantity",
              "price"
            ]
          }
        },
        "totalPrice": {
          "type": "object",
          "properties": {
            "value": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "currency": {
              "type": "string",
              "minLength": 3,
              "maxLength": 3
            }
          },
          "required": [
            "value",
            "currency"
          ]
        },
        "billingAddress": {
          "type": "object",
          "properties": {
            "streetAddress": {
              "type": "string",
              "maxLength": 200
            },
            "addressLocality": {
              "type": "string",
              "maxLength": 100
            },
            "addressRegion": {
              "type": "string",
              "maxLength": 100
            },
            "postalCode": {
              "type": "string",
              "maxLength": 20
            },
            "addressCountry": {
              "type": "string",
              "minLength": 2,
              "maxLength": 2
            }
          }
        },
        "shippingAddress": {
          "type": "object",
          "properties": {
            "streetAddress": {
              "type": "string",
              "maxLength": 200
            },
            "addressLocality": {
              "type": "string",
              "maxLength": 100
            },
            "addressRegion": {
              "type": "string",
              "maxLength": 100
            },
            "postalCode": {
              "type": "string",
              "maxLength": 20
            },
            "addressCountry": {
              "type": "string",
              "minLength": 2,
              "maxLength": 2
            }
          }
        },
        "delivery": {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "pickup",
                "delivery",
                "digital"
              ]
            },
            "when": {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
            }
          },
          "required": [
            "method"
          ]
        },
        "paymentMethod": {
          "type": "string",
          "maxLength": 60
        },
        "notes": {
          "type": "string",
          "maxLength": 5000
        }
      },
      "required": [
        "orderedItem",
        "totalPrice"
      ]
    },
    "contact": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "maxLength": 200
        },
        "email": {
          "type": "string",
          "format": "email",
          "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
        },
        "phone": {
          "type": "string",
          "maxLength": 40
        },
        "locale": {
          "type": "string",
          "maxLength": 12
        }
      }
    },
    "message": {
      "type": "string",
      "maxLength": 20000
    },
    "idempotency_key": {
      "description": "Same key + same request = same answer. Required for agents.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "pass": {
      "description": "The person's passes (sdpass1_…), space-separated, at most 8: presented to the network that issued each, so the business recognises the customer. Or send them in the Sdi-Pass header. Never stored.",
      "type": "string",
      "maxLength": 1608
    },
    "key": {
      "description": "The person's key (sdkey1_…), if that is all you have: it is exchanged once for a pass, which comes back in identity.passes — keep the pass and send it next time instead. Never stored.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "payload"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_item_status

The current state of an item you created, in the business's words: what it proposed and waits for your person to answer (offer, with its terms_sha), who it waits on, what they can do next, and the conversation so far (thread: the business's replies and your person's messages).

Parameters4

item_id	string	required
access_token	string	optional	Capability secret returned when the item was created without an account.
pass	string	optional	The person's passes (sdpass1_…), space-separated, at most 8: presented to the network that issued each, so the business recognises the customer. Or send them in the Sdi-Pass header. Never stored.
key	string	optional	The person's key (sdkey1_…), if that is all you have: it is exchanged once for a pass, which comes back in identity.passes — keep the pass and send it next time instead. Never stored.

Raw schema

{
  "type": "object",
  "properties": {
    "item_id": {
      "type": "string",
      "minLength": 1
    },
    "access_token": {
      "description": "Capability secret returned when the item was created without an account.",
      "type": "string",
      "minLength": 16,
      "maxLength": 200
    },
    "pass": {
      "description": "The person's passes (sdpass1_…), space-separated, at most 8: presented to the network that issued each, so the business recognises the customer. Or send them in the Sdi-Pass header. Never stored.",
      "type": "string",
      "maxLength": 1608
    },
    "key": {
      "description": "The person's key (sdkey1_…), if that is all you have: it is exchanged once for a pass, which comes back in identity.passes — keep the pass and send it next time instead. Never stored.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "item_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

accept_offer

Accept another time the business proposed for a booking, or its quote. This binds your person, so send terms_sha — offer.terms_sha from get_item_status — only after they said yes to offer.human. Without terms_sha nothing is booked: you get the terms to show them. An accepted quote becomes a confirmed booking or order (linked).

Parameters6

item_id	string	required
terms_sha	string	optional	The fingerprint of the terms your person said yes to: offer.terms_sha from get_item_status. Leave it out to be told the terms first; nothing is booked without it.
access_token	string	optional	Capability secret returned when the item was created without an account.
idempotency_key	string	optional	Same key + same request = same answer. Required for agents.
pass	string	optional	The person's passes (sdpass1_…), space-separated, at most 8: presented to the network that issued each, so the business recognises the customer. Or send them in the Sdi-Pass header. Never stored.
key	string	optional	The person's key (sdkey1_…), if that is all you have: it is exchanged once for a pass, which comes back in identity.passes — keep the pass and send it next time instead. Never stored.

Raw schema

{
  "type": "object",
  "properties": {
    "item_id": {
      "type": "string",
      "minLength": 1
    },
    "terms_sha": {
      "description": "The fingerprint of the terms your person said yes to: offer.terms_sha from get_item_status. Leave it out to be told the terms first; nothing is booked without it.",
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{43}$"
    },
    "access_token": {
      "description": "Capability secret returned when the item was created without an account.",
      "type": "string",
      "minLength": 16,
      "maxLength": 200
    },
    "idempotency_key": {
      "description": "Same key + same request = same answer. Required for agents.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "pass": {
      "description": "The person's passes (sdpass1_…), space-separated, at most 8: presented to the network that issued each, so the business recognises the customer. Or send them in the Sdi-Pass header. Never stored.",
      "type": "string",
      "maxLength": 1608
    },
    "key": {
      "description": "The person's key (sdkey1_…), if that is all you have: it is exchanged once for a pass, which comes back in identity.passes — keep the pass and send it next time instead. Never stored.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "item_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

decline_offer

Say no to another time the business proposed (the booking request is closed) or to its quote. Add reason for anything your person wants the business to know.

Parameters6

item_id	string	required
reason	string	optional	Anything your person wants the business to know.
access_token	string	optional	Capability secret returned when the item was created without an account.
idempotency_key	string	optional	Same key + same request = same answer. Required for agents.
pass	string	optional	The person's passes (sdpass1_…), space-separated, at most 8: presented to the network that issued each, so the business recognises the customer. Or send them in the Sdi-Pass header. Never stored.
key	string	optional	The person's key (sdkey1_…), if that is all you have: it is exchanged once for a pass, which comes back in identity.passes — keep the pass and send it next time instead. Never stored.

Raw schema

{
  "type": "object",
  "properties": {
    "item_id": {
      "type": "string",
      "minLength": 1
    },
    "reason": {
      "description": "Anything your person wants the business to know.",
      "type": "string",
      "maxLength": 2000
    },
    "access_token": {
      "description": "Capability secret returned when the item was created without an account.",
      "type": "string",
      "minLength": 16,
      "maxLength": 200
    },
    "idempotency_key": {
      "description": "Same key + same request = same answer. Required for agents.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "pass": {
      "description": "The person's passes (sdpass1_…), space-separated, at most 8: presented to the network that issued each, so the business recognises the customer. Or send them in the Sdi-Pass header. Never stored.",
      "type": "string",
      "maxLength": 1608
    },
    "key": {
      "description": "The person's key (sdkey1_…), if that is all you have: it is exchanged once for a pass, which comes back in identity.passes — keep the pass and send it next time instead. Never stored.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "item_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

suggest_time

Instead of the time the business proposed, ask for another: start_time must be one of the free times check_availability lists (the end follows the service's length). The business confirms it or proposes again.

Parameters7

item_id	string	required
start_time	string	required	The start your person would like instead: one of the free times check_availability lists. The end follows the service's length.
note	string	optional
access_token	string	optional	Capability secret returned when the item was created without an account.
idempotency_key	string	optional	Same key + same request = same answer. Required for agents.
pass	string	optional	The person's passes (sdpass1_…), space-separated, at most 8: presented to the network that issued each, so the business recognises the customer. Or send them in the Sdi-Pass header. Never stored.
key	string	optional	The person's key (sdkey1_…), if that is all you have: it is exchanged once for a pass, which comes back in identity.passes — keep the pass and send it next time instead. Never stored.

Raw schema

{
  "type": "object",
  "properties": {
    "item_id": {
      "type": "string",
      "minLength": 1
    },
    "start_time": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      "description": "The start your person would like instead: one of the free times check_availability lists. The end follows the service's length."
    },
    "note": {
      "type": "string",
      "maxLength": 2000
    },
    "access_token": {
      "description": "Capability secret returned when the item was created without an account.",
      "type": "string",
      "minLength": 16,
      "maxLength": 200
    },
    "idempotency_key": {
      "description": "Same key + same request = same answer. Required for agents.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "pass": {
      "description": "The person's passes (sdpass1_…), space-separated, at most 8: presented to the network that issued each, so the business recognises the customer. Or send them in the Sdi-Pass header. Never stored.",
      "type": "string",
      "maxLength": 1608
    },
    "key": {
      "description": "The person's key (sdkey1_…), if that is all you have: it is exchanged once for a pass, which comes back in identity.passes — keep the pass and send it next time instead. Never stored.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "item_id",
    "start_time"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

provide_details

Answer what the business asked about an item (get_item_status says it needs a detail). The item moves on; on any other item your details are kept as a message for the business.

Parameters6

item_id	string	required
details	string	required	The answer to what the business asked.
access_token	string	optional	Capability secret returned when the item was created without an account.
idempotency_key	string	optional	Same key + same request = same answer. Required for agents.
pass	string	optional	The person's passes (sdpass1_…), space-separated, at most 8: presented to the network that issued each, so the business recognises the customer. Or send them in the Sdi-Pass header. Never stored.
key	string	optional	The person's key (sdkey1_…), if that is all you have: it is exchanged once for a pass, which comes back in identity.passes — keep the pass and send it next time instead. Never stored.

Raw schema

{
  "type": "object",
  "properties": {
    "item_id": {
      "type": "string",
      "minLength": 1
    },
    "details": {
      "type": "string",
      "minLength": 1,
      "maxLength": 5000,
      "description": "The answer to what the business asked."
    },
    "access_token": {
      "description": "Capability secret returned when the item was created without an account.",
      "type": "string",
      "minLength": 16,
      "maxLength": 200
    },
    "idempotency_key": {
      "description": "Same key + same request = same answer. Required for agents.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "pass": {
      "description": "The person's passes (sdpass1_…), space-separated, at most 8: presented to the network that issued each, so the business recognises the customer. Or send them in the Sdi-Pass header. Never stored.",
      "type": "string",
      "maxLength": 1608
    },
    "key": {
      "description": "The person's key (sdkey1_…), if that is all you have: it is exchanged once for a pass, which comes back in identity.passes — keep the pass and send it next time instead. Never stored.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "item_id",
    "details"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

cancel_item

Cancel an item you created. After the business's cancellation window, a confirmed booking is cancelled late where the business records late cancellations (it may count against the customer), and refused where it does not.

Parameters6

item_id	string	required
reason	string	optional
access_token	string	optional	Capability secret returned when the item was created without an account.
idempotency_key	string	optional	Same key + same request = same answer. Required for agents.
pass	string	optional	The person's passes (sdpass1_…), space-separated, at most 8: presented to the network that issued each, so the business recognises the customer. Or send them in the Sdi-Pass header. Never stored.
key	string	optional	The person's key (sdkey1_…), if that is all you have: it is exchanged once for a pass, which comes back in identity.passes — keep the pass and send it next time instead. Never stored.

Raw schema

{
  "type": "object",
  "properties": {
    "item_id": {
      "type": "string",
      "minLength": 1
    },
    "reason": {
      "type": "string",
      "maxLength": 2000
    },
    "access_token": {
      "description": "Capability secret returned when the item was created without an account.",
      "type": "string",
      "minLength": 16,
      "maxLength": 200
    },
    "idempotency_key": {
      "description": "Same key + same request = same answer. Required for agents.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "pass": {
      "description": "The person's passes (sdpass1_…), space-separated, at most 8: presented to the network that issued each, so the business recognises the customer. Or send them in the Sdi-Pass header. Never stored.",
      "type": "string",
      "maxLength": 1608
    },
    "key": {
      "description": "The person's key (sdkey1_…), if that is all you have: it is exchanged once for a pass, which comes back in identity.passes — keep the pass and send it next time instead. Never stored.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "item_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

send_message

Start a conversation, or reply on an item you own.

Parameters9

item_id	string	optional	Reply on an existing item; omit to start a new conversation.
subject	string	optional
body	string	required
contact	object	optional
message_id	string	optional
access_token	string	optional	Capability secret returned when the item was created without an account.
idempotency_key	string	optional	Same key + same request = same answer. Required for agents.
pass	string	optional	The person's passes (sdpass1_…), space-separated, at most 8: presented to the network that issued each, so the business recognises the customer. Or send them in the Sdi-Pass header. Never stored.
key	string	optional	The person's key (sdkey1_…), if that is all you have: it is exchanged once for a pass, which comes back in identity.passes — keep the pass and send it next time instead. Never stored.

Raw schema

{
  "type": "object",
  "properties": {
    "item_id": {
      "description": "Reply on an existing item; omit to start a new conversation.",
      "type": "string",
      "minLength": 1
    },
    "subject": {
      "type": "string",
      "maxLength": 500
    },
    "body": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20000
    },
    "contact": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "maxLength": 200
        },
        "email": {
          "type": "string",
          "format": "email",
          "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
        },
        "phone": {
          "type": "string",
          "maxLength": 40
        },
        "locale": {
          "type": "string",
          "maxLength": 12
        }
      }
    },
    "message_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 998
    },
    "access_token": {
      "description": "Capability secret returned when the item was created without an account.",
      "type": "string",
      "minLength": 16,
      "maxLength": 200
    },
    "idempotency_key": {
      "description": "Same key + same request = same answer. Required for agents.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "pass": {
      "description": "The person's passes (sdpass1_…), space-separated, at most 8: presented to the network that issued each, so the business recognises the customer. Or send them in the Sdi-Pass header. Never stored.",
      "type": "string",
      "maxLength": 1608
    },
    "key": {
      "description": "The person's key (sdkey1_…), if that is all you have: it is exchanged once for a pass, which comes back in identity.passes — keep the pass and send it next time instead. Never stored.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "body"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

acknowledge_receipt

Counter-sign a receipt this item earned, so both sides hold it. Read the item to find its receipts; then send a compact JWS signed with your own Ed25519 key — header {alg:'EdDSA', typ:'sdi-receipt-ack+jws', jwk:<your public jwk>}, payload {rcp:<receipt id>, sha:<base64url(SHA-256(receipt jws))>, iat:<unix seconds>}. The instance verifies it against the key you carry and keeps it. Acknowledging twice is harmless.

Parameters7

item_id	string	required
counter_signature	string	optional	A compact JWS by the customer's agent, EdDSA, header carrying its Ed25519 public `jwk`, payload `{"rcp": "<receipt id>", "sha": "<base64url(SHA-256(receipt JWS))>", "iat": <unix seconds>}`. Or, for an agent that signs its requests instead (sdi-agent/1) and carries a pass reference, `receipt_id` alone.
receipt_id	string	optional	The receipt to acknowledge, for an agent that signs this request (sdi-agent/1) with a key delegated to the pass reference it sends: the inbox forwards the signature to the network (ADR-017 §3.4). Send this or counter_signature.
receipt	string	optional	The receipt JWS being acknowledged, if you want the instance to check it is the one it holds.
access_token	string	optional	Capability secret returned when the item was created without an account.
pass	string	optional	The person's passes (sdpass1_…), space-separated, at most 8: presented to the network that issued each, so the business recognises the customer. Or send them in the Sdi-Pass header. Never stored.
key	string	optional	The person's key (sdkey1_…), if that is all you have: it is exchanged once for a pass, which comes back in identity.passes — keep the pass and send it next time instead. Never stored.

Raw schema

{
  "type": "object",
  "properties": {
    "item_id": {
      "type": "string",
      "minLength": 1
    },
    "counter_signature": {
      "description": "A compact JWS by the customer's agent, EdDSA, header carrying its Ed25519 public `jwk`, payload `{\"rcp\": \"<receipt id>\", \"sha\": \"<base64url(SHA-256(receipt JWS))>\", \"iat\": <unix seconds>}`. Or, for an agent that signs its requests instead (sdi-agent/1) and carries a pass reference, `receipt_id` alone.",
      "type": "string",
      "minLength": 1,
      "maxLength": 8192
    },
    "receipt_id": {
      "description": "The receipt to acknowledge, for an agent that signs this request (sdi-agent/1) with a key delegated to the pass reference it sends: the inbox forwards the signature to the network (ADR-017 §3.4). Send this or counter_signature.",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "receipt": {
      "description": "The receipt JWS being acknowledged, if you want the instance to check it is the one it holds.",
      "type": "string",
      "minLength": 1,
      "maxLength": 8192
    },
    "access_token": {
      "description": "Capability secret returned when the item was created without an account.",
      "type": "string",
      "minLength": 16,
      "maxLength": 200
    },
    "pass": {
      "description": "The person's passes (sdpass1_…), space-separated, at most 8: presented to the network that issued each, so the business recognises the customer. Or send them in the Sdi-Pass header. Never stored.",
      "type": "string",
      "maxLength": 1608
    },
    "key": {
      "description": "The person's key (sdkey1_…), if that is all you have: it is exchanged once for a pass, which comes back in identity.passes — keep the pass and send it next time instead. Never stored.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "item_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

verify_customer

When a result says identity.recognised is weak, the person gave the email of a customer the business knows. Call this with item_id and access_token to email them six digits; ask the person for the code and call it again with code. Then the business recognises them.

Parameters3

item_id	string	required
access_token	string	optional	Capability secret returned when the item was created without an account.
code	string	optional	The six digits the customer received. Omit to have them sent.

Raw schema

{
  "type": "object",
  "properties": {
    "item_id": {
      "type": "string",
      "minLength": 1
    },
    "access_token": {
      "description": "Capability secret returned when the item was created without an account.",
      "type": "string",
      "minLength": 16,
      "maxLength": 200
    },
    "code": {
      "description": "The six digits the customer received. Omit to have them sent.",
      "type": "string",
      "pattern": "^[0-9]{6}$"
    }
  },
  "required": [
    "item_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

README.md3 KBView on GitHub

Surfing Dog Inbox

An inbox for the bookings, orders, quote requests and messages that people and their AI agents send a business. Your rules answer the routine ones, and you see the rest. Open source, and you run it.

Try it in 60 seconds

Add our demo bike shop to Claude or ChatGPT as a custom connector (an MCP server):

code

https://demo.surfingdog.ai/mcp

Then ask it: "Book a bike service with Oficina Maré on Saturday morning." Watch the booking arrive, and the shop confirm it, at https://demo.surfingdog.ai/demo/live. The demo never emails anyone who uses it, shows no names and is wiped every night.

The same with curl, step by step: https://surfingdog.ai/try/

Install

Node 22.16+, 24 or 26. One process and one SQLite file.

bash

git clone https://github.com/surfingdogai/inbox && cd inbox
pnpm install
pnpm --filter @surfingdog/inbox build
node apps/inbox/dist/server.mjs        # http://localhost:8787

Docker, built from this repository. The database lives in the volume.

bash

docker build -t surfingdog-inbox .
docker run -p 8787:8787 -v inbox-data:/opt/inbox/data surfingdog-inbox

Cloudflare Workers, with D1, a queue and a cron. Press Deploy to Cloudflare. What to have ready, and what to do after, is in the quickstart. By hand, it's path A of the install guide.

Or give your AI the install guide and let it do the work: it is written for that, with a check after every step.

Docs

Quickstart: every setting, Docker, and a public demo of your own
Connect your AI: the owner's MCP server
API: REST and MCP; every instance also serves /openapi.json
Decision records: read these before changing how things work

Working on it

bash

pnpm dev               # the server on Node, http://localhost:8787
pnpm dev:workers       # the same app on workerd
pnpm test              # every test, on Node and on Workers
./scripts/verify.sh    # everything CI runs

apps/inbox: the server and the owner app, one codebase for Workers and Node
apps/site: surfingdog.ai, with the docs
packages/core: items, their states, rules and receipts
packages/adapters: REST, MCP, sign-in, email in, webhooks and networks
packages/platform: the database, mail and job seams for each runtime
packages/spec: the discovery manifest and receipt formats, with test vectors
packages/sdk: verify webhooks; sign requests and check receipts from a customer's agent
packages/ui: design tokens and components
packages/network-check: checks a network against the network protocol
examples/network: a small network of your own, at the protocol's directory level

Licence

AGPL-3.0 for the server and the app. MIT for packages/spec, packages/sdk, packages/network-check and examples/network.

Install

Tools (16)

get_business_profilelist_serviceslist_productscheck_availabilityrequest_quotecreate_bookingcreate_orderget_item_status

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://inbox.surfingdog.ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "inbox": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://inbox.surfingdog.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

MCP Server: ai.surfingdog/inbox

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

get_business_profile

list_services

list_products

check_availability

request_quote

create_booking

create_order

get_item_status

accept_offer

decline_offer

suggest_time

provide_details

cancel_item

send_message

acknowledge_receipt

verify_customer

Surfing Dog Inbox

Try it in 60 seconds

Install

Docs

Working on it

Licence

Install

Remote endpoint

Related servers