fix: Review comments

Author: jirispilka

docs/claude-code-tools.json

@@ -244,8 +244,7 @@ async function getMCPServersAsTools(
                 // Skip this Actor, connectMCPClient will log the error
                 return [];
             }
-            const serverTools = await getMCPServerTools(actorId, client, mcpServerUrl);
-            return serverTools;
+            return await getMCPServerTools(actorId, client, mcpServerUrl);
         } finally {
             if (client) await client.close();
         }
@@ -340,7 +339,7 @@ There are two ways to run Actors:
 
 **Important:**
 
-A successful run returns a \`datasetId\` (the Actor's output stored as an Apify dataset) and a short preview of items.
+Typically, a successful run returns a \`datasetId\` (the Actor's output stored as an Apify dataset) and a short preview of items.
 To fetch the full output, use the ${HelperTools.ACTOR_OUTPUT_GET} tool with the \`datasetId\`.
 
 USAGE:
@@ -354,8 +353,8 @@ Step 1: Get Actor Info (step="info", default)
 - You MUST do this step first - it's required to understand how to call the Actor
 
 Step 2: Call Actor (step="call")
-- Only after step 1, call again with step="call" and proper input based on the schema
-- This calls and runs the Actor. It will create an output as an Apify dataset (with datasetId).
+- Only after step 1, call this tool again with step="call" and proper input based on the schema
+- This runs the Actor. It will create an output as an Apify dataset (with datasetId).
 - This step returns a dataset preview, typically JSON-formatted tabular data.
 
 EXAMPLES:

src/tools/actor.ts

@@ -54,7 +54,7 @@ Note: itemCount updates may be delayed by up to ~5 seconds.
 USAGE:
 - Use when you need dataset metadata to understand its structure before fetching items.
 
-EXAMPLES:
+USAGE EXAMPLES:
 - user_input: Show info for dataset 8TtYhCwKzQeQk7dJx
 - user_input: What fields does username~my-dataset have?`,
         inputSchema: zodToJsonSchema(getDatasetArgs),
@@ -89,7 +89,7 @@ The results will include items along with pagination info (limit, offset) and to
 USAGE:
 - Use when you need to read data from a dataset (all items or only selected fields).
 
-EXAMPLES:
+USAGE EXAMPLES:
 - user_input: Get first 100 items from dataset 8TtYhCwKzQeQk7dJx
 - user_input: Get only metadata.url and title from dataset username~my-dataset (flatten metadata)`,
         inputSchema: zodToJsonSchema(getDatasetItemsArgs),
@@ -151,7 +151,7 @@ Use this to understand the dataset before fetching many items.
 USAGE:
 - Use when you need to infer the structure of dataset items for downstream processing or validation.
 
-EXAMPLES:
+USAGE EXAMPLES:
 - user_input: Generate schema for dataset 8TtYhCwKzQeQk7dJx using 10 items
 - user_input: Show schema of username~my-dataset (clean items only)`,
         inputSchema: zodToJsonSchema(getDatasetSchemaArgs),

src/tools/dataset.ts

@@ -39,7 +39,7 @@ Use limit (max 20), offset, and desc to paginate and sort.
 USAGE:
 - Use when you need to browse available datasets (named or unnamed) to locate data.
 
-EXAMPLES:
+USAGE EXAMPLES:
 - user_input: List my last 10 datasets (newest first)
 - user_input: List unnamed datasets`,
         inputSchema: zodToJsonSchema(getUserDatasetsListArgs),

src/tools/dataset_collection.ts

@@ -24,7 +24,7 @@ Present the information in a user-friendly Actor card.
 USAGE:
 - Use when a user asks about an Actor’s details, input schema, README, or how to use it.
 
-EXAMPLES:
+USAGE EXAMPLES:
 - user_input: How to use apify/rag-web-browser
 - user_input: What is the input schema for apify/rag-web-browser?
 - user_input: What is the pricing for apify/instagram-scraper?`,

src/tools/fetch-actor-details.ts

@@ -25,7 +25,7 @@ Use this after finding a relevant page with the ${HelperTools.DOCS_SEARCH} tool.
 USAGE:
 - Use when you need the complete content of a specific docs page for detailed answers.
 
-EXAMPLES:
+USAGE EXAMPLES:
 - user_input: Fetch https://docs.apify.com/platform/actors/running#builds
 - user_input: Fetch https://docs.apify.com/academy`,
         args: fetchApifyDocsToolArgsSchema,

src/tools/fetch-apify-docs.ts

@@ -79,7 +79,7 @@ You can obtain the datasetId from an Actor run (e.g., after calling an Actor wit
 USAGE:
 - Use when you need to read Actor output data (full items or selected fields), especially when preview does not include all fields.
 
-EXAMPLES:
+USAGE EXAMPLES:
 - user_input: Get data of my last Actor run
 - user_input: Get number_of_likes from my dataset
 - user_input: Return only crawl.statusCode and url from dataset 8TtYhCwKzQeQk7dJx

src/tools/get-actor-output.ts

@@ -49,7 +49,7 @@ The results will include a chunked HTML skeleton if the content is large. Use th
 USAGE:
 - Use when you need a clean HTML structure to design selectors or parsers for scraping.
 
-EXAMPLES:
+USAGE EXAMPLES:
 - user_input: Get HTML skeleton for https://example.com
 - user_input: Get next chunk of HTML skeleton for https://example.com (chunk=2)`,
         inputSchema: zodToJsonSchema(getHtmlSkeletonArgs),

src/tools/get-html-skeleton.ts

@@ -23,7 +23,7 @@ You can first discover Actors using the ${HelperTools.STORE_SEARCH} tool, then a
 USAGE:
 - Use when a user has chosen an Actor to work with and you need to make it available as a callable tool.
 
-EXAMPLES:
+USAGE EXAMPLES:
 - user_input: Add apify/rag-web-browser as a tool
 - user_input: Add apify/instagram-scraper as a tool`,
         inputSchema: zodToJsonSchema(addToolArgsSchema),

src/tools/helpers.ts

@@ -26,7 +26,7 @@ The results will include store metadata (ID, name, owner, access settings) and u
 USAGE:
 - Use when you need to inspect a store to locate records or understand its properties.
 
-EXAMPLES:
+USAGE EXAMPLES:
 - user_input: Show info for key-value store username~my-store
 - user_input: Get details for store 8TtYhCwKzQeQk7dJx`,
         inputSchema: zodToJsonSchema(getKeyValueStoreArgs),
@@ -69,7 +69,7 @@ Use exclusiveStartKey and limit to paginate.
 USAGE:
 - Use when you need to discover what records exist in a store.
 
-EXAMPLES:
+USAGE EXAMPLES:
 - user_input: List first 100 keys in store username~my-store
 - user_input: Continue listing keys in store 8TtYhCwKzQeQk7dJx from key data.json`,
         inputSchema: zodToJsonSchema(getKeyValueStoreKeysArgs),
@@ -110,7 +110,7 @@ The response preserves the original Content-Encoding; most clients handle decomp
 USAGE:
 - Use when you need to retrieve a specific record (JSON, text, or binary) from a store.
 
-EXAMPLES:
+USAGE EXAMPLES:
 - user_input: Get record INPUT from store 8TtYhCwKzQeQk7dJx
 - user_input: Get record data.json from store username~my-store`,
         inputSchema: zodToJsonSchema(getKeyValueStoreRecordArgs),