Skip to main content
Glama
Sign In

SHOPZI: založení obchodu

by cz.shopzi
OverviewDiscussionsAdmin

Založit koncept obchodu

shopzi_create_store

Založí KONCEPT nového obchodu a podrží pro něj subdoménu. Obchod ještě nevznikne: člověk otevře draft_url v prohlížeči, zadá pairing_code, ověří e-mail a přijme podmínky. Tarif free vznikne hned potom, bez platební karty. Placený tarif chce navíc uložit kartu; bez ní obchod nevznikne, 30 dní je zdarma a první platba přijde 31. den. Nástroj nic neúčtuje a neposílá žádný e-mail. Průběh sleduj nástrojem shopzi_store_creation_status. API klíč k novému obchodu se v terminálu nikdy neobjeví, ukáže se jednou v prohlížeči.

Input Schema

NameRequiredDescriptionDefault
planYesTarif z `shopzi_list_plans`. `free` = obchod zdarma bez platební karty; placené tarify chtějí kartu (30 dní zdarma).
intervalYesMěsíční (`monthly`), nebo roční (`annual`) platba. U tarifu `free` na hodnotě nezáleží.
shop_nameYesNázev obchodu, jak ho uvidí zákazníci.
subdomainYesSubdoména obchodu. Ověř ji napřed nástrojem `shopzi_check_subdomain`.

Output Schema

NameRequiredDescriptionDefault
planYes
currencyYes
intervalYes
shop_urlYesAdresa, na které obchod poběží (u placeného tarifu po uložení platební karty).
draft_urlYesOdkaz, který člověk otevře v prohlížeči. Dokončí v něm e-mail, podmínky a u placeného tarifu uložení karty.
plan_nameYesČeský název tarifu z ceníku (`plan` je jen identifikátor). Pod tímhle názvem tarif zná člověk, který obchod zakládá.
shop_nameYes
subdomainYes
expires_atYesKdy koncept vyprší, když se nedokončí (ISO 8601).
next_stepsYes
price_minorYesCena tarifu za zvolenou periodu v haléřích (u `free` 0). Teď se neplatí nic: u placeného tarifu je prvních 30 dní zdarma a tuhle částku Stripe vyfakturuje 31. den.
pairing_codeYesKód, který člověk zadá v prohlížeči. Ukaž mu ho, stránka ho sama nezobrazí.
status_tokenYesToken pro `shopzi_store_creation_status`. Není to API klíč a nic neotevírá.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed7 schema fields changed
    • changedInput schema / properties / interval / description
      Previous value: -"Měsíční (`monthly`), nebo roční (`annual`) platba."New value: +"Měsíční (`monthly`), nebo roční (`annual`) platba. U tarifu `free` na hodnotě nezáleží."
    • changedInput schema / properties / plan / description
      Previous value: -"Tarif z `shopzi_list_plans`. Přes MCP jde založit jen placený tarif."New value: +"Tarif z `shopzi_list_plans`. `free` = obchod zdarma bez platební karty; placené tarify chtějí kartu (30 dní zdarma)."
    • changedInput schema / properties / plan / enum
      Previous value: -[
-  "start",
-  "growth",
-  "scale",
-  "pro"
-]New value: +[
+  "free",
+  "start",
+  "growth",
+  "scale",
+  "pro"
+]
    • changedOutput schema / properties / draft_url / description
      Previous value: -"Odkaz, který člověk otevře v prohlížeči. Dokončí v něm e-mail, podmínky a platbu."New value: +"Odkaz, který člověk otevře v prohlížeči. Dokončí v něm e-mail, podmínky a u placeného tarifu uložení karty."
    • changedOutput schema / properties / plan / enum
      Previous value: -[
-  "start",
-  "growth",
-  "scale",
-  "pro"
-]New value: +[
+  "free",
+  "start",
+  "growth",
+  "scale",
+  "pro"
+]
    • changedOutput schema / properties / price_minor / description
      Previous value: -"Cena tarifu za zvolenou periodu v haléřích. Teď se neplatí nic: prvních 30 dní je zdarma a tuhle částku Stripe vyfakturuje 31. den."New value: +"Cena tarifu za zvolenou periodu v haléřích (u `free` 0). Teď se neplatí nic: u placeného tarifu je prvních 30 dní zdarma a tuhle částku Stripe vyfakturuje 31. den."
    • changedOutput schema / properties / shop_url / description
      Previous value: -"Adresa, na které obchod poběží po uložení platební karty."New value: +"Adresa, na které obchod poběží (u placeného tarifu po uložení platební karty)."
  2. First observed

TDQS

A4.4/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Provides rich behavioral context beyond annotations: the tool only creates a draft (no store yet), requires browser interaction, does not charge or send email, explains free vs paid plan differences (30-day trial, card required), and states the API key appears only in the browser, never in the terminal.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loads the core action and is well-structured. It is somewhat dense but every sentence adds value (draft flow, plan details, no charges, tracking tool, API key handling). Could be marginally tighter.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the multi-step creation flow, output schema presence, and annotations, the description covers all critical behavioral aspects an agent needs: it is a draft, requires human browser steps, no immediate charges, plan-specific billing behavior, and how to track progress.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all four parameters in detail. The description adds little parameter-specific meaning beyond noting plan types, which is also in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource: 'Založí KONCEPT nového obchodu a podrží pro něj subdoménu.' It explicitly distinguishes this draft-creation step from the later actual store creation, and names the sibling tool `shopzi_store_creation_status` for progress tracking.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explains the flow clearly: a human must open `draft_url`, enter `pairing_code`, verify email, etc. It names `shopzi_store_creation_status` as the tracking tool, but does not explicitly mention `shopzi_check_subdomain` (that is only in the schema) or when not to use this tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All SHOPZI: založení obchodu toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources