# Research Market Source: https://docs.launchfastlegacyx.com/mcp/research/research-market Research an Amazon market that is not in the Launch Fast catalog, or refresh a market with old data. Use Claude, ChatGPT, or another AI app. | Field | Value | | ----------------- | ------------------------------------------------------------------------------------------- | | MCP tool | `research_market` | | Behavior | Starts research work. It does not change your Amazon account. | | Cost | 1 credit. Free when the market has fresh data, or when the same research runs at that time. | | Permission | **Research and insights** (Launch Fast tools) | | Amazon connection | Not necessary | | App view | `ui://launchfast/v2/market` | ## What It Does `research_market` starts research on one Amazon market. It does one of three things: * If you give a phrase for a market that is not in the catalog, it researches a new market. * If you give the slug of a market that you can see, it refreshes the data of that market. * If you give a phrase for a market that is already in the catalog, it opens that market. It also refreshes the data when the last research or refresh is more than 7 days old. A new market takes 4 to 9 minutes. The tool waits up to 40 seconds. If the research does not finish in that time, the answer gives a job id. The assistant then checks the job with [`get_job`](https://docs.launchfastlegacyx.com/mcp/research/get-job). ## When To Use It Use `research_market` only when [`find_markets`](https://docs.launchfastlegacyx.com/mcp/research/find-markets) finds no market, or when the market data is too old. To read a market that is in the catalog, use [`get_market`](https://docs.launchfastlegacyx.com/mcp/research/get-market). It is free. ## Inputs | Input | Required | Values | Example | | -------- | -------- | ----------------------------------------------------------------------------------- | ------------------ | | `market` | Yes | A phrase for a new market, or the slug of a market to refresh. 2 to 120 characters. | `silicone spatula` | ## What The Answer Contains * When the research finishes in 40 seconds, the answer is the market brief. It is the same brief that `get_market` gives. * A notice says if the call spent 1 credit, or if it was free because you joined a research of this market that was already running. * When the research takes longer, the answer shows that the job runs, how long it takes as usual, and the job id. The next call is `get_job` with that job id, about 60 seconds later. If you joined a research of this market that someone else started, the answer says to call `research_market` again instead. * When the market has fresh data, the answer is the brief, free of charge. For a slug, it also gives the date of the data and the first date for a new refresh. * When a phrase names a market that is in the catalog but the refresh cannot start, for example because you have no credits left, the answer is still the brief. A notice says the data may be out of date. * If the research fails, the answer shows the failed job. ## Limits | Limit | Value | | ---------------------------------------------------------------------------- | ------------------ | | New market researches that run at the same time (ones you started or joined) | 3 | | Market runs in 24 hours (new markets and refreshes together) | 30 | | Refresh of one market | One time in 7 days | | Marketplace | Amazon US | ## App View When the research finishes and your AI app supports MCP Apps, it shows the result in this view. The image shows example data. ![Launch Fast market view with example data for a silicone spatulas market: revenue, monthly units, search volume, price, reviews, and the top products](https://docs.launchfastlegacyx.com/mcp/v2/market.png) ## Example Prompts ```text Launch Fast has no market for bamboo cutting boards. Research it. ``` ```text The silicone spatulas data looks old. Refresh that market. ``` ## Common Errors | Error | What it means | What to do | | ----------------- | --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | | `credit_limit` | You used all your credits for this billing period. | See credits used and left on the [usage page](https://launchfastlegacyx.com/settings/usage). Catalog reads stay free. | | `daily_cap` | You started 30 market runs (new markets and refreshes) in the last 24 hours. | Start more tomorrow. Reads of catalog markets are free now. | | `cap_reached` | 3 new market researches that you started or joined run at this time. | Wait for one to finish. To see your jobs, use [`get_job`](https://docs.launchfastlegacyx.com/mcp/research/get-job) with no job id. | | `plan_required` | Your plan does not include market research. | Check your plan on the [usage page](https://launchfastlegacyx.com/settings/usage). | | `invalid_input` | The `market` value is shorter than 2 or longer than 120 characters, or has no words. | Give a phrase such as `silicone spatula`, or a market slug. | | `upstream_failed` | Launch Fast could not complete the request, or market research is not available at this time. | Try the same call again in a minute. | ## Related Tools * [`get_job`](https://docs.launchfastlegacyx.com/mcp/research/get-job) checks a research that takes more than 40 seconds. * [`get_market`](https://docs.launchfastlegacyx.com/mcp/research/get-market) reads the market when the research finishes. * [`find_markets`](https://docs.launchfastlegacyx.com/mcp/research/find-markets) searches the catalog first.