# TGJU Prices (pypi · tgju-mcp)

Unofficial read-only TGJU: live Iranian gold, coin, currency and crypto prices with daily history.

- Trust score: 65/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-22

## Components

- pypi · `tgju-mcp`: 65/100 (this document), [markdown](https://verifymcp.io/servers/sepehr071-tgju-mcp/tgju-mcp.md), [page](https://verifymcp.io/servers/sepehr071-tgju-mcp/tgju-mcp)

## Channel facts

- Registry: `pypi`
- Package: `tgju-mcp`
- Version: `0.1.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-10-22.

- **Supply Chain Security**: 50/100
  - Malware scan not yet available for this package.
  - No known CVEs affecting this package version or its production dependencies.
  - Runs hatchling.build at install time, a recognised build step with no custom scripting around it.
  - 1 of 35 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to sepehr071/tgju-mcp).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 0 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 65/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1341 tokens (~223/item across 6 items; 6 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 7/100
  - Stability observed for 2 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 6 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 7 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the TGJU Prices MCP server?

TGJU Prices runs locally as a PyPI package, launched with uvx tgju-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add sepehr071-tgju-mcp -- uvx tgju-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "sepehr071-tgju-mcp": {
      "command": "uvx",
      "args": [
        "tgju-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "sepehr071-tgju-mcp": {
      "command": "uvx",
      "args": [
        "tgju-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add sepehr071-tgju-mcp -- uvx tgju-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sepehr071-tgju-mcp": {
      "type": "local",
      "command": [
        "uvx",
        "tgju-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add sepehr071-tgju-mcp --command uvx --arg tgju-mcp
```

### Hermes

```yaml
mcp_servers:
  sepehr071-tgju-mcp:
    command: "uvx"
    args: ["tgju-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "sepehr071-tgju-mcp": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "tgju-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add sepehr071-tgju-mcp -t stdio -c uvx -a tgju-mcp
```

### Other

```json
{
  "mcpServers": {
    "sepehr071-tgju-mcp": {
      "command": "uvx",
      "args": [
        "tgju-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-22 (score 65, −14)

- [security regression] Malware scan: pass → unverified
- [functional improvement] Stability: unverified → 0.07
- [functional] Package version: 0.1.0 → 0.1.1

### 2026-10-21 (score 79, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-10-20 (score 64)

First indexed and scored.

## MCP tools (6)

### `tj_search_symbols` (~153 tokens)

Search symbols

Find TGJU symbols by name.

Use when you do not know the symbol slug; pass a result's `symbol` to tj_get_prices or tj_price_history.
Main symbols come back as their short live symbol; the rest as a slug, which tj_get_prices answers from
the latest daily history row (`source: history`).

Input parameters:

- `limit` (integer): Max matches (the site returns at most 10).
- `query` (string, required): Name or code, Persian or English, e.g. 'سکه امامی', 'bitcoin', 'brent'.
- `scope` (string): internal = Iranian markets (gold, coins, currencies, funds), global = world markets and pairs, crypto = coins.

### `tj_list_categories` (~159 tokens)

Browse categories

Browse TGJU's market tree: folders (with ids) and symbols.

Use to discover a group; call tj_category_table with a folder id to get its prices, or pass a symbol
from a 'link' item to tj_get_prices. Top level: 28064 gold, 28066 coin, 28069 currency, 28426 crypto,
28048 precious metals, 28049 oil and energy, 28042 commodities.

Input parameters:

- `limit` (integer): Max items.
- `offset` (integer): Items to skip (big folders such as crypto have thousands).
- `parent_id`: Folder id to open, e.g. '28064' (gold market) or 'currencies'. Omit for the top level.

### `tj_category_table` (~230 tokens)

Category price table

Live price table of one TGJU group: price, change, day high/low/open per symbol.

Use for 'all gold prices', 'all coin prices', 'all currency rates'. Rial groups carry `price_toman`
(Rial / 10); crypto is USD. A folder id gets the unit per row from the symbol-name rule (`unit: mixed`
adds a `unit` to each row); unknown symbols, e.g. exchange-house quotes, stay `as_listed`. `stale` marks
a quote older than 2 days. The crypto preset lists all
\~27,000 coins in no useful order: use tj_get_prices for major coins and tj_search_symbols for the rest.

Input parameters:

- `category` (string, required): Preset (gold, coin, coin_retail, currency, currency_government, currency_sana, currency_nima, crypto) or a folder id from tj_list_categories, e.g. '28070'.
- `limit` (integer): Max rows (50 keeps the reply under 15 KB).
- `offset` (integer): Rows to skip.

### `tj_get_prices` (~157 tokens)

Live prices

Live price, day change, high and low for one or more TGJU symbols.

Use for current rates. Rial symbols also carry `*_toman`. `time` is the last update (Tehran time);
old values mean the market is closed; `stale: true` marks a quote older than 2 days. Symbols missing
from the live feed (slugs from tj_search_symbols) answer with their latest daily close (`source: history`,
\`time` = date). Unknown symbols are listed in `not_found`: find them with tj_search_symbols.

Input parameters:

- `symbols` (array, required): Symbol slugs, e.g. ['price_dollar_rl', 'geram18', 'sekee', 'crypto-bitcoin'].

### `tj_market_summary` (~85 tokens)

Key rates summary

Key Iranian market rates in one call: dollar, euro, dirham, pound, lira, gold gram and ounce, coins, silver, Brent, Bitcoin, Ethereum, Tether.

Use first for 'what are today's rates'. Rial values carry `*_toman`; ounce, Brent, Bitcoin USD and
Ethereum are USD. Drill into a group with tj_category_table.

### `tj_price_history` (~212 tokens)

Price history

Daily history (open, low, high, close, change) of a TGJU symbol, for charts and trend questions.

Use after tj_get_prices. Each row has Gregorian `date` and Jalali `jalali`; Rial symbols also carry
\`*_toman`. Days without a quote are missing. `total` is the number of rows in range: page with offset.

Input parameters:

- `from_date`: Jalali start date, e.g. '1405/07/01'.
- `limit` (integer): Max daily rows (50 keeps the reply under 15 KB).
- `offset` (integer): Rows to skip (for older pages).
- `oldest_first` (boolean): Sort ascending by date (default newest first).
- `symbol` (string, required): Symbol slug, e.g. 'price_dollar_rl', 'geram18', 'sekee', 'ons', 'crypto-bitcoin'.
- `to_date`: Jalali end date, e.g. '1405/07/10'.

## Diagnostics

Captured diagnostic sections: Provenance, Install scripts, Dependencies. The full working is on the page: https://verifymcp.io/servers/sepehr071-tgju-mcp/tgju-mcp#diagnostics

## Score history

- 2026-10-22: 65
- 2026-10-21: 79
- 2026-10-20: 64

## Common questions

### What is the TGJU Prices MCP server?

TGJU Prices is an MCP server listed in the public MCP registry as io.github.sepehr071/tgju-mcp. Unofficial read-only TGJU: live Iranian gold, coin, currency and crypto prices with daily history. This page covers its PyPI package (tgju-mcp).

### Is the TGJU Prices MCP server safe to use?

TGJU Prices scores 65 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 22 October 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the TGJU Prices MCP server expose?

TGJU Prices exposes 6 tools: tj_search_symbols, tj_list_categories, tj_category_table, tj_get_prices, tj_market_summary, tj_price_history. Their descriptions and schemas cost roughly 996 tokens of context every time the server is loaded.

### Is the TGJU Prices MCP server still maintained?

TGJU Prices is still listed as active in the MCP registry. We last reached this channel on 22 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the TGJU Prices MCP server under?

TGJU Prices declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- PyPI project: https://pypi.org/project/tgju-mcp/
- Socket report: https://socket.dev/pypi/package/tgju-mcp
- Repository: https://github.com/sepehr071/tgju-mcp
- Changelog RSS feed: https://verifymcp.io/servers/sepehr071-tgju-mcp/tgju-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/sepehr071-tgju-mcp/tgju-mcp.json
- HTML version of this page: https://verifymcp.io/servers/sepehr071-tgju-mcp/tgju-mcp