> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Particl MCP

> Particl MCP gives agents read-only access to authorized market intelligence covering companies, products, pricing, sales estimates, and marketing activity.

![Particl MCP logo](https://mintcdn.com/composio-preview/gqjBKmmJCINafaiK/images/toolkits/particl_mcp.svg?fit=max\&auto=format\&n=gqjBKmmJCINafaiK\&q=85\&s=93f5a4aee71143bae69a3796073188a4)

* **Category:** model context protocol
* **Auth:** DCR\_OAUTH
* **Composio-managed OAuth available?** No
* **Tools:** 18
* **Triggers:** 0
* **Slug:** `PARTICL_MCP`
* **Version:** 20261018\_00

## Tools

> [accordion] Get company details
>
> **Slug:** `PARTICL_MCP_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 charged if no data is returned).
>
> Returns: Company profile including name, domain, country, vertical, start date, product count, whether product-level data exists (has\_product\_data), and top product categories.
>
> The has\_product\_data field indicates whether the company has product-level data. When has\_sales\_data is false, sales fields are not populated for this company. When has\_pricing\_data is false, pricing fields are not populated.
>
> #### Input Parameters
>
> **company\_id** `string` *required*
>
> **analysis\_goal** `string`

> [accordion] Get company events
>
> **Slug:** `PARTICL_MCP_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\_date: Start of date range (ISO format, e.g., '2025-01-01'). Defaults to \~30 days ago. end\_date: End of date range (ISO format, e.g., '2025-01-31'). Defaults to \~2 days ago. event\_types: Filter by event type(s). Common values: 'Promotion', 'Product Release', 'Special Event', 'Collaboration', 'Restock'. Many other values exist — call without this filter first to discover available types for a company. channels: Filter by marketing channel(s). Options: 'email', 'instagram\_post', 'facebook\_ads', 'sms', 'homepage\_screenshot' page\_size: Results per page (default 25, max 100). Set higher to get more results per call. page: Page number (0-indexed, default 0). Increment to get additional pages of results. 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 per row returned (e.g., page\_size=10 costs up to 10 credits).
>
> Returns: List of promotional events with associated marketing assets and products. Includes has\_more and total\_count for pagination.
>
> #### Input Parameters
>
> **page** `integer`
>
> **channels** `string`
>
> **end\_date** `string`
>
> **page\_size** `integer`
>
> **company\_id** `string` *required*
>
> **start\_date** `string`
>
> **event\_types** `string`
>
> **analysis\_goal** `string`

> [accordion] Get company marketing assets
>
> **Slug:** `PARTICL_MCP_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). Options: 'email', 'instagram\_post', 'facebook\_ads', 'sms', 'homepage\_screenshot'. Defaults to all types. start\_date: Start of date range (ISO format, e.g., '2025-01-01'). Defaults to \~30 days ago. end\_date: End of date range (ISO format, e.g., '2025-01-31'). Defaults to \~2 days ago. page\_size: Results per page (default 25, max 100). Set to 100 to get up to 100 results in one call. page: Page number (0-indexed, default 0). Increment to get additional pages of results. 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 per row returned (e.g., page\_size=25 costs up to 25 credits).
>
> Returns: List of marketing assets with content, engagement metrics, and metadata. Includes has\_more and total\_count for pagination. Assets include product\_ids when available — use these with get\_company\_products to look up sales and revenue data for the featured products.
>
> #### Input Parameters
>
> **page** `integer`
>
> **end\_date** `string`
>
> **page\_size** `integer`
>
> **company\_id** `string` *required*
>
> **start\_date** `string`
>
> **asset\_types** `string`
>
> **analysis\_goal** `string`

> [accordion] Get company marketing stats
>
> **Slug:** `PARTICL_MCP_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\_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.
>
> Returns: total\_assets: total number of marketing assets in the last 30 days assets\_by\_type: dict of asset counts keyed by type (e.g. \{"instagram\_post": 42, "email": 10}) engagement\_metrics: dict of \{avg\_likes, avg\_comments} keyed by type posting\_hours: dict of hour-frequency lists keyed by type estimated\_reach: dict of average follower counts keyed by type (e.g. \{"instagram\_post": 50000.0}) avg\_likes: dict of average likes keyed by type (e.g. \{"instagram\_post": 1200.5}) engagement\_rate: dict of engagement rate percentages keyed by type (e.g. \{"instagram\_post": 4.2}) most\_liked\_post: dict of most liked post details keyed by type
>
> Credits: 1 credit per call (not charged if no data is returned).
>
> #### Input Parameters
>
> **company\_id** `string` *required*
>
> **analysis\_goal** `string`

> [accordion] Get company products
>
> **Slug:** `PARTICL_MCP_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. 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., 'wool', 'recycled'). Searches product tags only, NOT product titles. Use title\_search to search by title. title\_search: Search products by title (e.g., 'tank top', 'winter jacket'). Matches against product display title. brand: Filter by brand name min\_price: Minimum price filter max\_price: Maximum price filter sort\_by: Sort by 'sales\_revenue' (default), 'sales\_volume', 'price', or 'launch\_date' sort\_direction: 'desc' (default) or 'asc' page\_size: Results per page (default 25, max 100). Set to 100 to get up to 100 results in one call. page: Page number (0-indexed, default 0). Increment to get additional pages of results. start\_date: Start of sales data aggregation window (ISO format, e.g., '2025-01-01'). Defaults to \~30 days ago. end\_date: End of sales data aggregation window (ISO format, e.g., '2025-01-31'). Defaults to today. confidence\_threshold: Minimum data confidence score (0-10) for included products. Defaults to 6.0, which filters out products with unreliable sales estimates (e.g., gap-filled or anomalous data). You usually don't need to change this. Lower it (e.g., to 0) only if you're looking for a specific product that isn't appearing in results — it may be hidden due to lower data confidence. Set to 0 to include all products regardless of data quality. 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 per row returned (e.g., page\_size=25 costs up to 25 credits).
>
> Returns: List of products from the specified company with pricing, sales estimates, and metadata. Includes has\_more and total\_count for pagination.
>
> #### Input Parameters
>
> **page** `integer`
>
> **brand** `string`
>
> **keyword** `string`
>
> **sort\_by** `string ("sales_revenue" | "sales_volume" | "price" | "launch_date")`
>
> **end\_date** `string`
>
> **max\_price** `string`
>
> **min\_price** `string`
>
> **page\_size** `integer`
>
> **company\_id** `string` *required*
>
> **start\_date** `string`
>
> **title\_search** `string`
>
> **analysis\_goal** `string`
>
> **sort\_direction** `string ("asc" | "desc")`
>
> **product\_type\_id** `string`
>
> **confidence\_threshold** `string`

> [accordion] Get credit balance
>
> **Slug:** `PARTICL_MCP_GET_CREDIT_BALANCE`
>
> Check your remaining export credits.
>
> Credits: Free — no credits charged.
>
> Returns: Credit balance including total limit, used, and remaining credits

> [accordion] Get marketing asset details
>
> **Slug:** `PARTICL_MCP_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 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 charged if no data is returned).
>
> Returns: Full asset details including content, engagement metrics, metadata, and product\_ids when available. Use product\_ids with get\_company\_products to look up sales and revenue data for the featured products.
>
> #### Input Parameters
>
> **asset\_id** `string` *required*
>
> **company\_id** `string` *required*
>
> **analysis\_goal** `string`

> [accordion] Get market pricing analysis
>
> **Slug:** `PARTICL_MCP_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. 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 charged if no data is returned).
>
> Returns: Pricing summary with average, median, range, and distribution buckets
>
> #### Input Parameters
>
> **keyword** `string`
>
> **end\_date** `string`
>
> **analysis\_goal** `string`
>
> **product\_type\_id** `string`

> [accordion] Get market sales
>
> **Slug:** `PARTICL_MCP_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 type UUID from get\_product\_types. Pass the product\_type\_id value, not the name. keyword: Filter by keyword/tag (e.g., 'sustainable', 'organic') end\_date: End of trailing analysis window (ISO format, e.g., '2025-01-15'). Defaults to \~2 days ago. 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 charged if no data is returned).
>
> Returns: Market sales summary with total revenue/volume and monthly timeseries
>
> #### Input Parameters
>
> **keyword** `string`
>
> **end\_date** `string`
>
> **analysis\_goal** `string`
>
> **product\_type\_id** `string`

> [accordion] Get market top companies
>
> **Slug:** `PARTICL_MCP_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., 'luxury', 'athleisure') end\_date: End of trailing 30-day analysis window (ISO format, e.g., '2025-01-15'). Defaults to \~2 days ago. page: Page number (0-indexed, default 0). Use with page\_size to paginate through results. page\_size: Results per page (default 25, max 100). Set to 100 to get up to 100 results in one call. 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 per row returned (e.g., page\_size=25 costs up to 25 credits).
>
> Returns: List of top companies with revenue and sales volume estimates. Includes has\_more and total\_count for pagination.
>
> #### Input Parameters
>
> **page** `integer`
>
> **keyword** `string`
>
> **end\_date** `string`
>
> **page\_size** `integer`
>
> **analysis\_goal** `string`
>
> **product\_type\_id** `string`

> [accordion] Get market top products
>
> **Slug:** `PARTICL_MCP_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., 'sustainable', 'organic') end\_date: End of trailing 30-day analysis window (ISO format, e.g., '2025-01-15'). Defaults to \~2 days ago. page: Page number (0-indexed, default 0). Use with page\_size to paginate through results. page\_size: Results per page (default 25, max 100). Set to 100 to get up to 100 results in one call. 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 per row returned (e.g., page\_size=25 costs up to 25 credits).
>
> Returns: List of top products with sales estimates, pricing, and product details. Includes has\_more and total\_count for pagination.
>
> #### Input Parameters
>
> **page** `integer`
>
> **keyword** `string`
>
> **end\_date** `string`
>
> **page\_size** `integer`
>
> **analysis\_goal** `string`
>
> **product\_type\_id** `string`

> [accordion] Get product breakdown
>
> **Slug:** `PARTICL_MCP_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') - required. Use search\_companies to find this. breakdown\_type: What to break down by. One of: 'keyword', 'material', 'colors', 'brands', 'gender', 'locations'. product\_type\_id: Product type UUID from get\_product\_types to filter by category. keyword: Filter by keyword/tag (e.g., 'sustainable'). Searches product tags only. start\_date: Start of date range (ISO format, e.g., '2025-01-01'). Defaults to \~30 days ago. end\_date: End of date range (ISO format, e.g., '2025-01-31'). Defaults to today. confidence\_threshold: Minimum data confidence score (0-10) for included products. Defaults to 6.0, which filters out products with unreliable sales estimates (e.g., gap-filled or anomalous data). You usually don't need to change this. Lower it (e.g., to 0) only if you're looking for a specific product that isn't appearing in results — it may be hidden due to lower data confidence. Set to 0 to include all products regardless of data quality. 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 per row returned.
>
> Returns: List of breakdown buckets with name, count, sales\_revenue, sales\_volume, and pricing
>
> #### Input Parameters
>
> **keyword** `string`
>
> **end\_date** `string`
>
> **company\_id** `string` *required*
>
> **start\_date** `string`
>
> **analysis\_goal** `string`
>
> **breakdown\_type** `string ("keyword" | "material" | "colors" | "brands" | "gender" | "locations")` *required*
>
> **product\_type\_id** `string`
>
> **confidence\_threshold** `string`

> [accordion] Get product details
>
> **Slug:** `PARTICL_MCP_GET_PRODUCT_DETAILS`
>
> Get full details for a specific product.
>
> Returns comprehensive product information including pricing, brand, gender, ratings, reviews, images, materials, keywords, and category data. Use get\_company\_products first to find product\_ids.
>
> Args: company\_id: The Particl company ID (e.g., '1234567') - required product\_id: The product ID - required. Get this from get\_company\_products or get\_market\_top\_products. 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 charged if no data is returned).
>
> Returns: Full product profile with metadata, ratings, and attributes
>
> #### Input Parameters
>
> **company\_id** `string` *required*
>
> **product\_id** `string` *required*
>
> **analysis\_goal** `string`

> [accordion] Get product types
>
> **Slug:** `PARTICL_MCP_GET_PRODUCT_TYPES`
>
> Browse the product type taxonomy to discover valid categories for filtering.
>
> Use the returned product\_type\_id values in other tools' product\_type\_id parameter.
>
> How to use:
>
> 1. Call with no parameters to get root-level categories
> 2. Pass a product\_type\_id as parent\_product\_type\_id to see its subcategories
> 3. Keep drilling deeper until you find the right category
> 4. Use the chosen product\_type\_id as the product\_type\_id filter in other tools
>
> Args: parent\_product\_type\_id: Get child categories under this product type. Omit to get root-level categories.
>
> Credits: Free — no credits charged.
>
> Returns: List of product type categories with product\_type\_id and name
>
> #### Input Parameters
>
> **parent\_product\_type\_id** `string`

> [accordion] Get product variants
>
> **Slug:** `PARTICL_MCP_GET_PRODUCT_VARIANTS`
>
> Get variant-level data for a specific product (colors, sizes, individual pricing and sales). Use get\_company\_products first to find product\_ids.
>
> Args: company\_id: The Particl company ID (e.g., '1234567') - required product\_id: The product ID - required. Get this from get\_company\_products or get\_market\_top\_products. start\_date: Start of sales data window (ISO format, e.g., '2025-01-01'). Defaults to \~30 days ago. end\_date: End of sales data window (ISO format, e.g., '2025-01-31'). Defaults to today. 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 per row returned.
>
> Returns: List of product variants with color, size, pricing, and sales data
>
> #### Input Parameters
>
> **end\_date** `string`
>
> **company\_id** `string` *required*
>
> **product\_id** `string` *required*
>
> **start\_date** `string`
>
> **analysis\_goal** `string`

> [accordion] Get sales timeseries
>
> **Slug:** `PARTICL_MCP_GET_SALES_TIMESERIES`
>
> Get historical sales timeseries data for a company or a single product.
>
> Returns daily, weekly, or monthly sales data points showing revenue, volume, pricing, and inventory over time. Essential for understanding trends, seasonality, and growth. Pass product\_id to get timeseries for a single product, or omit for company-wide data.
>
> Args: company\_id: The Particl company ID (e.g., '1234567') - required. Use search\_companies to find this. product\_id: Optional product ID to get timeseries for a single product. Get this from get\_company\_products or get\_market\_top\_products. product\_type\_id: Product type UUID from get\_product\_types to filter by category. keyword: Filter by keyword/tag (e.g., 'sustainable', 'organic'). Searches product tags only. start\_date: Start of date range (ISO format, e.g., '2025-01-01'). Defaults to \~30 days ago. end\_date: End of date range (ISO format, e.g., '2025-01-31'). Defaults to today. aggregation\_type: Time granularity - 'daily', 'weekly', or 'monthly'. Auto-selected if omitted. confidence\_threshold: Minimum data confidence score (0-10) for included products. Defaults to 6.0, which filters out products with unreliable sales estimates (e.g., gap-filled or anomalous data). You usually don't need to change this. Lower it (e.g., to 0) only if you're looking for a specific product that isn't appearing in results — it may be hidden due to lower data confidence. Set to 0 to include all products regardless of data quality. 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 per data point returned.
>
> Returns: Timeseries data points with sales\_revenue, sales\_volume, avg\_current\_price, and totals
>
> #### Input Parameters
>
> **keyword** `string`
>
> **end\_date** `string`
>
> **company\_id** `string` *required*
>
> **product\_id** `string`
>
> **start\_date** `string`
>
> **analysis\_goal** `string`
>
> **product\_type\_id** `string`
>
> **aggregation\_type** `string`
>
> **confidence\_threshold** `string`

> [accordion] Get started
>
> **Slug:** `PARTICL_MCP_GET_STARTED`
>
> Return first-session guidance, sample prompts, and follow-up ideas for new Particl MCP users.
>
> Call this when the user is new, asks what they can do with Particl, or seems unsure how to start. Credits: Free — no credits charged.
>
> Returns: is\_first\_time, welcome\_message, sample\_prompts, suggested\_follow\_ups, tracked\_competitors, and assistant\_guidance for presenting options in plain English.

> [accordion] Search companies
>
> **Slug:** `PARTICL_MCP_SEARCH_COMPANIES`
>
> Search for companies by name or domain. Supports pagination.
>
> Args: search: Search term (company name or domain) page\_size: Results per page (default 25, max 100). Set higher to get more results per call. page: Page number (0-indexed, default 0). Increment to get additional pages of results. sort\_by: Sort results by 'popularity' (default) or 'start\_date' country\_code: Filter by country code (default 'US'). Common values: 'US', 'CA', 'AU', 'GB'. Pass empty string to search all countries. 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: Free — no credits charged.
>
> Returns: List of matching companies with their basic info. Includes has\_more and total\_count for pagination.
>
> #### Input Parameters
>
> **page** `integer`
>
> **search** `string` *required*
>
> **sort\_by** `string ("popularity" | "start_date")`
>
> **page\_size** `integer`
>
> **country\_code** `string`
>
> **analysis\_goal** `string`
