Okam MCP
An MCP server for coding agents to build restaurant ordering sites. It allows agents to learn framework rules, retrieve documentation, and verify storefronts without requiring sign-in, handling pricing, payments, and menu data from Okam's backend.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
no sign-in
MCP endpoint (Streamable HTTP)
https://api.okam.no/mcpWhat you can do with it
- Build restaurant ordering sites with AI agents
- Retrieve menu and pricing rules via kit_learn
- Verify storefront functionality via kit_docs_get
- Integrate with Claude Code, Cursor, and VS Code
Source and maintenance
Community listingRegistry 1.0.0
Protocol and capabilities
- Server
- okam 1.0.0.0
- MCP protocol
- 2025-06-18
- Tools
- 19 advertised
- Resources
- 17 advertised
- Resource templates
- 0 advertised
- Prompts
- Not advertised
Server-advertised capabilities
{
"tools": {},
"logging": {},
"resources": {}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
19 advertised
cart_update_item — Update cart line
Advertised destructive
Update quantity, notes, or selected options on an existing cart line item. Quantity <= 0 removes the item.
cart_update_item input schema
{
"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."
}
}
}cart_update_item output schema
{
"type": "object",
"properties": {
"cart": {
"type": [
"object",
"null"
],
"properties": {
"items": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"notes": {
"type": [
"string",
"null"
]
},
"product": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"soldOut": {
"type": "boolean"
},
"currency": {
"type": [
"string",
"null"
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"allergens": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
}
}
}
},
"basePrice": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"productId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"unitPrice": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"description": {
"type": [
"string",
"null"
]
},
"tablePriceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"configurationRequired": {
"type": "boolean"
},
"deliveryPriceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
}
}
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"quantity": {
"type": "integer"
},
"lineTotal": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"lineItemId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"selectedOptions": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"optionId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"priceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
}
}
}
}
}
}
},
"cartId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"totals": {
"type": [
"object",
"null"
],
"properties": {
"tipAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"finalAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"itemsAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"deliveryAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"discountAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"serviceFeeAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"woltServiceFeeAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
}
}
},
"storeId": {
"type": "integer"
},
"tableName": {
"type": [
"string",
"null"
]
},
"paymentType": {
"enum": [
"NotSet",
"Giftcard",
"PayInStore",
"Cash",
"CompanyAccount",
"Invoice",
"Stripe",
"Twint",
"Vipps",
"Dintero",
"DinteroVipps",
"DinteroBillie",
"DinteroKlarna",
"DinteroKravia",
"DinteroTerminal",
"WoltMarketplace",
"Foodora",
"Surfboard",
"SurfboardVipps",
"SurfboardTerminal"
],
"type": "string"
},
"deliveryType": {
"enum": [
"NotSet",
"SelfPickup",
"InstantHomeDelivery",
"DineHomeDelivery",
"WoltDelivery",
"WoltMarketplaceDelivery",
"FoodoraDelivery",
"TableDelivery"
],
"type": "string"
},
"deliveryAddress": {
"type": [
"object",
"null"
],
"properties": {
"city": {
"type": [
"string",
"null"
]
},
"zipCode": {
"type": [
"string",
"null"
]
},
"latitude": {
"type": [
"string",
"null"
]
},
"longitude": {
"type": [
"string",
"null"
]
},
"fullAddress": {
"type": [
"string",
"null"
]
},
"deliveryInstructions": {
"type": [
"string",
"null"
]
}
}
}
}
}
}
}cart_update_item annotations
{
"title": "Update cart line",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}store_list — List stores
Advertised read-only
List stores available to the current user. Optional longitude and latitude improve distance sorting.
store_list input schema
{
"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_list annotations
{
"title": "List stores",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}storefront_verify_result — Read a verify run: what passed, what to fix
Advertised read-only
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.
storefront_verify_result input schema
{
"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."
}
}
}storefront_verify_result annotations
{
"title": "Read a verify run: what passed, what to fix",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}storefront_connect — Connect a running site and get its verify command
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"}.
storefront_connect input schema
{
"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_…)."
}
}
}storefront_connect annotations
{
"title": "Connect a running site and get its verify command",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}menu_list — List menu
Advertised read-only
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.
menu_list input schema
{
"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."
}
}
}menu_list output schema
{
"type": "object",
"properties": {
"page": {
"type": "integer"
},
"storeId": {
"type": "integer"
},
"nextPage": {
"type": [
"integer",
"null"
]
},
"categories": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"items": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"heading": {
"type": [
"string",
"null"
]
},
"product": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"soldOut": {
"type": "boolean"
},
"currency": {
"type": [
"string",
"null"
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"allergens": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
}
}
}
},
"basePrice": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"productId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"unitPrice": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"description": {
"type": [
"string",
"null"
]
},
"tablePriceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"configurationRequired": {
"type": "boolean"
},
"deliveryPriceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
}
}
},
"isHeading": {
"type": "boolean"
},
"orderIndex": {
"type": "integer"
}
}
}
},
"soldOut": {
"type": "boolean"
},
"categoryId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"orderIndex": {
"type": "integer"
}
}
}
},
"deliveryType": {
"enum": [
"NotSet",
"SelfPickup",
"InstantHomeDelivery",
"DineHomeDelivery",
"WoltDelivery",
"WoltMarketplaceDelivery",
"FoodoraDelivery",
"TableDelivery"
],
"type": "string"
}
}
}menu_list annotations
{
"title": "List menu",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}cart_add_item — Add to cart
Add a configured product to the cart. Use product_configure first for required variant option ids.
cart_add_item input schema
{
"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."
}
}
}cart_add_item output schema
{
"type": "object",
"properties": {
"cart": {
"type": [
"object",
"null"
],
"properties": {
"items": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"notes": {
"type": [
"string",
"null"
]
},
"product": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"soldOut": {
"type": "boolean"
},
"currency": {
"type": [
"string",
"null"
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"allergens": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
}
}
}
},
"basePrice": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"productId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"unitPrice": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"description": {
"type": [
"string",
"null"
]
},
"tablePriceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"configurationRequired": {
"type": "boolean"
},
"deliveryPriceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
}
}
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"quantity": {
"type": "integer"
},
"lineTotal": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"lineItemId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"selectedOptions": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"optionId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"priceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
}
}
}
}
}
}
},
"cartId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"totals": {
"type": [
"object",
"null"
],
"properties": {
"tipAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"finalAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"itemsAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"deliveryAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"discountAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"serviceFeeAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"woltServiceFeeAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
}
}
},
"storeId": {
"type": "integer"
},
"tableName": {
"type": [
"string",
"null"
]
},
"paymentType": {
"enum": [
"NotSet",
"Giftcard",
"PayInStore",
"Cash",
"CompanyAccount",
"Invoice",
"Stripe",
"Twint",
"Vipps",
"Dintero",
"DinteroVipps",
"DinteroBillie",
"DinteroKlarna",
"DinteroKravia",
"DinteroTerminal",
"WoltMarketplace",
"Foodora",
"Surfboard",
"SurfboardVipps",
"SurfboardTerminal"
],
"type": "string"
},
"deliveryType": {
"enum": [
"NotSet",
"SelfPickup",
"InstantHomeDelivery",
"DineHomeDelivery",
"WoltDelivery",
"WoltMarketplaceDelivery",
"FoodoraDelivery",
"TableDelivery"
],
"type": "string"
},
"deliveryAddress": {
"type": [
"object",
"null"
],
"properties": {
"city": {
"type": [
"string",
"null"
]
},
"zipCode": {
"type": [
"string",
"null"
]
},
"latitude": {
"type": [
"string",
"null"
]
},
"longitude": {
"type": [
"string",
"null"
]
},
"fullAddress": {
"type": [
"string",
"null"
]
},
"deliveryInstructions": {
"type": [
"string",
"null"
]
}
}
}
}
}
}
}cart_add_item annotations
{
"title": "Add to cart",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}checkout_verify — Verify payment
Open-world
Verify an external payment after the user has completed the returned payment URL. Provider is vipps or dintero.
checkout_verify input schema
{
"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."
}
}
}checkout_verify output schema
{
"type": "object",
"properties": {
"order": {
"type": [
"object",
"null"
],
"properties": {
"status": {
"type": [
"string",
"null"
]
},
"orderId": {
"type": [
"string",
"null"
]
},
"storeId": {
"type": "integer"
},
"finalAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"paymentType": {
"enum": [
"NotSet",
"Giftcard",
"PayInStore",
"Cash",
"CompanyAccount",
"Invoice",
"Stripe",
"Twint",
"Vipps",
"Dintero",
"DinteroVipps",
"DinteroBillie",
"DinteroKlarna",
"DinteroKravia",
"DinteroTerminal",
"WoltMarketplace",
"Foodora",
"Surfboard",
"SurfboardVipps",
"SurfboardTerminal"
],
"type": "string"
},
"deliveryType": {
"enum": [
"NotSet",
"SelfPickup",
"InstantHomeDelivery",
"DineHomeDelivery",
"WoltDelivery",
"WoltMarketplaceDelivery",
"FoodoraDelivery",
"TableDelivery"
],
"type": "string"
},
"friendlyOrderId": {
"type": [
"string",
"null"
]
}
}
},
"status": {
"type": [
"string",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"provider": {
"type": [
"string",
"null"
]
},
"paymentReference": {
"type": [
"string",
"null"
]
}
}
}checkout_verify annotations
{
"title": "Verify payment",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}kit_docs_get — Read one Storefront Kit topic or reference block
Advertised read-only
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"}.
kit_docs_get input schema
{
"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."
}
}
}kit_docs_get annotations
{
"title": "Read one Storefront Kit topic or reference block",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}server_info — Server info
Advertised read-only
Public: basic information about the Okam MCP server.
server_info input schema
{
"type": "object",
"properties": {}
}server_info annotations
{
"title": "Server info",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}kit_learn — Start here: learn the Okam Storefront Kit
Advertised read-only
Public: call first whenever you build or change a restaurant's own ordering website or table booking 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.
kit_learn input schema
{
"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."
}
}
}kit_learn annotations
{
"title": "Start here: learn the Okam Storefront Kit",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}payment_methods_list — List payment methods
Advertised read-only
List payment methods available for the current cart/user. Saved Stripe cards have ids; Dintero and Vipps are returned as payment types.
payment_methods_list input schema
{
"type": "object",
"required": [
"storeId"
],
"properties": {
"storeId": {
"type": "integer",
"description": "Okam store id."
}
}
}payment_methods_list annotations
{
"title": "List payment methods",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}cart_validate — Validate cart
Advertised read-only
Validate the current cart before checkout.
cart_validate input schema
{
"type": "object",
"required": [
"storeId"
],
"properties": {
"storeId": {
"type": "integer",
"description": "Okam store id."
}
}
}cart_validate output schema
{
"type": "object",
"properties": {
"storeId": {
"type": [
"integer",
"null"
]
},
"hasErrors": {
"type": "boolean"
},
"cartIsEmpty": {
"type": "boolean"
},
"minimumPrice": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"storeIsClosed": {
"type": "boolean"
},
"itemsOutOfStock": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"soldOut": {
"type": "boolean"
},
"currency": {
"type": [
"string",
"null"
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"allergens": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
}
}
}
},
"basePrice": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"productId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"unitPrice": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"description": {
"type": [
"string",
"null"
]
},
"tablePriceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"configurationRequired": {
"type": "boolean"
},
"deliveryPriceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
}
}
}
},
"paymentTypeError": {
"type": "boolean"
},
"priceDifferError": {
"type": "boolean"
},
"priceTooLowError": {
"type": "boolean"
},
"deliveryMethodError": {
"type": "boolean"
},
"deliveryAddressError": {
"type": "boolean"
},
"giftcardBalanceTooLow": {
"type": "boolean"
},
"sameDayAfterHoursOrderNotAllowed": {
"type": "boolean"
}
}
}cart_validate annotations
{
"title": "Validate cart",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}store_get — Get store
Advertised read-only
Get store details, including supported delivery types. Choose a delivery type before listing menu prices.
store_get input schema
{
"type": "object",
"required": [
"storeId"
],
"properties": {
"storeId": {
"type": "integer",
"description": "Okam store id."
}
}
}store_get output schema
{
"type": "object",
"properties": {
"store": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
},
"address": {
"type": [
"object",
"null"
],
"properties": {
"city": {
"type": [
"string",
"null"
]
},
"zipCode": {
"type": [
"string",
"null"
]
},
"latitude": {
"type": [
"string",
"null"
]
},
"longitude": {
"type": [
"string",
"null"
]
},
"fullAddress": {
"type": [
"string",
"null"
]
},
"deliveryInstructions": {
"type": [
"string",
"null"
]
}
}
},
"storeId": {
"type": "integer"
},
"approved": {
"type": "boolean"
},
"isOpenNow": {
"type": "boolean"
},
"openingHours": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"open": {
"type": "boolean"
},
"dayOfWeek": {
"type": "integer"
},
"closingTime": {
"type": [
"string",
"null"
]
},
"openingTime": {
"type": [
"string",
"null"
]
}
}
}
},
"deliveryTypes": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"value": {
"type": "integer"
},
"available": {
"type": "boolean"
},
"deliveryType": {
"enum": [
"NotSet",
"SelfPickup",
"InstantHomeDelivery",
"DineHomeDelivery",
"WoltDelivery",
"WoltMarketplaceDelivery",
"FoodoraDelivery",
"TableDelivery"
],
"type": "string"
}
}
}
},
"statusMessage": {
"type": [
"string",
"null"
]
},
"warningMessage": {
"type": [
"string",
"null"
]
}
}
}
}
}store_get annotations
{
"title": "Get store",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}cart_get — Get cart
Advertised read-only
Get the current cart for a store.
cart_get input schema
{
"type": "object",
"required": [
"storeId"
],
"properties": {
"storeId": {
"type": "integer",
"description": "Okam store id."
}
}
}cart_get output schema
{
"type": "object",
"properties": {
"cart": {
"type": [
"object",
"null"
],
"properties": {
"items": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"notes": {
"type": [
"string",
"null"
]
},
"product": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"soldOut": {
"type": "boolean"
},
"currency": {
"type": [
"string",
"null"
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"allergens": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
}
}
}
},
"basePrice": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"productId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"unitPrice": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"description": {
"type": [
"string",
"null"
]
},
"tablePriceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"configurationRequired": {
"type": "boolean"
},
"deliveryPriceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
}
}
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"quantity": {
"type": "integer"
},
"lineTotal": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"lineItemId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"selectedOptions": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"optionId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"priceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
}
}
}
}
}
}
},
"cartId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"totals": {
"type": [
"object",
"null"
],
"properties": {
"tipAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"finalAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"itemsAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"deliveryAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"discountAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"serviceFeeAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"woltServiceFeeAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
}
}
},
"storeId": {
"type": "integer"
},
"tableName": {
"type": [
"string",
"null"
]
},
"paymentType": {
"enum": [
"NotSet",
"Giftcard",
"PayInStore",
"Cash",
"CompanyAccount",
"Invoice",
"Stripe",
"Twint",
"Vipps",
"Dintero",
"DinteroVipps",
"DinteroBillie",
"DinteroKlarna",
"DinteroKravia",
"DinteroTerminal",
"WoltMarketplace",
"Foodora",
"Surfboard",
"SurfboardVipps",
"SurfboardTerminal"
],
"type": "string"
},
"deliveryType": {
"enum": [
"NotSet",
"SelfPickup",
"InstantHomeDelivery",
"DineHomeDelivery",
"WoltDelivery",
"WoltMarketplaceDelivery",
"FoodoraDelivery",
"TableDelivery"
],
"type": "string"
},
"deliveryAddress": {
"type": [
"object",
"null"
],
"properties": {
"city": {
"type": [
"string",
"null"
]
},
"zipCode": {
"type": [
"string",
"null"
]
},
"latitude": {
"type": [
"string",
"null"
]
},
"longitude": {
"type": [
"string",
"null"
]
},
"fullAddress": {
"type": [
"string",
"null"
]
},
"deliveryInstructions": {
"type": [
"string",
"null"
]
}
}
}
}
}
}
}cart_get annotations
{
"title": "Get cart",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}cart_set_delivery — Set delivery
Set cart delivery type and delivery details. This must be called before listing product prices or adding products to cart.
cart_set_delivery input schema
{
"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."
}
}
}cart_set_delivery output schema
{
"type": "object",
"properties": {
"cart": {
"type": [
"object",
"null"
],
"properties": {
"items": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"notes": {
"type": [
"string",
"null"
]
},
"product": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"soldOut": {
"type": "boolean"
},
"currency": {
"type": [
"string",
"null"
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"allergens": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
}
}
}
},
"basePrice": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"productId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"unitPrice": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"description": {
"type": [
"string",
"null"
]
},
"tablePriceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"configurationRequired": {
"type": "boolean"
},
"deliveryPriceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
}
}
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"quantity": {
"type": "integer"
},
"lineTotal": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"lineItemId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"selectedOptions": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"optionId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"priceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
}
}
}
}
}
}
},
"cartId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"totals": {
"type": [
"object",
"null"
],
"properties": {
"tipAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"finalAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"itemsAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"deliveryAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"discountAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"serviceFeeAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"woltServiceFeeAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
}
}
},
"storeId": {
"type": "integer"
},
"tableName": {
"type": [
"string",
"null"
]
},
"paymentType": {
"enum": [
"NotSet",
"Giftcard",
"PayInStore",
"Cash",
"CompanyAccount",
"Invoice",
"Stripe",
"Twint",
"Vipps",
"Dintero",
"DinteroVipps",
"DinteroBillie",
"DinteroKlarna",
"DinteroKravia",
"DinteroTerminal",
"WoltMarketplace",
"Foodora",
"Surfboard",
"SurfboardVipps",
"SurfboardTerminal"
],
"type": "string"
},
"deliveryType": {
"enum": [
"NotSet",
"SelfPickup",
"InstantHomeDelivery",
"DineHomeDelivery",
"WoltDelivery",
"WoltMarketplaceDelivery",
"FoodoraDelivery",
"TableDelivery"
],
"type": "string"
},
"deliveryAddress": {
"type": [
"object",
"null"
],
"properties": {
"city": {
"type": [
"string",
"null"
]
},
"zipCode": {
"type": [
"string",
"null"
]
},
"latitude": {
"type": [
"string",
"null"
]
},
"longitude": {
"type": [
"string",
"null"
]
},
"fullAddress": {
"type": [
"string",
"null"
]
},
"deliveryInstructions": {
"type": [
"string",
"null"
]
}
}
}
}
}
}
}cart_set_delivery annotations
{
"title": "Set delivery",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}delivery_availability_check — Check delivery address
Advertised read-only
Check whether Wolt delivery can deliver to an address and return the delivery price if available.
delivery_availability_check input schema
{
"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."
}
}
}delivery_availability_check output schema
{
"type": "object",
"properties": {
"error": {
"type": [
"string",
"null"
]
},
"price": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"canDeliver": {
"type": "boolean"
}
}
}delivery_availability_check annotations
{
"title": "Check delivery address",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}product_configure — Configure product
Advertised read-only
Get all variants, option ids and allergens for configuring a product before adding it to cart.
product_configure input schema
{
"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."
}
}
}product_configure output schema
{
"type": "object",
"properties": {
"product": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"soldOut": {
"type": "boolean"
},
"currency": {
"type": [
"string",
"null"
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"variants": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"options": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"optionId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"selected": {
"type": "boolean"
},
"orderIndex": {
"type": "integer"
},
"priceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
}
}
}
},
"required": {
"type": "boolean"
},
"variantId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"orderIndex": {
"type": "integer"
},
"multiselect": {
"type": "boolean"
}
}
}
},
"allergens": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
}
}
}
},
"basePrice": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"productId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"unitPrice": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"description": {
"type": [
"string",
"null"
]
},
"tablePriceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"configurationRequired": {
"type": "boolean"
},
"deliveryPriceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
}
}
},
"storeId": {
"type": [
"integer",
"null"
]
},
"deliveryType": {
"enum": [
"NotSet",
"SelfPickup",
"InstantHomeDelivery",
"DineHomeDelivery",
"WoltDelivery",
"WoltMarketplaceDelivery",
"FoodoraDelivery",
"TableDelivery"
],
"type": "string"
}
}
}product_configure annotations
{
"title": "Configure product",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}checkout_start — Start checkout
Advertised destructiveOpen-world
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.
checkout_start input schema
{
"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."
}
}
}checkout_start output schema
{
"type": "object",
"properties": {
"cart": {
"type": [
"object",
"null"
],
"properties": {
"items": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"notes": {
"type": [
"string",
"null"
]
},
"product": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"soldOut": {
"type": "boolean"
},
"currency": {
"type": [
"string",
"null"
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"allergens": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
}
}
}
},
"basePrice": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"productId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"unitPrice": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"description": {
"type": [
"string",
"null"
]
},
"tablePriceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"configurationRequired": {
"type": "boolean"
},
"deliveryPriceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
}
}
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"quantity": {
"type": "integer"
},
"lineTotal": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"lineItemId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"selectedOptions": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"optionId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"priceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
}
}
}
}
}
}
},
"cartId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"totals": {
"type": [
"object",
"null"
],
"properties": {
"tipAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"finalAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"itemsAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"deliveryAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"discountAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"serviceFeeAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"woltServiceFeeAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
}
}
},
"storeId": {
"type": "integer"
},
"tableName": {
"type": [
"string",
"null"
]
},
"paymentType": {
"enum": [
"NotSet",
"Giftcard",
"PayInStore",
"Cash",
"CompanyAccount",
"Invoice",
"Stripe",
"Twint",
"Vipps",
"Dintero",
"DinteroVipps",
"DinteroBillie",
"DinteroKlarna",
"DinteroKravia",
"DinteroTerminal",
"WoltMarketplace",
"Foodora",
"Surfboard",
"SurfboardVipps",
"SurfboardTerminal"
],
"type": "string"
},
"deliveryType": {
"enum": [
"NotSet",
"SelfPickup",
"InstantHomeDelivery",
"DineHomeDelivery",
"WoltDelivery",
"WoltMarketplaceDelivery",
"FoodoraDelivery",
"TableDelivery"
],
"type": "string"
},
"deliveryAddress": {
"type": [
"object",
"null"
],
"properties": {
"city": {
"type": [
"string",
"null"
]
},
"zipCode": {
"type": [
"string",
"null"
]
},
"latitude": {
"type": [
"string",
"null"
]
},
"longitude": {
"type": [
"string",
"null"
]
},
"fullAddress": {
"type": [
"string",
"null"
]
},
"deliveryInstructions": {
"type": [
"string",
"null"
]
}
}
}
}
},
"order": {
"type": [
"object",
"null"
],
"properties": {
"status": {
"type": [
"string",
"null"
]
},
"orderId": {
"type": [
"string",
"null"
]
},
"storeId": {
"type": "integer"
},
"finalAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"paymentType": {
"enum": [
"NotSet",
"Giftcard",
"PayInStore",
"Cash",
"CompanyAccount",
"Invoice",
"Stripe",
"Twint",
"Vipps",
"Dintero",
"DinteroVipps",
"DinteroBillie",
"DinteroKlarna",
"DinteroKravia",
"DinteroTerminal",
"WoltMarketplace",
"Foodora",
"Surfboard",
"SurfboardVipps",
"SurfboardTerminal"
],
"type": "string"
},
"deliveryType": {
"enum": [
"NotSet",
"SelfPickup",
"InstantHomeDelivery",
"DineHomeDelivery",
"WoltDelivery",
"WoltMarketplaceDelivery",
"FoodoraDelivery",
"TableDelivery"
],
"type": "string"
},
"friendlyOrderId": {
"type": [
"string",
"null"
]
}
}
},
"status": {
"type": [
"string",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"provider": {
"type": [
"string",
"null"
]
},
"paymentUrl": {
"type": [
"string",
"null"
]
},
"validation": {
"type": [
"object",
"null"
],
"properties": {
"storeId": {
"type": [
"integer",
"null"
]
},
"hasErrors": {
"type": "boolean"
},
"cartIsEmpty": {
"type": "boolean"
},
"minimumPrice": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"storeIsClosed": {
"type": "boolean"
},
"itemsOutOfStock": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"soldOut": {
"type": "boolean"
},
"currency": {
"type": [
"string",
"null"
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"allergens": {
"$ref": "#/properties/cart/properties/items/items/properties/product/properties/allergens",
"items": {}
},
"basePrice": {
"$ref": "#/properties/cart/properties/items/items/properties/product/properties/basePrice"
},
"productId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"unitPrice": {
"$ref": "#/properties/cart/properties/items/items/properties/product/properties/unitPrice"
},
"description": {
"type": [
"string",
"null"
]
},
"tablePriceAdjustment": {
"$ref": "#/properties/cart/properties/items/items/properties/product/properties/tablePriceAdjustment"
},
"configurationRequired": {
"type": "boolean"
},
"deliveryPriceAdjustment": {
"$ref": "#/properties/cart/properties/items/items/properties/product/properties/deliveryPriceAdjustment"
}
}
}
},
"paymentTypeError": {
"type": "boolean"
},
"priceDifferError": {
"type": "boolean"
},
"priceTooLowError": {
"type": "boolean"
},
"deliveryMethodError": {
"type": "boolean"
},
"deliveryAddressError": {
"type": "boolean"
},
"giftcardBalanceTooLow": {
"type": "boolean"
},
"sameDayAfterHoursOrderNotAllowed": {
"type": "boolean"
}
}
},
"paymentType": {
"enum": [
"NotSet",
"Giftcard",
"PayInStore",
"Cash",
"CompanyAccount",
"Invoice",
"Stripe",
"Twint",
"Vipps",
"Dintero",
"DinteroVipps",
"DinteroBillie",
"DinteroKlarna",
"DinteroKravia",
"DinteroTerminal",
"WoltMarketplace",
"Foodora",
"Surfboard",
"SurfboardVipps",
"SurfboardTerminal"
],
"type": "string"
},
"clientSecret": {
"type": [
"string",
"null"
]
},
"paymentReference": {
"type": [
"string",
"null"
]
}
}
}checkout_start annotations
{
"title": "Start checkout",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}cart_remove_item — Remove cart line
Advertised destructive
Remove a cart line item.
cart_remove_item input schema
{
"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."
}
}
}cart_remove_item output schema
{
"type": "object",
"properties": {
"cart": {
"type": [
"object",
"null"
],
"properties": {
"items": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"notes": {
"type": [
"string",
"null"
]
},
"product": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"soldOut": {
"type": "boolean"
},
"currency": {
"type": [
"string",
"null"
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"allergens": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
}
}
}
},
"basePrice": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"productId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"unitPrice": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"description": {
"type": [
"string",
"null"
]
},
"tablePriceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"configurationRequired": {
"type": "boolean"
},
"deliveryPriceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
}
}
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"quantity": {
"type": "integer"
},
"lineTotal": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"lineItemId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"selectedOptions": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"optionId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"priceAdjustment": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
}
}
}
}
}
}
},
"cartId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"totals": {
"type": [
"object",
"null"
],
"properties": {
"tipAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"finalAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"itemsAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"deliveryAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"discountAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"serviceFeeAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
},
"woltServiceFeeAmount": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "integer"
},
"currency": {
"type": [
"string",
"null"
]
},
"formatted": {
"type": [
"string",
"null"
]
}
}
}
}
},
"storeId": {
"type": "integer"
},
"tableName": {
"type": [
"string",
"null"
]
},
"paymentType": {
"enum": [
"NotSet",
"Giftcard",
"PayInStore",
"Cash",
"CompanyAccount",
"Invoice",
"Stripe",
"Twint",
"Vipps",
"Dintero",
"DinteroVipps",
"DinteroBillie",
"DinteroKlarna",
"DinteroKravia",
"DinteroTerminal",
"WoltMarketplace",
"Foodora",
"Surfboard",
"SurfboardVipps",
"SurfboardTerminal"
],
"type": "string"
},
"deliveryType": {
"enum": [
"NotSet",
"SelfPickup",
"InstantHomeDelivery",
"DineHomeDelivery",
"WoltDelivery",
"WoltMarketplaceDelivery",
"FoodoraDelivery",
"TableDelivery"
],
"type": "string"
},
"deliveryAddress": {
"type": [
"object",
"null"
],
"properties": {
"city": {
"type": [
"string",
"null"
]
},
"zipCode": {
"type": [
"string",
"null"
]
},
"latitude": {
"type": [
"string",
"null"
]
},
"longitude": {
"type": [
"string",
"null"
]
},
"fullAddress": {
"type": [
"string",
"null"
]
},
"deliveryInstructions": {
"type": [
"string",
"null"
]
}
}
}
}
}
}
}cart_remove_item annotations
{
"title": "Remove cart line",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}Prompts
Not advertised
Resources
17 advertised
okam_menu_admin_view — Okam menu
The store's menu as an outline (categories, dishes, prices, channels, hidden and sold-out), search hits, add-ons, and a menu proposal's before and after.
okam_menu_admin_view URI
ui://okam/menu-admin.v1okam_menu_view — Okam menu
The store's menu for the chosen delivery type, with images, prices, allergens and add buttons.
okam_menu_view URI
ui://okam/menu.v1okam_configure_view — Okam product choices
A product's required choices and extras, with a button that adds it to the cart.
okam_configure_view URI
ui://okam/configure.v1okam_vaktplan_view — Okam vaktplan
The staff plan of a week as a grid (people × days), who is clocked in, open requests and hours, and shift proposals before → after.
okam_vaktplan_view URI
ui://okam/vaktplan.v1okam_cart_view — Okam cart
The guest's cart with a Pay button and the order status.
okam_cart_view URI
ui://okam/cart.v2okam_onboarding_view — Okam store setup
The setup checklist of each store the user administers, with a link to the right Backoffice page per step.
okam_onboarding_view URI
ui://okam/onboarding.v1okam_mix_view — Okam channel and guest mix
How orders split by delivery type and provider, and how many guests come back, for the stores the user administers.
okam_mix_view URI
ui://okam/mix.v1okam_proposal_view — Okam proposal
A change proposal for the store owner: what changes before → after, its status and a link to approve it in Backoffice.
okam_proposal_view URI
ui://okam/proposal.v1okam_cart_view_v1 — Okam cart
The guest's cart with a Pay button and the order status (earlier address of ui://okam/cart.v2).
okam_cart_view_v1 URI
ui://okam/cart.v1okam_peak_view — Okam peak hours
When the stores the user administers are busy: orders and revenue per weekday and hour.
okam_peak_view URI
ui://okam/peak.v1okam_orders_view — Okam orders
Open orders as a board, the order list, one order's detail and today's figures. Read only.
okam_orders_view URI
ui://okam/orders.v1okam_money_view — Okam payouts and VAT
Payouts, VAT bases, gift card liability and the payment mix as tables you can copy.
okam_money_view URI
ui://okam/money.v1okam_labour_view — Okam lønn mot omsetning
Wage cost against sales and the labour % per store or day, the timesheet with punches, and pay proposals before → after.
okam_labour_view URI
ui://okam/labour.v1okam_ranking_view — Okam ranking
What sells best and least in the stores the user administers: dishes or categories ranked by units or revenue.
okam_ranking_view URI
ui://okam/ranking.v1okam_hours_view — Okam opening hours
The store's opening hours: the week, the exception days in a month calendar and the status message.
okam_hours_view URI
ui://okam/hours.v1okam_sales_view — Okam sales
Sales for the stores the user administers: revenue, orders and average order against the previous period, day by day.
okam_sales_view URI
ui://okam/sales.v1okam_zones_view — Okam delivery zones
Delivery fee rings by distance, the minimum order and the delivery channels.
okam_zones_view URI
ui://okam/zones.v130-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 2641 ms
- 95th percentile latency
- 2641 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 2641 ms · metadata changed · 19 tool(s), 17 resource(s), 0 resource template(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http okam-mcp https://api.okam.no/mcpCodex
Codex configuration
codex mcp add okam-mcp --url https://api.okam.no/mcpCursor
Cursor configuration
{
"mcpServers": {
"okam-mcp": {
"url": "https://api.okam.no/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"okam-mcp": {
"type": "streamableHttp",
"url": "https://api.okam.no/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"okam-mcp": {
"type": "http",
"url": "https://api.okam.no/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http okam-mcp https://api.okam.no/mcpClaude Desktop
Claude Desktop configuration
{
"mcpServers": {
"okam-mcp": {
"url": "https://api.okam.no/mcp"
}
}
}Windsurf
Windsurf configuration
{
"mcpServers": {
"okam-mcp": {
"serverUrl": "https://api.okam.no/mcp"
}
}
}Let your agent find its tools
Find servers like Okam MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.