MCP Server

GYOTAK Fish Market

com.thaifishsashimicatalog/fish-market
Commerce & Retail Crypto & Web3 Public & reachable MCP 2026-07-28

What this MCP does

Provides a Thailand-only sashimi fish catalog and ordering workflow with Cardano payments, referral features, and blockchain-based catch, authenticity, and temperature verification.

apply_referrer
Look up your GYOTAK referral MCP URL. The URL is issued automatically when the payment for your first chat order is confirmed and is included in the payment confirmation email; call this to see it again. If you have a paid order but no URL yet, one is issued now. Referrers earn 5% of the product subtotal on paid orders placed through their URL. If you are connected through a personal token URL, omit customerKey.
Input schema
{'type': 'object', 'required': [], 'properties': {'name': {'type': 'string', 'description': 'Referrer display name — optional, defaults to your registered name'}, 'contact': {'type': 'string', 'description': 'Contact (email, LINE ID, etc.) — optional'}, 'customerKey': {'type': 'string', 'description': 'Your customerKey (gyotak_cus_...). Omit when connected through a personal token URL.'}}}
ask_gyotak
Search GYOTAK FAQ for answers about shipping, payment, products, defrosting, traceability, B2B registration, etc. Returns top matching FAQ entries. If no match, suggest using contact_gyotak to escalate.
Input schema
{'type': 'object', 'required': ['question'], 'properties': {'question': {'type': 'string', 'description': 'Question text (any language)'}}}
check_payment_status
Test / QA only — do not use for customer orders. Returns the Cardano preprod payment session of an order placed by a GYOTAK test customer (status, amount, deadline, TX hash if paid). For any other order_id it returns PromptPay guidance and nothing about the order. Customers pay via the PromptPay QR attached to the order confirmation email and receive an email once the payment is confirmed.
Input schema
{'type': 'object', 'required': ['order_id'], 'properties': {'order_id': {'type': 'string', 'description': 'Order ID (e.g. "BB-42")'}}}
check_reply
Check if GYOTAK staff has replied to a previously submitted inquiry.
Input schema
{'type': 'object', 'required': ['inquiryId'], 'properties': {'inquiryId': {'type': 'string', 'description': 'Inquiry ID (e.g. "INQ-042")'}}}
claim_purchase_proof
Claim the on-chain purchase proofs for your own purchases and attach your X (Twitter) handle to them, so a post of yours can be checked against the chain. Each stamped purchase comes with the URL of its public verification page. Only works through a personal token URL connector — there is no customerKey argument. Called with no arguments it only lists the purchases that can be claimed and claims nothing, every time — pass handle to actually claim. A claim is stamped on chain and cannot be undone, so let the user pick the handle before you pass one. The handle is what you tell us: GYOTAK does not verify that you own the account. Automatic binding of future purchases is off by default: to turn it on, pass handle with auto_bind "on" — the first such call returns the consent text; show it to the user word for word (the text is in Japanese and English; show both), and only if they agree call again with consent true. Pass auto_bind "off" to stop it (no handle needed); only later purchases stop, anything already recorded stays.
Input schema
{'type': 'object', 'required': [], 'properties': {'handle': {'type': 'string', 'description': 'Your X handle without the leading @ (letters, digits and underscore, 1-15 characters). Required to claim: a call without it only lists your purchases and claims nothing, even if you claimed before. Pass it on every claim.'}, 'consent': {'type': 'boolean', 'description': 'Set true only when the user has read the consent text returned by an earlier auto_bind "on" call and agreed to it. Never set it on your own.'}, 'auto_bind': {'enum': ['on', 'off'], 'type': 'string', 'description': 'Turn automatic binding of future purchases to your X handle on or off. "on" needs handle and consent. "off" needs nothing else. Omit to leave the setting as it is.'}, 'purchase_id': {'type': 'string', 'description': 'Claim only this purchase (e.g. "PB-20260917-a97953d3"). Omit to claim every purchase of yours that is not claimed yet.'}}}
confirm_payment
Test / QA only — do not use for customer orders: customers pay via the PromptPay QR attached to the order confirmation email. Executes the Cardano preprod A→B→A settlement for an order placed by a GYOTAK test customer. Requires that test customer's customerKey, a pending payment session from create_payment, and a monthly auto-settle allowance. For any other order_id it returns PromptPay guidance and changes nothing.
Input schema
{'type': 'object', 'required': ['order_id', 'customer_key'], 'properties': {'order_id': {'type': 'string', 'description': 'Order ID (e.g. "BB-123")'}, 'customer_key': {'type': 'string', 'description': 'customerKey of the test customer that placed the order'}}}
contact_gyotak
Submit a question to GYOTAK staff when FAQ does not have the answer. Staff will reply via Discord. Use check_reply to retrieve the response later.
Input schema
{'type': 'object', 'required': ['question'], 'properties': {'name': {'type': 'string', 'description': 'Your name (optional)'}, 'question': {'type': 'string', 'description': 'Question to ask GYOTAK staff'}}}
create_payment
Test / QA only — do not use for customer orders, and do not call it after placing a customer order: customers pay via the PromptPay QR attached to the order confirmation email. Works only for orders of GYOTAK test customers; for any other order_id it returns PromptPay guidance and creates nothing. For a test order it computes the THB→tADA conversion, creates a Cardano preprod payment session with a 30-minute expiry, and returns the payment details (GYOTAK A→B→A round-trip).
Input schema
{'type': 'object', 'required': ['order_id'], 'properties': {'order_id': {'type': 'string', 'description': 'Order ID (e.g. "BB-42")'}}}
get_catalog
Get GYOTAK's full fish catalog with real-time availability, retail prices (THB/kg), freshness tiers, and traceability records. Retail prices are always included. For registered chat customers, pass customerKey (gyotak_cus_...) to show wholesale pricing and enable one-tap checkout. For LINE VIP customers, pass lineUserId. Delivery is available within Thailand only. International addresses are not accepted.
Input schema
{'type': 'object', 'required': [], 'properties': {'lineUserId': {'type': 'string', 'description': 'LINE user ID for VIP pricing (optional)'}, 'customerKey': {'type': 'string', 'description': 'GYOTAK customerKey (gyotak_cus_...) for registered chat customers — enables identification, wholesale pricing, and one-tap checkout (optional)'}}}
get_catch_reports
Get catch records by date or freshness tier. Returns GPS coordinates, photo timestamp, and blog URL for traceability verification. In-stock products reference these records; consumers can access records via blog URL on package label even after sold out. Planned integration: Each catch record will be registered on Midnight blockchain as an immutable on-chain transaction, making GPS coordinates, timestamps, and photo hashes tamper-proof and permanently verifiable.
Input schema
{'type': 'object', 'required': [], 'properties': {'date': {'type': 'string', 'description': 'YYYY-MM-DD format. Returns records for that specific date.'}, 'tier': {'enum': ['fresh', 'tier1', 'tier2'], 'type': 'string', 'description': 'Freshness tier: fresh=last 30 days, tier1=31-60 days, tier2=61-90 days'}}}
get_contact_info
Get the two ways to buy from GYOTAK, with the contact details for each: retail (order here through place_order, or browse the web shop) and B2B wholesale for restaurants and businesses (LINE @284ezjvm, tier pricing, application required). Call this when the user asks how to buy, how to open a wholesale account, or how to reach GYOTAK. Takes no arguments and returns static text — for product availability or prices use get_catalog, and for other questions use ask_gyotak.
Input schema
{'type': 'object', 'required': [], 'properties': {}}
get_komon_records
Get GYOTAK KOMON physical authentication records from the database. Each record represents a PUF (physically unclonable function) registration with minutiae extraction and on-chain commitment. Shielded records do not expose GPS.
Input schema
{'type': 'object', 'required': [], 'properties': {'status': {'enum': ['pending', 'live'], 'type': 'string', 'description': 'Filter by status (default: all non-test)'}}}
get_order_history
Get B2B order history (last 20 orders). Requires lineUserId of a registered VIP customer.
Input schema
{'type': 'object', 'required': ['lineUserId'], 'properties': {'lineUserId': {'type': 'string', 'description': 'LINE user ID of the VIP customer'}}}
get_share_kit
Get the facts and constraints for writing a social media post about GYOTAK with the caller's referral URL: order facts, fish photo URLs, verification page URLs of the caller's stamped purchase proofs, allowed and forbidden claims, and the required referral disclosure. The wording is up to the user and their assistant. Call this again each time the user asks for a post; do not reuse a previous result.
Input schema
{'type': 'object', 'required': [], 'properties': {'customerKey': {'type': 'string', 'description': 'Your customerKey (gyotak_cus_...). Omit when connected through a personal token URL.'}, 'includePhotos': {'type': 'boolean', 'description': 'Set true only if the user wants to attach a photo they take themselves with a blockchain capture record. Returns photo_capture_url and the list of recorded photos.'}}}
my_referrals
Show your referral summary as a GYOTAK referrer: your referral URL, number of referred orders (paid / unpaid), this month's estimated commission, unpaid balance, payout destination status, and the last 5 paid referred orders (order number, date, subtotal, commission — no buyer details). Only works for the customer of this connection; if you are connected through a personal token URL, omit customerKey.
Input schema
{'type': 'object', 'required': [], 'properties': {'customerKey': {'type': 'string', 'description': 'Your customerKey (gyotak_cus_...). Omit when connected through a personal token URL.'}}}
place_order
Place an order. Two modes: (A) VIP wholesale: provide lineUserId of a registered VIP customer. (B) Guest retail: provide customerName, phone, items array, and a delivery address — shippingAddress, shippingProvince and email are all required, and an order missing any of them is rejected. Guest orders are priced at tier-linked retail rates (server-calculated) and the total is final at this point; a confirmation email with a PromptPay QR follows. Without customerKey or a personal token URL connection, every order creates a new customer with a new customerKey, even when the email was used before (orders are never linked to an existing customer by email); the new key is returned in the response and the confirmation email — tell the user to save it. Inventory is NOT deducted — orders go to the pick queue for staff fulfillment. Delivery is available within Thailand only, so the province must be a Thai one. International addresses are not accepted.
Input schema
{'type': 'object', 'properties': {'lang': {'enum': ['ja', 'en', 'th'], 'type': 'string', 'description': '(Guest mode, optional) Language of the confirmation email. Defaults to en.'}, 'memo': {'type': 'string', 'description': '(Optional) Order notes'}, 'email': {'type': 'string', 'description': '(Guest mode) Email address for the order confirmation — required for guest orders'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['fishName', 'tier', 'band', 'qty'], 'properties': {'qty': {'type': 'number', 'description': 'Number of packs'}, 'band': {'type': 'string', 'description': 'Weight band (e.g. "140-180g")'}, 'tier': {'enum': ['Fresh', 'Tier1', 'Tier2'], 'type': 'string'}, 'status': {'type': 'string', 'description': 'Cut / preparation of the fish (e.g. "sashimi fillet"). Pass the status shown for this fish in get_catalog, verbatim. Optional: when omitted the server fills it in from stock, and asks which one if more than one cut is available.'}, 'fishName': {'type': 'string'}}}, 'description': '(Guest mode) Order items'}, 'phone': {'type': 'string', 'description': '(Guest mode) Contact phone number'}, 'fishName': {'type': 'string', 'description': '(VIP mode) Fish name (romaji)'}, 'totalThb': {'type': 'number', 'description': '(VIP mode) Total amount in THB'}, 'lineUserId': {'type': 'string', 'description': 'LINE user ID of VIP customer (VIP mode). Omit for guest mode.'}, 'referrerId': {'type': 'string', 'description': '(Optional) Referrer ID for tracking'}, 'customerKey': {'type': 'string', 'description': '(Guest mode) Registered customer key (from register_customer). Resolves name/phone/shipping automatically. If you are connected through a personal token URL the customer is already resolved: send items[] alone and omit this, customerName, phone and lineUserId.'}, 'requestedKg': {'type': 'number', 'description': '(VIP mode) Requested weight in kg'}, 'customerName': {'type': 'string', 'description': '(Guest mode) Customer name'}, 'shippingAddress': {'type': 'string', 'description': '(Guest mode) Street address and building name — required for guest orders'}, 'shippingDistrict': {'type': 'string', 'description': '(Guest mode) Hua Hin / Pranburi 等の地元配達判定に必須。住所に含まれていれば自動判定するが、明示推奨 / District name. Required to detect local (free) delivery for Hua Hin / Pranburi. Auto-detected from shippingAddress when present, but explicit value recommended.'}, 'shippingProvince': {'type': 'string', 'description': '(Guest mode) Thai province name, used for shipping cost — required for guest orders. Thailand only.'}}}
recover_customer_key
Explains where a lost customerKey can be found: a key issued with an order is written in the order confirmation email sent to the registered address (each order placed without a key has its own key). For keys that cannot be found there, it points to contact_gyotak. This tool does not look up, verify or send anything.
Input schema
{'type': 'object', 'required': ['phone'], 'properties': {'phone': {'type': 'string', 'description': 'Phone number used at registration'}}}
register_customer
Register as a GYOTAK customer. Collect name, phone, address, email, and customer type (Retail or Wholesale) via conversation BEFORE calling this tool. Returns a customerKey for future orders. Save the key in your AI memory.
Input schema
{'type': 'object', 'required': ['name', 'phone', 'address', 'customerType'], 'properties': {'name': {'type': 'string', 'description': 'Full name (English)'}, 'email': {'type': 'string', 'description': 'Email address (optional)'}, 'phone': {'type': 'string', 'description': 'Contact phone number'}, 'address': {'type': 'string', 'description': 'Shipping address'}, 'customerType': {'enum': ['Retail', 'Wholesale'], 'type': 'string', 'description': 'Customer type: Retail (consumer) or Wholesale (business)'}}}
register_payout
Email the GYOTAK referrer a link to the form where they register where their commission should be sent: a Thai PromptPay QR (read inside the form, the image is never uploaded) or a stablecoin address (USDC on Base, or USDM on Cardano). Call this when the user wants to register, see, or change their payout destination. Returns the destination currently on file, masked, and the masked address the link was sent to. For security the form URL is never shown in the chat — the link goes only to the email address on file, so tell the user to open it from their email. Never ask the user to type the number or the wallet address into the chat.
Input schema
{'type': 'object', 'required': [], 'properties': {'customerKey': {'type': 'string', 'description': 'Your customerKey (gyotak_cus_...). Omit when connected through a personal token URL.'}}}
report_share
Report a social media post you published that recommends GYOTAK with your referral URL. Call this right after posting, with the platform and the public URL of the post. GYOTAK records it and later verifies that the post is public and contains the referral URL.
Input schema
{'type': 'object', 'required': ['platform', 'post_url'], 'properties': {'platform': {'enum': ['x', 'instagram', 'facebook', 'threads', 'line', 'other'], 'type': 'string', 'description': 'Platform the post was published on'}, 'post_url': {'type': 'string', 'description': 'Public https URL of the published post'}, 'customerKey': {'type': 'string', 'description': 'Your customerKey (gyotak_cus_...). Omit when connected through a personal token URL.'}}}
search_fish
Search fish by name (Japanese, Thai, or English). Provide lineUserId to include VIP tier pricing.
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'Fish name to search for'}, 'lineUserId': {'type': 'string', 'description': 'LINE user ID for VIP pricing (optional)'}}}
verify_catch
Verify a GYOTAK catch record DIRECTLY from the Midnight blockchain. Reads on-chain state and returns the raw hex plus decoded fields for independent verification. Unlike get_catch_reports (which returns GYOTAK's own database), this lets you verify without trusting GYOTAK. GPS coordinates are cryptographically hidden (hiding commitment with secret nonce); only the region is provable. Supports both preprod and mainnet. batchId also accepts several IDs separated by commas: they are all checked against a single fetch of the contract state, and the response lists found/not-found per ID.
Input schema
{'type': 'object', 'required': ['contractAddress'], 'properties': {'batchId': {'type': 'string', 'description': 'Filter to a specific catch record by batchId (e.g. "CR-TESTV3-INSIDE-02"). Omit to return all records in the contract.'}, 'network': {'enum': ['preprod', 'mainnet'], 'type': 'string', 'description': 'Midnight network (default: preprod)'}, 'contractAddress': {'type': 'string', 'description': 'Midnight contract address (64-char hex). Example: 2e519c349331a6aaee82a7ed31aa5e39d6a3995f6cf85ec2256c97cda9a8c302'}}}
verify_komon
Verify a GYOTAK KOMON record directly from the Midnight blockchain. Reads on-chain state and returns the raw hex plus decoded fields for independent verification. Unlike get_komon_records (which returns GYOTAK's database), this reads directly from the chain. Shielded records prove region membership without exposing GPS. Currently preprod only.
Input schema
{'type': 'object', 'required': [], 'properties': {'komonId': {'type': 'string', 'description': 'Filter to a specific komon record by ID. Omit to return all records.'}, 'network': {'enum': ['preprod', 'mainnet'], 'type': 'string', 'description': 'Midnight network (default: preprod)'}, 'contractAddress': {'type': 'string', 'description': 'Midnight komon contract address (64-char hex)'}}}
verify_temp
Verify GYOTAK cold-chain storage temperatures DIRECTLY from the Midnight blockchain. Reads on-chain state and returns decoded hourly temperature records per freezer for independent verification. Unlike the dashboard (which reads from GYOTAK's D1 database), this lets you verify without trusting GYOTAK. Each value is the HOURLY AVERAGE committed on-chain; it does not prove the temperature stayed within any limit at every moment in that hour. Supports both preprod and mainnet.
Input schema
{'type': 'object', 'properties': {'network': {'enum': ['preprod', 'mainnet'], 'type': 'string', 'description': 'Midnight network (default: mainnet)'}, 'freezerId': {'type': 'number', 'description': 'Filter to a specific freezer by ID. Omit to return all freezers.'}, 'hourStartUtc': {'type': 'string', 'description': 'Filter to a specific hour (e.g. "2026-07-09 11:00:00"). Omit to return all hours.'}, 'contractAddress': {'type': 'string', 'description': 'Midnight temp-log contract address (64-char hex). Default: mainnet production contract.'}}}
Changed
confirm_payment
Sept. 27, 2026, 2:53 a.m.
Changed
check_payment_status
Sept. 27, 2026, 2:53 a.m.
Changed
create_payment
Sept. 27, 2026, 2:53 a.m.
Changed
recover_customer_key
Sept. 27, 2026, 2:53 a.m.
Changed
place_order
Sept. 27, 2026, 2:53 a.m.
Changed
claim_purchase_proof
Sept. 25, 2026, 3:03 a.m.
Changed
get_share_kit
Sept. 25, 2026, 3:03 a.m.
Changed
claim_purchase_proof
Sept. 21, 2026, 3:01 a.m.
Added
claim_purchase_proof
Sept. 19, 2026, 2:52 a.m.
Added
confirm_payment
Sept. 17, 2026, 12:37 p.m.
Added
register_payout
Sept. 17, 2026, 12:37 p.m.
Added
report_share
Sept. 17, 2026, 12:37 p.m.
Added
get_share_kit
Sept. 17, 2026, 12:37 p.m.
Added
my_referrals
Sept. 17, 2026, 12:37 p.m.
Added
apply_referrer
Sept. 17, 2026, 12:37 p.m.
Added
check_payment_status
Sept. 17, 2026, 12:37 p.m.
Added
create_payment
Sept. 17, 2026, 12:37 p.m.
Added
recover_customer_key
Sept. 17, 2026, 12:37 p.m.
Added
register_customer
Sept. 17, 2026, 12:37 p.m.
Added
check_reply
Sept. 17, 2026, 12:37 p.m.
Added
contact_gyotak
Sept. 17, 2026, 12:37 p.m.
Added
ask_gyotak
Sept. 17, 2026, 12:37 p.m.
Added
verify_komon
Sept. 17, 2026, 12:37 p.m.
Added
get_komon_records
Sept. 17, 2026, 12:37 p.m.
Added
verify_temp
Sept. 17, 2026, 12:37 p.m.
Added
verify_catch
Sept. 17, 2026, 12:37 p.m.
Added
get_order_history
Sept. 17, 2026, 12:37 p.m.
Added
place_order
Sept. 17, 2026, 12:37 p.m.
Added
get_catch_reports
Sept. 17, 2026, 12:37 p.m.
Added
get_contact_info
Sept. 17, 2026, 12:37 p.m.