GoTable MCP by usefulapi is an MCP server published by io.usefulapi, hosted at gotable.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 21 tools, including gotable_list_restaurants, gotable_get_restaurant, gotable_list_accounts, gotable_get_availability, gotable_get_offer_availability.
Read availability, reservations, guests; create, change, cancel bookings; add notes in GoTable.
3,994 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
List the restaurants this API key can access (id, name, address, time zone, currency). Call this first: every other tool needs a restaurant_id. GoTable API: GET /api/v1/restaurants.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| per_page | integer | Results per page (max 100). |
{
"name": "gotable_list_restaurants",
"title": "List restaurants",
"description": "List the restaurants this API key can access (id, name, address, time zone, currency). Call this first: every other tool needs a restaurant_id. GoTable API: GET /api/v1/restaurants.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number (default 1).",
"exclusiveMinimum": 0
},
"per_page": {
"type": "integer",
"maximum": 100,
"description": "Results per page (max 100).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List restaurants",
"readOnlyHint": true
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Get one restaurant by id. GoTable API: GET /api/v1/restaurants/{restaurant_id}.
| Parameter | Type | Description |
|---|---|---|
| restaurant_id * | integer | Restaurant id (from gotable_list_restaurants). |
{
"name": "gotable_get_restaurant",
"title": "Get a restaurant",
"description": "Get one restaurant by id. GoTable API: GET /api/v1/restaurants/{restaurant_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"restaurant_id"
],
"properties": {
"restaurant_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restaurant id (from gotable_list_restaurants)."
}
}
},
"annotations": {
"title": "Get a restaurant",
"readOnlyHint": true
}
}List the staff accounts that have access to a restaurant (id, name, e-mail). The account id is the author_id that gotable_create_reservation_note needs. GoTable API: GET /api/v1/restaurants/{restaurant_id}/accounts.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| per_page | integer | Results per page (max 100). |
| restaurant_id * | integer | Restaurant id (from gotable_list_restaurants). |
{
"name": "gotable_list_accounts",
"title": "List accounts of a restaurant",
"description": "List the staff accounts that have access to a restaurant (id, name, e-mail). The account id is the author_id that gotable_create_reservation_note needs. GoTable API: GET /api/v1/restaurants/{restaurant_id}/accounts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"restaurant_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number (default 1).",
"exclusiveMinimum": 0
},
"per_page": {
"type": "integer",
"maximum": 100,
"description": "Results per page (max 100).",
"exclusiveMinimum": 0
},
"restaurant_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restaurant id (from gotable_list_restaurants)."
}
}
},
"annotations": {
"title": "List accounts of a restaurant",
"readOnlyHint": true
}
}Get the real-time availability of a restaurant per date: closed flag and the time slots with the minimum and maximum party size. The range is capped at 3 months after `from`. GoTable API: GET /api/v1/restaurants/{restaurant_id}/availability.
| Parameter | Type | Description |
|---|---|---|
| from | string | Start date yyyy-mm-dd. |
| till | string | End date yyyy-mm-dd (max 3 months after from). |
| restaurant_id * | integer | Restaurant id (from gotable_list_restaurants). |
{
"name": "gotable_get_availability",
"title": "Get availability",
"description": "Get the real-time availability of a restaurant per date: closed flag and the time slots with the minimum and maximum party size. The range is capped at 3 months after `from`. GoTable API: GET /api/v1/restaurants/{restaurant_id}/availability.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"restaurant_id"
],
"properties": {
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start date yyyy-mm-dd."
},
"till": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End date yyyy-mm-dd (max 3 months after from)."
},
"restaurant_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restaurant id (from gotable_list_restaurants)."
}
}
},
"annotations": {
"title": "Get availability",
"readOnlyHint": true
}
}Get the availability per date of one offer (for example a tasting menu). GoTable API: GET /api/v1/restaurants/{restaurant_id}/offers/{offer_id}/availability.
| Parameter | Type | Description |
|---|---|---|
| from | string | Start date yyyy-mm-dd. |
| till | string | End date yyyy-mm-dd (max 3 months after from). |
| offer_id * | integer | Offer id (from gotable_list_offers). |
| restaurant_id * | integer | Restaurant id (from gotable_list_restaurants). |
{
"name": "gotable_get_offer_availability",
"title": "Get availability of an offer",
"description": "Get the availability per date of one offer (for example a tasting menu). GoTable API: GET /api/v1/restaurants/{restaurant_id}/offers/{offer_id}/availability.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"restaurant_id",
"offer_id"
],
"properties": {
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start date yyyy-mm-dd."
},
"till": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End date yyyy-mm-dd (max 3 months after from)."
},
"offer_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Offer id (from gotable_list_offers)."
},
"restaurant_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restaurant id (from gotable_list_restaurants)."
}
}
},
"annotations": {
"title": "Get availability of an offer",
"readOnlyHint": true
}
}List the offers of a restaurant (deposit per guest, visibility, booking window, translations). GoTable API: GET /api/v1/restaurants/{restaurant_id}/offers.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| per_page | integer | Results per page (max 100). |
| restaurant_id * | integer | Restaurant id (from gotable_list_restaurants). |
{
"name": "gotable_list_offers",
"title": "List offers",
"description": "List the offers of a restaurant (deposit per guest, visibility, booking window, translations). GoTable API: GET /api/v1/restaurants/{restaurant_id}/offers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"restaurant_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number (default 1).",
"exclusiveMinimum": 0
},
"per_page": {
"type": "integer",
"maximum": 100,
"description": "Results per page (max 100).",
"exclusiveMinimum": 0
},
"restaurant_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restaurant id (from gotable_list_restaurants)."
}
}
},
"annotations": {
"title": "List offers",
"readOnlyHint": true
}
}Get one offer by id. GoTable API: GET /api/v1/restaurants/{restaurant_id}/offers/{offer_id}.
| Parameter | Type | Description |
|---|---|---|
| offer_id * | integer | Offer id. |
| restaurant_id * | integer | Restaurant id (from gotable_list_restaurants). |
{
"name": "gotable_get_offer",
"title": "Get an offer",
"description": "Get one offer by id. GoTable API: GET /api/v1/restaurants/{restaurant_id}/offers/{offer_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"restaurant_id",
"offer_id"
],
"properties": {
"offer_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Offer id."
},
"restaurant_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restaurant id (from gotable_list_restaurants)."
}
}
},
"annotations": {
"title": "Get an offer",
"readOnlyHint": true
}
}Search the reservations of a restaurant. `query` mixes free text with filters: fields type, offer_id, date, time, starts_at, ends_at, state, party_size, guest_name, guest_email, guest_telephone, comments, duration_in_minutes; operators <= < >= > != = == : ~ !: !~. Example: "John date>=2026-10-19 state=confirmed party_size=2". States: pending, rejected, confirmed, checked_in, checked_out, cancelled, expired, reconfirmed, skipped and others. GoTable API: GET /api/v1/restaurants/{restaurant_id}/reservations.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| query | string | Free text and filters, see the tool description. |
| per_page | integer | Results per page (max 100). |
| restaurant_id * | integer | Restaurant id (from gotable_list_restaurants). |
{
"name": "gotable_list_reservations",
"title": "List reservations",
"description": "Search the reservations of a restaurant. `query` mixes free text with filters: fields type, offer_id, date, time, starts_at, ends_at, state, party_size, guest_name, guest_email, guest_telephone, comments, duration_in_minutes; operators <= < >= > != = == : ~ !: !~. Example: \"John date>=2026-10-19 state=confirmed party_size=2\". States: pending, rejected, confirmed, checked_in, checked_out, cancelled, expired, reconfirmed, skipped and others. GoTable API: GET /api/v1/restaurants/{restaurant_id}/reservations.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"restaurant_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number (default 1).",
"exclusiveMinimum": 0
},
"query": {
"type": "string",
"description": "Free text and filters, see the tool description."
},
"per_page": {
"type": "integer",
"maximum": 100,
"description": "Results per page (max 100).",
"exclusiveMinimum": 0
},
"restaurant_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restaurant id (from gotable_list_restaurants)."
}
}
},
"annotations": {
"title": "List reservations",
"readOnlyHint": true
}
}Get one reservation with state, guest data, tables, payment and notes. GoTable API: GET /api/v1/restaurants/{restaurant_id}/reservations/{reservation_id}.
| Parameter | Type | Description |
|---|---|---|
| restaurant_id * | integer | Restaurant id (from gotable_list_restaurants). |
| reservation_id * | integer | Reservation id. |
{
"name": "gotable_get_reservation",
"title": "Get a reservation",
"description": "Get one reservation with state, guest data, tables, payment and notes. GoTable API: GET /api/v1/restaurants/{restaurant_id}/reservations/{reservation_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"restaurant_id",
"reservation_id"
],
"properties": {
"restaurant_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restaurant id (from gotable_list_restaurants)."
},
"reservation_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Reservation id."
}
}
},
"annotations": {
"title": "Get a reservation",
"readOnlyHint": true
}
}List the internal notes of a reservation. GoTable API: GET /api/v1/restaurants/{restaurant_id}/reservations/{reservation_id}/notes.
| Parameter | Type | Description |
|---|---|---|
| restaurant_id * | integer | Restaurant id (from gotable_list_restaurants). |
| reservation_id * | integer | Reservation id. |
{
"name": "gotable_list_reservation_notes",
"title": "List notes of a reservation",
"description": "List the internal notes of a reservation. GoTable API: GET /api/v1/restaurants/{restaurant_id}/reservations/{reservation_id}/notes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"restaurant_id",
"reservation_id"
],
"properties": {
"restaurant_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restaurant id (from gotable_list_restaurants)."
},
"reservation_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Reservation id."
}
}
},
"annotations": {
"title": "List notes of a reservation",
"readOnlyHint": true
}
}Search the guests of a restaurant. `query` mixes free text with filters: fields name, email, telephone, last_visit, visits, reservations; operators <= < >= > != = == : ~ !: !~. Example: "visits>=5". GoTable API: GET /api/v1/restaurants/{restaurant_id}/guests.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| query | string | Free text and filters, see the tool description. |
| per_page | integer | Results per page (max 100). |
| restaurant_id * | integer | Restaurant id (from gotable_list_restaurants). |
{
"name": "gotable_list_guests",
"title": "List guests",
"description": "Search the guests of a restaurant. `query` mixes free text with filters: fields name, email, telephone, last_visit, visits, reservations; operators <= < >= > != = == : ~ !: !~. Example: \"visits>=5\". GoTable API: GET /api/v1/restaurants/{restaurant_id}/guests.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"restaurant_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number (default 1).",
"exclusiveMinimum": 0
},
"query": {
"type": "string",
"description": "Free text and filters, see the tool description."
},
"per_page": {
"type": "integer",
"maximum": 100,
"description": "Results per page (max 100).",
"exclusiveMinimum": 0
},
"restaurant_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restaurant id (from gotable_list_restaurants)."
}
}
},
"annotations": {
"title": "List guests",
"readOnlyHint": true
}
}Get one guest with visits, last visit, diets, allergies and tags. GoTable API: GET /api/v1/restaurants/{restaurant_id}/guests/{guest_id}.
| Parameter | Type | Description |
|---|---|---|
| guest_id * | integer | Guest id. |
| restaurant_id * | integer | Restaurant id (from gotable_list_restaurants). |
{
"name": "gotable_get_guest",
"title": "Get a guest",
"description": "Get one guest with visits, last visit, diets, allergies and tags. GoTable API: GET /api/v1/restaurants/{restaurant_id}/guests/{guest_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"restaurant_id",
"guest_id"
],
"properties": {
"guest_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Guest id."
},
"restaurant_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restaurant id (from gotable_list_restaurants)."
}
}
},
"annotations": {
"title": "Get a guest",
"readOnlyHint": true
}
}List the tables of a restaurant (label, section, minimum and maximum party size). GoTable API: GET /api/v1/restaurants/{restaurant_id}/tables.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| per_page | integer | Results per page (max 100). |
| restaurant_id * | integer | Restaurant id (from gotable_list_restaurants). |
{
"name": "gotable_list_tables",
"title": "List tables",
"description": "List the tables of a restaurant (label, section, minimum and maximum party size). GoTable API: GET /api/v1/restaurants/{restaurant_id}/tables.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"restaurant_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number (default 1).",
"exclusiveMinimum": 0
},
"per_page": {
"type": "integer",
"maximum": 100,
"description": "Results per page (max 100).",
"exclusiveMinimum": 0
},
"restaurant_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restaurant id (from gotable_list_restaurants)."
}
}
},
"annotations": {
"title": "List tables",
"readOnlyHint": true
}
}List the table combinations of a restaurant (groups of tables that seat one larger party). GoTable API: GET /api/v1/restaurants/{restaurant_id}/combinations.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| per_page | integer | Results per page (max 100). |
| restaurant_id * | integer | Restaurant id (from gotable_list_restaurants). |
{
"name": "gotable_list_combinations",
"title": "List table combinations",
"description": "List the table combinations of a restaurant (groups of tables that seat one larger party). GoTable API: GET /api/v1/restaurants/{restaurant_id}/combinations.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"restaurant_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number (default 1).",
"exclusiveMinimum": 0
},
"per_page": {
"type": "integer",
"maximum": 100,
"description": "Results per page (max 100).",
"exclusiveMinimum": 0
},
"restaurant_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restaurant id (from gotable_list_restaurants)."
}
}
},
"annotations": {
"title": "List table combinations",
"readOnlyHint": true
}
}List the guest reviews of a restaurant (rating, text, state). Needs the `reviews` feature in the GoTable plan; else the API returns an error. GoTable API: GET /api/v1/restaurants/{restaurant_id}/reviews.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| per_page | integer | Results per page (max 100). |
| restaurant_id * | integer | Restaurant id (from gotable_list_restaurants). |
{
"name": "gotable_list_reviews",
"title": "List reviews",
"description": "List the guest reviews of a restaurant (rating, text, state). Needs the `reviews` feature in the GoTable plan; else the API returns an error. GoTable API: GET /api/v1/restaurants/{restaurant_id}/reviews.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"restaurant_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number (default 1).",
"exclusiveMinimum": 0
},
"per_page": {
"type": "integer",
"maximum": 100,
"description": "Results per page (max 100).",
"exclusiveMinimum": 0
},
"restaurant_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restaurant id (from gotable_list_restaurants)."
}
}
},
"annotations": {
"title": "List reviews",
"readOnlyHint": true
}
}WRITE: create a reservation as the restaurant (skips most availability checks, so check gotable_get_availability first). Needs date and time, or type WalkIn for a guest at the door. By default GoTable e-mails and texts the guest: set skip_email / skip_sms to stop that. Not idempotent: a repeat call creates a second reservation. GoTable API: POST /api/v1/restaurants/{restaurant_id}/reservations.
| Parameter | Type | Description |
|---|---|---|
| date | string | Date yyyy-mm-dd (required unless type is WalkIn). |
| time | string | Time HH:MM (required unless type is WalkIn). |
| type | string | WalkIn = guest at the door; date and time default to now. |
| comments | string | Guest comments, e.g. a diet. |
| offer_id | integer | Offer to book (from gotable_list_offers). |
| skip_sms | boolean | true = do not send the text message to the guest. |
| table_ids | array | Tables to assign (from gotable_list_tables). |
| guest_name | string | |
| party_size * | integer | Number of guests. |
| skip_email | boolean | true = do not send the e-mail to the guest. |
| table_lock | boolean | true = pin the tables, no auto-assignment. |
| guest_email | string | |
| restaurant_id * | integer | Restaurant id (from gotable_list_restaurants). |
| guest_telephone | string | International format, e.g. +31612345678. |
| duration_in_minutes | integer |
{
"name": "gotable_create_reservation",
"title": "Create a reservation",
"description": "WRITE: create a reservation as the restaurant (skips most availability checks, so check gotable_get_availability first). Needs date and time, or type WalkIn for a guest at the door. By default GoTable e-mails and texts the guest: set skip_email / skip_sms to stop that. Not idempotent: a repeat call creates a second reservation. GoTable API: POST /api/v1/restaurants/{restaurant_id}/reservations.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"restaurant_id",
"party_size"
],
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date yyyy-mm-dd (required unless type is WalkIn)."
},
"time": {
"type": "string",
"pattern": "^\\d{2}:\\d{2}$",
"description": "Time HH:MM (required unless type is WalkIn)."
},
"type": {
"enum": [
"Reservation",
"WalkIn"
],
"type": "string",
"description": "WalkIn = guest at the door; date and time default to now."
},
"comments": {
"type": "string",
"description": "Guest comments, e.g. a diet."
},
"offer_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Offer to book (from gotable_list_offers)."
},
"skip_sms": {
"type": "boolean",
"description": "true = do not send the text message to the guest."
},
"table_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"description": "Tables to assign (from gotable_list_tables)."
},
"guest_name": {
"type": "string"
},
"party_size": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Number of guests.",
"exclusiveMinimum": 0
},
"skip_email": {
"type": "boolean",
"description": "true = do not send the e-mail to the guest."
},
"table_lock": {
"type": "boolean",
"description": "true = pin the tables, no auto-assignment."
},
"guest_email": {
"type": "string"
},
"restaurant_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restaurant id (from gotable_list_restaurants)."
},
"guest_telephone": {
"type": "string",
"description": "International format, e.g. +31612345678."
},
"duration_in_minutes": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Create a reservation",
"destructiveHint": true
}
}WRITE: change the details of a reservation (date, time, party size, guest data, comments, duration, tables). Send only the fields to change. GoTable API: PUT /api/v1/restaurants/{restaurant_id}/reservations/{reservation_id}.
| Parameter | Type | Description |
|---|---|---|
| date | string | |
| time | string | |
| comments | string | |
| table_ids | array | |
| guest_name | string | |
| party_size | integer | |
| table_lock | boolean | |
| guest_email | string | |
| restaurant_id * | integer | Restaurant id (from gotable_list_restaurants). |
| reservation_id * | integer | Reservation id. |
| guest_telephone | string | |
| duration_in_minutes | integer |
{
"name": "gotable_update_reservation",
"title": "Update a reservation",
"description": "WRITE: change the details of a reservation (date, time, party size, guest data, comments, duration, tables). Send only the fields to change. GoTable API: PUT /api/v1/restaurants/{restaurant_id}/reservations/{reservation_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"restaurant_id",
"reservation_id"
],
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"time": {
"type": "string",
"pattern": "^\\d{2}:\\d{2}$"
},
"comments": {
"type": "string"
},
"table_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
},
"guest_name": {
"type": "string"
},
"party_size": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"table_lock": {
"type": "boolean"
},
"guest_email": {
"type": "string"
},
"restaurant_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restaurant id (from gotable_list_restaurants)."
},
"reservation_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Reservation id."
},
"guest_telephone": {
"type": "string"
},
"duration_in_minutes": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Update a reservation",
"destructiveHint": true
}
}WRITE: cancel a reservation as the restaurant. By default GoTable e-mails and texts the guest: set skip_email / skip_sms to stop that. GoTable API: POST /api/v1/restaurants/{restaurant_id}/reservations/{reservation_id}/cancel.
| Parameter | Type | Description |
|---|---|---|
| skip_sms | boolean | true = do not send the text message to the guest. |
| skip_email | boolean | true = do not send the e-mail to the guest. |
| restaurant_id * | integer | Restaurant id (from gotable_list_restaurants). |
| reservation_id * | integer | Reservation id. |
{
"name": "gotable_cancel_reservation",
"title": "Cancel a reservation",
"description": "WRITE: cancel a reservation as the restaurant. By default GoTable e-mails and texts the guest: set skip_email / skip_sms to stop that. GoTable API: POST /api/v1/restaurants/{restaurant_id}/reservations/{reservation_id}/cancel.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"restaurant_id",
"reservation_id"
],
"properties": {
"skip_sms": {
"type": "boolean",
"description": "true = do not send the text message to the guest."
},
"skip_email": {
"type": "boolean",
"description": "true = do not send the e-mail to the guest."
},
"restaurant_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restaurant id (from gotable_list_restaurants)."
},
"reservation_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Reservation id."
}
}
},
"annotations": {
"title": "Cancel a reservation",
"destructiveHint": true
}
}WRITE: add an internal note to a reservation. author_id is a staff account id (from gotable_list_accounts). Not idempotent. GoTable API: POST /api/v1/restaurants/{restaurant_id}/reservations/{reservation_id}/notes.
| Parameter | Type | Description |
|---|---|---|
| content * | string | Note text. |
| author_id * | integer | Staff account id (from gotable_list_accounts). |
| restaurant_id * | integer | Restaurant id (from gotable_list_restaurants). |
| reservation_id * | integer | Reservation id. |
{
"name": "gotable_create_reservation_note",
"title": "Add a note to a reservation",
"description": "WRITE: add an internal note to a reservation. author_id is a staff account id (from gotable_list_accounts). Not idempotent. GoTable API: POST /api/v1/restaurants/{restaurant_id}/reservations/{reservation_id}/notes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"restaurant_id",
"reservation_id",
"content",
"author_id"
],
"properties": {
"content": {
"type": "string",
"minLength": 1,
"description": "Note text."
},
"author_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Staff account id (from gotable_list_accounts)."
},
"restaurant_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restaurant id (from gotable_list_restaurants)."
},
"reservation_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Reservation id."
}
}
},
"annotations": {
"title": "Add a note to a reservation",
"destructiveHint": true
}
}WRITE: add a guest to the guest book of a restaurant. Not idempotent. GoTable API: POST /api/v1/restaurants/{restaurant_id}/guests.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Guest name. |
| string | ||
| telephone | string | |
| subscribed | boolean | true = the guest accepts marketing e-mail. |
| restaurant_id * | integer | Restaurant id (from gotable_list_restaurants). |
{
"name": "gotable_create_guest",
"title": "Create a guest",
"description": "WRITE: add a guest to the guest book of a restaurant. Not idempotent. GoTable API: POST /api/v1/restaurants/{restaurant_id}/guests.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"restaurant_id",
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Guest name."
},
"email": {
"type": "string"
},
"telephone": {
"type": "string"
},
"subscribed": {
"type": "boolean",
"description": "true = the guest accepts marketing e-mail."
},
"restaurant_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restaurant id (from gotable_list_restaurants)."
}
}
},
"annotations": {
"title": "Create a guest",
"destructiveHint": true
}
}WRITE: change the name, e-mail, telephone or marketing consent of a guest. Send only the fields to change. GoTable API: PATCH /api/v1/restaurants/{restaurant_id}/guests/{guest_id}.
| Parameter | Type | Description |
|---|---|---|
| name | string | |
| string | ||
| guest_id * | integer | Guest id. |
| telephone | string | |
| subscribed | boolean | |
| restaurant_id * | integer | Restaurant id (from gotable_list_restaurants). |
{
"name": "gotable_update_guest",
"title": "Update a guest",
"description": "WRITE: change the name, e-mail, telephone or marketing consent of a guest. Send only the fields to change. GoTable API: PATCH /api/v1/restaurants/{restaurant_id}/guests/{guest_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"restaurant_id",
"guest_id"
],
"properties": {
"name": {
"type": "string"
},
"email": {
"type": "string"
},
"guest_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Guest id."
},
"telephone": {
"type": "string"
},
"subscribed": {
"type": "boolean"
},
"restaurant_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restaurant id (from gotable_list_restaurants)."
}
}
},
"annotations": {
"title": "Update a guest",
"readOnlyHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Tools for GoTable, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which tables are free for 4 guests this Saturday evening?"; "List all confirmed reservations for tomorrow with the guest comments and allergies."; "Which guests visited us 5 times or more but not in the last 3 months?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes GoTable data. Free plan: 50 tool calls per month. Run gotable_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run gotable_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run gotable_upgrade without a plan: it returns both plans, each with a payment link for the user to open. gotable_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.