Tools Reference

All MCP tools available through the Particl server. These tools are automatically discovered by your AI client.

How tools work

Your AI assistant automatically selects and calls the right tools based on your questions. You don't need to reference tool names directly — just ask naturally and the AI will figure out which tools to use.

Free tools

These tools don't consume any export credits.

search_companies

Free

Search for companies by name or domain. Returns matching companies with basic metadata. Use this to find company IDs for other tools.

Parameters

searchstringrequired

Search term — company name or domain (max 200 characters)

page_sizeinteger

Results per page (default: 25, max: 100)

pageinteger

Page number, 0-indexed (default: 0)

sort_bystring

"popularity" (default) or "start_date"

get_credit_balance

Free

Check how many export credits remain on your account. Useful for monitoring usage before running paid queries.

No parameters required

Company tools

Look up details and browse the product catalog for a specific company.

get_company_details

1 credit/call

Get metadata for a specific company — name, domain, country, and tracking start date.

Parameters

company_idstringrequired

Particl company ID (e.g. "lululemon-com")

get_company_products

1 credit/row

Deep-dive into a specific company’s product catalog. The primary tool for company-level analysis — supports full pagination and custom date ranges. Use search_companies first to find the company ID.

Parameters

company_idstringrequired

Particl company ID (e.g. "lululemon-com")

product_typestring

Product type ID to filter by

keywordstring

Tag filter (e.g. "wool", "recycled", "organic")

brandstring

Filter by brand name

min_pricefloat

Minimum price filter

max_pricefloat

Maximum price filter

sort_bystring

"sales_revenue" (default), "sales_volume", "price", or "launch_date"

sort_directionstring

"desc" (default) or "asc"

page_sizeinteger

Results per page (default: 25, max: 100)

pageinteger

Page number, 0-indexed (default: 0)

start_datestring

Start of date range (YYYY-MM-DD, defaults to ~30 days ago)

end_datestring

End of date range (YYYY-MM-DD, defaults to today)

Market tools

Search products across all brands, see top sellers, top companies, and pricing analysis for any category.

search_market_products

1 credit/row

Search products across all tracked companies. Use this for broad market scans. For a specific company’s catalog, use get_company_products instead.

Parameters

product_typestring

Product type ID to filter by

keywordstring

Tag filter (e.g. "wool", "recycled", "organic")

brandstring

Filter by brand name

min_pricefloat

Minimum price filter

max_pricefloat

Maximum price filter

sort_bystring

"sales_revenue" (default), "sales_volume", "price", or "launch_date"

sort_directionstring

"desc" (default) or "asc"

page_sizeinteger

Results per page (default: 25, max: 100)

pageinteger

Page number, 0-indexed (default: 0)

start_datestring

Start of date range (YYYY-MM-DD, defaults to ~30 days ago)

end_datestring

End of date range (YYYY-MM-DD, defaults to today)

get_market_top_products

1 credit/row

Get the best-selling products in a category over the trailing 30 days. High-level summary with no pagination.

Parameters

product_typestring

Product type ID to filter by

keywordstring

Tag filter

end_datestring

End of the 30-day window (YYYY-MM-DD, defaults to ~2 days ago)

get_market_top_companies

1 credit/row

Get the top-performing companies in a category over the trailing 30 days. Great for understanding competitive landscape at a glance.

Parameters

product_typestring

Product type ID to filter by

keywordstring

Tag filter

end_datestring

End of the 30-day window (YYYY-MM-DD, defaults to ~2 days ago)

get_market_pricing_analysis

1 credit/call

Get price distribution and statistics for a product category. Returns min, max, average, and percentile breakdowns.

Parameters

product_typestring

Product type ID to filter by

keywordstring

Tag filter

end_datestring

End of the 30-day window (YYYY-MM-DD, defaults to ~2 days ago)