mcp

actor_tgju-price-scraper

Barchin actor 'tgju-price-scraper' (finance). اسلاگ ابزار یا یک دسته‌ی کامل را بدهید تا نرخ لحظه‌ای طلا، سکه، ارز، رمزارز، نفت و فلزات را از TGJU بگیرید: نرخ، تغییر، درصد تغییر، بیشترین و کمترین روز و زمان به‌روزرسانی (میلادی و شمسی). با includeHistory تاریخچه‌ی روزانه هم برمی‌گردد. واحد نرخ از روی خود ابزار تعیین می‌شود — ابزارهای ایرانی ریال‌… Base fee 2 credit(s) plus the proxy tier price per fetched page (datacenter 1, residential 15, unblocker 25, +5 with JavaScript). Call list_actors for the full input schema.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "actor_tgju-price-scraper"
  }
}

Input Schema

Name	Required	Description
`dateTo`	No	فقط با «شامل تاریخچه»: ردیف‌های روزانه تا این تاریخ. شمسی یا میلادی.
`dateFrom`	No	فقط با «شامل تاریخچه»: ردیف‌های روزانه از این تاریخ. شمسی (۱۴۰۴/۰۷/۰۱) یا میلادی (2025-09-23)؛ خودکار تشخیص داده می‌شود.
`maxItems`	No	سقف ردیف‌های خروجی این اجرا. هر چه بیشتر، صفحات بیشتری باز و کردیت بیشتری کسر می‌شود؛ برآورد هزینه را زیر فرم ببینید. حداکثر 1000.
`categories`	No	به‌جای نام بردن تک‌تک ابزارها، همه‌ی ابزارهای یک دسته را بگیرید: gold (طلا)، coin (سکه)، currency (ارز)، crypto (رمزارز)، oil (نفت)، metals (فلزات) یا stock_index (شاخص بورس). تا سقف «حداکثر تعداد ردیف» پر می‌شود. این تشخیص فقط حدود ۲۱۳ از ۹۶۳ ابزار فید TGJU را می‌پوشاند؛ برای بقیه اسلاگ دقیق را در «ابزارها» بدهید.
`instruments`	No	اسلاگ صفحه‌ی ابزار در TGJU — همان بخش آخر آدرس tgju.org/profile/…؛ مثل geram18 (طلای ۱۸ عیار)، sekee (سکه‌ی امامی) یا price_dollar_rl (دلار). حداکثر 100 مورد. یا به‌جای نام بردن، یک «دسته» را بدهید. اسلاگی که در فهرست TGJU نباشد صفر ردیف نمی‌گیرد؛ یک ردیف itemType=notFound برایش برمی‌گردد.
`includeNames`	No	ستون‌های nameFa/nameEn را پر می‌کند — فقط برای طلا، سکه و ارز ایرانی (فید زنده‌ی TGJU هیچ فیلد نامی ندارد؛ این‌ها از فهرست دسته‌بندی سایت خزیده می‌شوند). رمزارز، نفت، فلزات، ارز جهانی و شاخص بورس پوشش داده نمی‌شوند و همچنان null می‌مانند. هزینه‌ی این خزش یک‌باره (حداکثر 15 درخواست) ثابت است، نه به‌ازای ابزار — و روی هر پردازه‌ی کارگر فقط یک‌بار انجام و برای اجراهای بعدی همان پردازه کش می‌شود.
`includeHistory`	No	تاریخچه‌ی روزانه‌ی هر ابزار را هم برمی‌گرداند (ردیف‌هایی با itemType=history). برای هر ابزار یک صفحه‌ی اضافه باز می‌کند؛ وقتی فقط «دسته» داده باشید، حداکثر برای 100 ابزار. با چند ابزار هم‌زمان، سقف «حداکثر تعداد ردیف» به‌طور مساوی بین ابزارها تقسیم می‌شود؛ اگر سهم یک ابزار از تاریخچه‌ی واقعی‌اش کمتر بود، ردیف‌های آن ابزار truncated=true می‌گیرند.
`includeOpenPrice`	No	ستون open را در ردیف‌های price با نرخ واقعی بازگشایی امروز پر می‌کند — از لیست نوسان‌های لحظه‌ای TGJU (نه فید زنده که این عدد را ندارد). با هزینه‌ی دو درخواست اضافه به‌ازای هر ابزار (همان قاعده‌ی شمارش ابزار «شامل تاریخچه»: ابزارهای نام‌برده‌شده، یا وقتی فقط «دسته» داده شده تا سقف 100 ابزار).

Schema Changelog

Changes observed during successful MCP inspections.

First observedOct 6, 2026

TDQS

A3.8/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden and does disclose non-obvious behavior: a base fee of 2 credits plus per-page proxy tier pricing (datacenter 1, residential 15, unblocker 25, +5 with JavaScript), that the currency unit is derived from the tool itself, and that invalid slugs yield an itemType=notFound row rather than failing. It omits auth requirements and rate limits, but the cost/effect disclosure is substantive.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

It is front-loaded with the purpose and reasonably dense, but the English/Persian mixing, the truncated trailing ellipsis, and the redundant 'Call list_actors for the full input schema' instruction (the schema is already present) add noise without earning their place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an 8-parameter tool with no output schema, the description covers what is returned (field list, both calendar formats), the history/category behavior, and the cost model, which is close to what an agent needs. It could say more about the returned row structure (itemType variants), but is largely complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all 8 parameters in detail (including includeHistory's truncation rule and includeNames' crawl cost). The description adds only the includeHistory hint, so baseline 3 applies with little extra meaning contributed.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource: it fetches live prices for gold, coin, currency, crypto, oil and metals from TGJU, and even enumerates the returned fields (rate, change, percent change, daily high/low, update time in both calendars). This clearly distinguishes it from the sibling scrapers (codal, digikala, divar, tsetmc, etc.), which pull from entirely different sources.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It hints at how to drive the tool ('give a tool slug or a whole category', and use includeHistory for daily history), but never states when to choose this actor over a sibling or any precondition/exclusion. Usage is implied rather than spelled out.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All mcp tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.