Build a Norwegian restaurant's own ordering site on Okam. Call kit_learn first. No sign-in to build.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Add a configured product to the cart. Use product_configure first for required variant option ids.
Okam store id.
Product id from menu_list.
Optional line item notes.
Quantity to add.
Selected product option ids as GUID strings.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Add a configured product to the cart. Use product_configure first for required variant option ids.
| Argument | Type | Description |
|---|---|---|
| notes | string | Optional line item notes. |
| storeId* | integer | Okam store id. |
| quantity | integer | Quantity to add. |
| productId* | string | Product id from menu_list. |
| selectedOptionIds | array | Selected product option ids as GUID strings. |
{
"type": "object",
"required": [
"storeId",
"productId"
],
"properties": {
"notes": {
"type": "string",
"default": null,
"description": "Optional line item notes."
},
"storeId": {
"type": "integer",
"description": "Okam store id."
},
"quantity": {
"type": "integer",
"default": 1,
"description": "Quantity to add."
},
"productId": {
"type": "string",
"format": "uuid",
"description": "Product id from menu_list."
},
"selectedOptionIds": {
"type": "array",
"items": {
"type": "string"
},
"default": null,
"description": "Selected product option ids as GUID strings."
}
}
}Get the current cart for a store.
| Argument | Type | Description |
|---|---|---|
| storeId* | integer | Okam store id. |
{
"type": "object",
"required": [
"storeId"
],
"properties": {
"storeId": {
"type": "integer",
"description": "Okam store id."
}
}
}Remove a cart line item.
| Argument | Type | Description |
|---|---|---|
| storeId* | integer | Okam store id. |
| lineItemId* | string | Line item id from cart_get. |
{
"type": "object",
"required": [
"storeId",
"lineItemId"
],
"properties": {
"storeId": {
"type": "integer",
"description": "Okam store id."
},
"lineItemId": {
"type": "string",
"format": "uuid",
"description": "Line item id from cart_get."
}
}
}Set cart delivery type and delivery details. This must be called before listing product prices or adding products to cart.
| Argument | Type | Description |
|---|---|---|
| city | string | Required for home delivery. |
| comment | string | Optional order comment. |
| storeId* | integer | Okam store id. |
| zipCode | string | Required for home delivery. |
| tableName | string | Required for table delivery. |
| tipAmount | integer | null | Optional tip amount in ore. |
| useReward | boolean | null | Whether to use available reward balance. |
| tipPercent | integer | null | Optional tip percent, 0-100. |
| fullAddress | string | Required for home delivery. |
| deliveryType* | string | Selected delivery type. |
Update quantity, notes, or selected options on an existing cart line item. Quantity <= 0 removes the item.
| Argument | Type | Description |
|---|---|---|
| notes | string | Optional replacement notes. |
| storeId* | integer | Okam store id. |
| quantity* | integer | New quantity. Use 0 to remove. |
| lineItemId* | string | Line item id from cart_get. |
| selectedOptionIds | array | Optional replacement selected product option ids as GUID strings. |
{
"type": "object",
"required": [
"storeId",
"lineItemId",
"quantity"
],
"properties": {
"notes": {
"type": "string",
"default": null,
"description": "Optional replacement notes."
},
"storeId": {
"type": "integer",
"description": "Okam store id."
},
"quantity": {
"type": "integer",
"description": "New quantity. Use 0 to remove."
},
"lineItemId": {
"type": "string",
"format": "uuid",
"description": "Line item id from cart_get."
},
"selectedOptionIds": {
"type": "array",
"items": {
"type": "string"
},
"default": null,
"description": "Optional replacement selected product option ids as GUID strings."
}
}
}Validate the current cart before checkout.
| Argument | Type | Description |
|---|---|---|
| storeId* | integer | Okam store id. |
{
"type": "object",
"required": [
"storeId"
],
"properties": {
"storeId": {
"type": "integer",
"description": "Okam store id."
}
}
}Start checkout with Dintero or DinteroVipps. Returns a Dintero payment URL and reference; the guest approves the payment on Dintero's page. A zero-amount cart completes immediately. An unchanged cart gets the same payment link back.
| Argument | Type | Description |
|---|---|---|
| storeId* | integer | Okam store id. |
| paymentType* | string | Dintero or DinteroVipps. |
{
"type": "object",
"required": [
"storeId",
"paymentType"
],
"properties": {
"storeId": {
"type": "integer",
"description": "Okam store id."
},
"paymentType": {
"enum": [
"NotSet",
"Giftcard",
"PayInStore",
"Cash",
"CompanyAccount",
"Invoice",
"Stripe",
"Twint",
"Vipps",
"Dintero",
"DinteroVipps",
"DinteroBillie",
"DinteroKlarna",
"DinteroKravia",
"DinteroTerminal",
"WoltMarketplace",
"Foodora",
"Surfboard",
"SurfboardVipps",
"SurfboardTerminal"
],
"type": "string",
"description": "Dintero or DinteroVipps."
}
}
}Verify an external payment after the user has completed the returned payment URL. Provider is vipps or dintero.
| Argument | Type | Description |
|---|---|---|
| provider* | string | Payment provider: vipps or dintero. |
| paymentReference* | string | Vipps orderId or Dintero session/payment transaction id returned by checkout_start. |
{
"type": "object",
"required": [
"provider",
"paymentReference"
],
"properties": {
"provider": {
"type": "string",
"description": "Payment provider: vipps or dintero."
},
"paymentReference": {
"type": "string",
"description": "Vipps orderId or Dintero session/payment transaction id returned by checkout_start."
}
}
}Check whether Wolt delivery can deliver to an address and return the delivery price if available.
| Argument | Type | Description |
|---|---|---|
| city* | string | City. |
| storeId* | integer | Okam store id. |
| zipCode* | string | Postal code. |
| fullAddress* | string | Street address. |
{
"type": "object",
"required": [
"storeId",
"fullAddress",
"zipCode",
"city"
],
"properties": {
"city": {
"type": "string",
"description": "City."
},
"storeId": {
"type": "integer",
"description": "Okam store id."
},
"zipCode": {
"type": "string",
"description": "Postal code."
},
"fullAddress": {
"type": "string",
"description": "Street address."
}
}
}Public: with topic, that topic as Markdown; read assemble-a-shop, world-class-ordering-ux, verify-contract and the-return-page before building, the others when the steps name them. With block: where to read that reference block's source; read it, never install it. Without arguments: the topic and block lists. Read each topic once. Example: {"topic":"world-class-ordering-ux"}.
| Argument | Type | Description |
|---|---|---|
| block | string | Optional reference block name from kit_learn's blocks, for example menu. |
| topic | string | Optional topic slug from kit_learn's topics, for example assemble-a-shop or verify-contract. |
{
"type": "object",
"properties": {
"block": {
"type": "string",
"default": null,
"description": "Optional reference block name from kit_learn's blocks, for example menu."
},
"topic": {
"type": "string",
"default": null,
"description": "Optional topic slug from kit_learn's topics, for example assemble-a-shop or verify-contract."
}
}
}Public: call first whenever you build or change a restaurant's own ordering website on Okam. Returns the must-nots (the server owns every price, payment is the guest's own act), the build steps, the sandbox key, the topics and, with framework, the scaffold plan. The kit gives logic and outcomes, never a look: design the site from the restaurant's brief. Not for ordering food as a guest or for restaurant admin. Example: {"framework":"vite-react"}. Next: kit_docs_get for the topics the steps name.
| Argument | Type | Description |
|---|---|---|
| framework | string | Framework for the scaffold plan: next, astro, vite-react or html (read package.json). Pass it on the first call. |
| kitVersion | string | Optional kit version you were told to use; the current kit is always served. |
{
"type": "object",
"properties": {
"framework": {
"type": "string",
"default": null,
"description": "Framework for the scaffold plan: next, astro, vite-react or html (read package.json). Pass it on the first call."
},
"kitVersion": {
"type": "string",
"default": null,
"description": "Optional kit version you were told to use; the current kit is always served."
}
}
}List categories and products, with each product's allergens, for a store after delivery type has been selected. Delivery type affects product availability and prices. Results come in pages of whole categories; when nextPage is set, call again with that page for more.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number from nextPage; omit for the first page. |
| storeId* | integer | Okam store id. |
| deliveryType* | string | Selected delivery type. Use values from store_get/store_list. |
{
"type": "object",
"required": [
"storeId",
"deliveryType"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"description": "Page number from nextPage; omit for the first page."
},
"storeId": {
"type": "integer",
"description": "Okam store id."
},
"deliveryType": {
"enum": [
"NotSet",
"SelfPickup",
"InstantHomeDelivery",
"DineHomeDelivery",
"WoltDelivery",
"WoltMarketplaceDelivery",
"FoodoraDelivery",
"TableDelivery"
],
"type": "string",
"description": "Selected delivery type. Use values from store_get/store_list."
}
}
}List payment methods available for the current cart/user. Saved Stripe cards have ids; Dintero and Vipps are returned as payment types.
| Argument | Type | Description |
|---|---|---|
| storeId* | integer | Okam store id. |
{
"type": "object",
"required": [
"storeId"
],
"properties": {
"storeId": {
"type": "integer",
"description": "Okam store id."
}
}
}Get all variants, option ids and allergens for configuring a product before adding it to cart.
| Argument | Type | Description |
|---|---|---|
| productId* | string | Product id from menu_list. |
| deliveryType* | string | Selected delivery type. Delivery type affects product price. |
{
"type": "object",
"required": [
"productId",
"deliveryType"
],
"properties": {
"productId": {
"type": "string",
"format": "uuid",
"description": "Product id from menu_list."
},
"deliveryType": {
"enum": [
"NotSet",
"SelfPickup",
"InstantHomeDelivery",
"DineHomeDelivery",
"WoltDelivery",
"WoltMarketplaceDelivery",
"FoodoraDelivery",
"TableDelivery"
],
"type": "string",
"description": "Selected delivery type. Delivery type affects product price."
}
}
}Public: basic information about the Okam MCP server.
No arguments.
{
"type": "object",
"properties": {}
}Get store details, including supported delivery types. Choose a delivery type before listing menu prices.
| Argument | Type | Description |
|---|---|---|
| storeId* | integer | Okam store id. |
{
"type": "object",
"required": [
"storeId"
],
"properties": {
"storeId": {
"type": "integer",
"description": "Okam store id."
}
}
}List stores available to the current user. Optional longitude and latitude improve distance sorting.
| Argument | Type | Description |
|---|---|---|
| latitude | string | Optional latitude for distance sorting. |
| longitude | string | Optional longitude for distance sorting. |
{
"type": "object",
"properties": {
"latitude": {
"type": "string",
"default": null,
"description": "Optional latitude for distance sorting."
},
"longitude": {
"type": "string",
"default": null,
"description": "Optional longitude for distance sorting."
}
}
}Store key: call when the site is served from a process that keeps running (background, fixed port) and menu items show at that origin. Use http://localhost:<port>, not 127.0.0.1: the sandbox key allows only localhost. Returns whether the origin is allowed, a runId and the exact verify command; run it as returned while the site runs. Sign-in and every check after it WAIT until the sandbox guest exists: report them, never stub sign-in. If originAllowed is false, read kit_docs_get topic onboarding. Each call starts a new run; use the latest runId. Example: {"storefrontKey":"pk_test_…","origin":"http://localhost:5173"}.
| Argument | Type | Description |
|---|---|---|
| path | string | Optional path the site is served under, for example /sandbox/, when origin has none. |
| origin | string | The site's origin or full URL, for example http://localhost:4321 or https://test.okam.no/sandbox/. A path in it goes into the verify command's --url. |
| storefrontKey | string | The site's publishable storefront key (pk_test_… or pk_live_…). |
{
"type": "object",
"properties": {
"path": {
"type": "string",
"default": null,
"description": "Optional path the site is served under, for example /sandbox/, when origin has none."
},
"origin": {
"type": "string",
"default": null,
"description": "The site's origin or full URL, for example http://localhost:4321 or https://test.okam.no/sandbox/. A path in it goes into the verify command's --url."
},
"storefrontKey": {
"type": "string",
"default": null,
"description": "The site's publishable storefront key (pk_test_… or pk_live_…)."
}
}
}Store key: call after running the verify command, with the runId of that latest run. Pass or fail per check, and whether the server saw the run's sandbox order paid; when green, the go-live list. The CLI's PASS/WAIT/FAIL lines are authoritative: checks that only WAITed (sandbox guest sign-in) are missing here, so a run with no FAIL in the CLI has nothing to fix. While the store is closed the payment checks FAIL; rerun while it is open. If every check FAILed with locator.waitFor: Timeout, no menu item appeared: the server stopped or the origin differs from storefront_connect's; fix it and rerun. The record changes only when verify runs again.
| Argument | Type | Description |
|---|---|---|
| runId | string | The runId of the latest verify run, as storefront_connect returned and the CLI printed it. |
| storefrontKey | string | The site's publishable storefront key, the same one given to storefront_connect. |
{
"type": "object",
"properties": {
"runId": {
"type": "string",
"default": null,
"description": "The runId of the latest verify run, as storefront_connect returned and the CLI printed it."
},
"storefrontKey": {
"type": "string",
"default": null,
"description": "The site's publishable storefront key, the same one given to storefront_connect."
}
}
}| deliveryInstructions |
| string |
| Optional delivery instructions. |
{
"type": "object",
"required": [
"storeId",
"deliveryType"
],
"properties": {
"city": {
"type": "string",
"default": null,
"description": "Required for home delivery."
},
"comment": {
"type": "string",
"default": null,
"description": "Optional order comment."
},
"storeId": {
"type": "integer",
"description": "Okam store id."
},
"zipCode": {
"type": "string",
"default": null,
"description": "Required for home delivery."
},
"tableName": {
"type": "string",
"default": null,
"description": "Required for table delivery."
},
"tipAmount": {
"type": [
"integer",
"null"
],
"default": null,
"description": "Optional tip amount in ore."
},
"useReward": {
"type": [
"boolean",
"null"
],
"default": null,
"description": "Whether to use available reward balance."
},
"tipPercent": {
"type": [
"integer",
"null"
],
"default": null,
"description": "Optional tip percent, 0-100."
},
"fullAddress": {
"type": "string",
"default": null,
"description": "Required for home delivery."
},
"deliveryType": {
"enum": [
"NotSet",
"SelfPickup",
"InstantHomeDelivery",
"DineHomeDelivery",
"WoltDelivery",
"WoltMarketplaceDelivery",
"FoodoraDelivery",
"TableDelivery"
],
"type": "string",
"description": "Selected delivery type."
},
"deliveryInstructions": {
"type": "string",
"default": null,
"description": "Optional delivery instructions."
}
}
}