Haal het volledige publieke profiel van een marketingbureau op aan de hand van zijn slug. Geeft 404 als de slug niet bestaat of het bureau niet bereikt wil worden via MCP.
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Er zijn geen annotations, dus de beschrijving draagt de volledige verantwoordelijkheid. Ze discloseert een belangrijk gedrag: 404 bij niet-bestaande slug of als het bureau niet via MCP bereikt wil worden. 'Publieke profiel' signaleert bovendien dat het om een leesoperatie zonder gevoelige data gaat. Details over auth of rate limits ontbreken, maar voor een eenvoudige getter is de belangrijkste foutconditie gedekt.
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?
De beschrijving is één zin zonder overbodige woorden. De actie en de resource staan vooraan, en de nuttige 404-conditie wordt compact toegevoegd. Elke zin draagt bij.
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?
Voor een tool met één parameter en geen outputschema dekt de beschrijving het doel en de belangrijkste foutconditie. Er ontbreekt echter expliciete verwijzing naar wanneer je dit boven de siblings gebruikt, en omdat er geen outputschema is, wordt niet duidelijk welke profielvelden terugkomen. Het is adequaat maar niet volledig zelfstandig.
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?
De schema-dekking is 0%, dus de beschrijving moet compenseren. Ze zegt dat de slug het identificatiemiddel is, wat minimale betekenis toevoegt boven het schema. Maar er wordt niet uitgelegd wat een slug precies is, hoe die eruitziet of waar je die vindt, dus de compensatie blijft beperkt.
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?
De beschrijving geeft een specifiek werkwoord ('Haal ... op'), een duidelijk object ('het volledige publieke profiel van een marketingbureau') en de identificatiemethode ('aan de hand van zijn slug'). Het onderscheidt zich impliciet van sibling-tools zoals find_agency en search_agencies omdat het om het volledige profiel gaat in plaats van zoeken of vinden.
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?
Het gebruik is impliciet: je gebruikt dit wanneer je al een slug hebt en het volledige publieke profiel nodig hebt. Er wordt echter geen expliciete vergelijking gemaakt met find_agency of search_agencies, en er staat niet wanneer je dit juist niet moet gebruiken.
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.
Each tool targets a distinct phase: exact name/domain lookup (find_agency), criteria-based ranked search (search_agencies), profile retrieval (get_agency_profile), and RFQ submission (submit_rfq). The descriptions explicitly differentiate find_agency from search_agencies, removing any ambiguity.
All tool names follow a consistent verb_noun pattern in snake_case: find_agency, get_agency_profile, search_agencies, submit_rfq. The verbs are short, active, and clearly reflect each operation with no mixed conventions.
Four tools is a compact, well-scoped set for the server's purpose: discovering, inspecting, and contacting marketing agencies. Each tool has a clear role and no redundancy exists.
The core journey is covered: find/search agencies, retrieve full profiles via slug, and submit RFQs. Minor gaps remain, such as no status tracking for submitted RFQs and no direct tool for listing valid category values (though exposed as a resource).