Sorftime MCP

Sorftime MCP

Operate Sorftime MCP through your OOMOL-connected account. This skill calls the sorftime_mcp connector with the oo CLI; OOMOL injects credentials server-side, so you never handle raw tokens.

Running an action

Assume the user has already installed the oo CLI, signed in, and connected Sorftime MCP. Do not run oo auth login or open the connection URL proactively — just run the action. Fall back to First-time setup only when a command actually fails with an auth or connection error.

1. Inspect the contract to get the authoritative input/output schema before building a payload:

oo connector schema "sorftime_mcp" --action ""

2. Run the action with a JSON payload that matches the input schema:

oo connector run "sorftime_mcp" --action "" --data '' --json

• --data takes a JSON object string or @path/to/file.json; omit it to send {}.
• The response is { "data": ..., "meta": { "executionId": "..." } }; the execution id lives under meta.executionId.

Each action is listed below with a one-line description; actions that change state carry a [write] or [destructive] tag. Before constructing --data, fetch the action's live schema with oo connector schema to get its authoritative input fields.

Available actions

• ali1688_get_product — Inspect one 1688 product using its ID from ali1688_search_products.
• ali1688_list_categories — Browse 1688 categories. Omit parentId for the top levels, then pass a returned category ID to explore its children.
• ali1688_search_products — Search 1688 products by name to find sourcing suppliers and procurement prices.
• amazon_find_related_keywords — Expand an Amazon keyword into related and long-tail search terms.
• amazon_get_category_report — Research an Amazon category market using a category ID from amazon_list_categories.
• amazon_get_keyword — Inspect demand for a specific Amazon keyword.
• amazon_get_product — Inspect one Amazon product using its ID from amazon_search_products.
• amazon_get_product_trend — Inspect historical Amazon product performance. Select one metric.
• amazon_list_categories — Browse Amazon categories. Omit parentId for the top levels, then pass a returned category ID to explore its children.
• amazon_list_keywords — Discover Amazon keywords ranked by weekly search volume. Supports optional rank and search-volume bounds.
• amazon_search_products — Find Amazon products by name.
• call_tool — Run a tool from list_tools with its required arguments. Supports research queries and changes to favorites, including deletion. Credit cost depends on the tool.
• list_tools — List all tools available to your Sorftime MCP account with their descriptions and argument schemas.
• shopee_get_product — Inspect one Shopee product using its ID from shopee_search_products.
• shopee_get_product_trend — Inspect historical Shopee product performance. Returns available dimensions together. Ranges beyond one year cost 10 credits.
• shopee_list_categories — Browse Shopee categories. Omit parentId for the top levels, then pass a returned category ID to explore its children.
• shopee_list_category_products — Find best-selling products in a Shopee category. Optionally query historical natural-week snapshots for leaf categories.
• shopee_list_keywords — Discover Shopee keywords ranked by monthly search volume. Supports optional rank and search-volume bounds.
• shopee_search_products — Find Shopee products by name.
• temu_get_product — Inspect one Temu product using its ID from temu_search_products.
• temu_get_product_trend — Inspect historical Temu product performance. Returns available dimensions together. Ranges beyond one year cost 10 credits.
• temu_list_categories — Browse Temu categories. Omit parentId for the top levels, then pass a returned category ID to explore its children.
• temu_list_category_products — Find best-selling products in a Temu category.
• temu_search_products — Find Temu products by name.
• tiktok_get_category_report — Research a TikTok category market using a category ID from tiktok_list_categories.
• tiktok_get_product — Inspect one TikTok product using its ID from tiktok_search_products.
• tiktok_get_product_trend — Inspect historical TikTok product performance. Returns available dimensions together.
• tiktok_list_categories — Browse TikTok categories. Omit parentId for the top levels, then pass a returned category ID to explore its children.
• tiktok_search_products — Find TikTok products by name.
• walmart_find_related_keywords — Expand a Walmart US keyword into related and long-tail search terms.
• walmart_get_category_report — Research a Walmart US category market using a category ID from walmart_list_categories.
• walmart_get_keyword — Inspect demand for a specific Walmart US keyword.
• walmart_get_product — Inspect one Walmart US product using its ID from walmart_search_products.
• walmart_get_product_trend — Inspect historical Walmart US product performance. Select one metric.
• walmart_list_categories — Browse Walmart US categories. Omit parentId for the top levels, then pass a returned category ID to explore its children.
• walmart_list_keywords — Discover Walmart US keywords ranked by monthly search volume. Requires minRank and maxRank.
• walmart_search_products — Find Walmart US products by name.

Safety

• Untagged actions are reads (get / list / search) — safe to run directly.
• Actions tagged [write] change Sorftime MCP state — confirm the exact payload and effect with the user before running.
• Actions tagged [destructive] remove or overwrite data — always confirm the target and get explicit approval first.

First-time setup

These are one-time steps — do not repeat them on every call. Run a step only when a command fails for the matching reason.

• oo: command not found — install the oo CLI (other platforms: ):

  curl -fsSL https://cli.oomol.com/install.sh | bash    # macOS / Linux
  

  irm https://cli.oomol.com/install.ps1 | iex           # Windows PowerShell
  

• Not signed in / authentication error — sign in to your OOMOL account once:

  oo auth login
  

• scope_missing / credential_expired / app_not_ready / app_not_found — Sorftime MCP is not connected, or the connection expired or lacks a scope. Connect once (auth type: API key) at:

  https://console.oomol.com/app-connections?provider=sorftime_mcp
  

• HTTP 402 / OOMOL_INSUFFICIENT_CREDIT — billing stop. Recharge at https://console.oomol.com/billing/token-recharge before retrying.

Resources

• Sorftime MCP homepage: https://www.sorftime.com/