Skip to main content
Glama

run_producthunt_collections_search

Search Product Hunt collections by keyword or browse them page by page to retrieve relevant collection records for research and discovery.

Instructions

Browse Product Hunt collections page by page, or search them by keyword. 1 point per returned record.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "run_producthunt_collections_search"
  }
}

Input Schema

NameRequiredDescriptionDefault
keywordNoKeyword (optional). e.g. design
max_itemsNoMax items (up to 250)
start_pageNoStarting page

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv1.0.1

TDQS

A3.5/5.0
Behavior3/5

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

No annotations are provided, so the description carries the full behavioral burden. It discloses a pricing rule ('1 point per returned record') and pagination behavior ('page by page'), but omits auth requirements, rate limits, return format, and error behavior.

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

Conciseness5/5

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

Two short sentences, front-loading the browse/search choice and appending the cost note. Every clause conveys purpose or a key operational trait, with no redundancy.

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

Completeness3/5

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

For a simple 3-param read-only search with no output schema and no annotations, the description covers mode and cost but omits return shape, pagination interplay, and any explicit safety/read-only signal. It is adequate but has clear gaps.

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 keyword, max_items, and start_page. The description only indirectly references pagination and cost; it adds no format details or interaction semantics for the parameters.

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

Purpose4/5

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

States a specific verb (browse/search) and resource (Product Hunt collections), making the tool's function clear. However, it does not distinguish this tool from the sibling run_producthunt_collections, which likely also browses collections.

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

Usage Guidelines3/5

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

The description implies optional keyword use for searching versus browsing page by page, giving some usage context. It does not specify when to choose this tool over run_producthunt_collections or other Product Hunt search siblings, nor when not to use it.

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

Deploy Server

Other Tools