Experience MCOP server for web scraping, google search and website urls search.
Three tools with basic schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. All tools have names starting with action verbs (get_, google_) and descriptions present, but descriptions are minimal (34-56 chars, below the 50-200 char baseline for LLM optimization). Parameter descriptions exist but lack detail on constraints, formats, and valid ranges. Output schemas are not documented, LLMs cannot predict response structure. Error handling returns text blobs rather than structured guidance. No tool annotations (readOnlyHint, etc.). Tools are read-only and low-risk, but definition quality is below production baseline.
Retrieve content of a webpage in markdown
Search and retrieve relevant URLs from a website
Retrieve structured data from Google search results
Descriptions are too short (30-56 chars vs. 50-200 char baseline). 'Retrieve content of a webpage in markdown' lacks context on when to use this vs. get_website_urls, what format is returned, or prerequisites.
Output schemas are not documented. Callers cannot predict response structure (e.g., does google_search return a list of results or a single JSON object?). LLMs must guess or infer from examples.
Parameter descriptions lack constraint details. 'country' is described as 'Residential country to load the request from (e.g., US, CA, GB)' but does not specify format (2-letter ISO code?), whether it is required, or valid range. LLMs may pass invalid values.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 46 | 2026-07-28+ | v2 |
Error responses return unstructured text (e.g., 'Experience API Error: 401 Unauthorized. Details: {...}'). No guidance on recovery: should the agent retry, ask the user for a new API key, or give up? Errors do not classify as retryable vs. fatal.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). All three tools are read-only and idempotent, but this is not declared in the schema. Clients cannot optimize caching or retry logic without explicit hints.