List solo service-provider profiles on this site — businesses without a fixed physical location (e.g. dog walkers, tutors, personal trainers). Returns name, profile URL, category, and any available metadata (age, height, etc.).
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max profiles to return (default 50). |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description must fully convey behavior. It only states it lists profiles with no mention of pagination, authentication, side effects, or rate limits. The read-only nature is implied but not explicit.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description consists of two sentences with no unnecessary words. It front-loads the purpose and provides examples efficiently.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no output schema, the description covers the return structure adequately ('name, profile URL, category, and any available metadata'). The tool is simple with one parameter, so no critical information is missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% coverage with a single 'limit' parameter already described. The description adds value by specifying the return fields (name, profile URL, category, metadata), which helps understand the parameter's context.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'List' and the specific resource 'solo service-provider profiles' with examples (dog walkers, tutors). It defines what qualifies (no fixed physical location) and mentions return fields. This distinguishes it from sibling tools, none of which list profiles.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for listing solo providers but does not explicitly state when to use this tool vs alternatives like list_booking_services. No when-not or exclusion criteria are provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.
Every tool targets a distinct Wix resource or action: bookings, events, store, forms, places, menus, etc. The four booking-related tools are clearly separated by domain (appointments, restaurant tables, paid events, free events), with descriptions that eliminate ambiguity.
The set follows a consistent verb_noun snake_case pattern (create_, get_, list_, search_, submit_). Minor deviations exist: get_reviews and get_event_tickets return collections (could be list_), and rsvp_event uses an abbreviation, but these do not affect clarity.
At 26 tools, the set is larger than the typical 3–15 well-scoped range, but the server covers a broad umbrella of Wix integrations for a neighborhood directory. Each tool maps to a distinct function, so the count is justified by the scope, though it is on the heavier side.
The surface covers discovery and transactional workflows: searching places/dishes, viewing menus/reviews/guides/offers, booking appointments and tables, reserving event tickets, purchasing products, submitting forms, and reading site info. Minor gaps exist (no cancel/update operations), but these are handled via external checkout links and are acceptable for a directory.
