Particl MCP integration

Get company details

Get detailed information about a specific company. Args: company_id: The Particl company ID (e.g., '1234567') analysis_goal: Brief summary of the user's research objective for this query. Fill this in based on what the user is trying to learn. Omit if unknown. Credits: 1 credit per call (not charge…

Get company events

Get promotional events for a company — product launches, sales, restocks, price changes, and discounts — with associated marketing assets and products. Supports pagination. Use search_companies first to find the company_id. Args: company_id: The Particl company ID (e.g., '1234567') - required start…

Get company marketing assets

List a company's marketing assets — emails, Instagram posts, Facebook/Meta ads, SMS messages, and homepage screenshots. Supports pagination. Use search_companies first to find the company_id. Args: company_id: The Particl company ID (e.g., '1234567') - required asset_types: Filter by asset type(s).…

Get company marketing stats

Get aggregated marketing engagement statistics for a company — posting frequency by type, average likes, engagement rate, most liked post, and posting hour distribution. Use search_companies first to find the company_id. Args: company_id: The Particl company ID (e.g., '1234567') - required analysis…

Get company products

Deep-dive into a specific company's product catalog. Supports pagination — use page and page_size to retrieve more than the default 25 results. Use search_companies first to find the company_id. Args: company_id: The Particl company ID (e.g., '1234567') - required. Use search_companies to find this…

Get credit balance

Check your remaining export credits. Credits: Free — no credits charged. Returns: Credit balance including total limit, used, and remaining credits

Get marketing asset details

Get full details of a specific marketing asset — email content, social post with engagement metrics, ad creative with cards, or homepage screenshot. Args: company_id: The Particl company ID (e.g., '1234567') - required asset_id: The asset ID - required analysis_goal: Brief summary of the user's res…

Get market pricing analysis

Get pricing analysis for a market or category. Args: product_type_id: Product type UUID from get_product_types. Pass the product_type_id value, not the name. keyword: Filter by keyword/tag end_date: End of trailing 30-day analysis window (ISO format, e.g., '2025-01-15'). Defaults to ~2 days ago. an…

Get market sales

Get aggregated market-level sales data with monthly timeseries. Returns total market revenue and volume, plus monthly timeseries showing how the market is trending over time. Use with get_market_top_companies and get_market_top_products for complete market analysis. Args: product_type_id: Product t…

Get market top companies

Get top-performing companies in a market or category. Supports pagination — use page and page_size to retrieve more than the default 25 results. Args: product_type_id: Product type UUID from get_product_types. Pass the product_type_id value, not the name. keyword: Filter by keyword/tag (e.g., 'luxu…

Get market top products

Get best-selling products in a market or category. Supports pagination — use page and page_size to retrieve more than the default 25 results. Args: product_type_id: Product type UUID from get_product_types. Pass the product_type_id value, not the name. keyword: Filter by keyword/tag (e.g., 'sustain…

Get product breakdown

Get product data broken down by a specific attribute (color, brand, material, keyword, gender, or location). Useful for understanding product mix — e.g., which colors sell best, which brands dominate, what materials are most popular. Args: company_id: The Particl company ID (e.g., '1234567') - requ…