Skip to content
Back to search

tg-market-mcp

Official Remote MCP Server & REST API v2 guide for TG-Market (@TgMarketX_BOT) — Telegram NFT Gift Rentals, TON Vault, Stars, Premium & TON Top-Ups.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ashqalsmt--tg-market-mcp/badge.svg)](/listings/ashqalsmt--tg-market-mcp)

HTML

<a href="/listings/ashqalsmt--tg-market-mcp"><img src="/api/listings/ashqalsmt--tg-market-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 127 lines
  1. # tg-market-mcp
  2. Official Remote MCP Server &amp; REST API v2 guide for TG-Market (@TgMarketX_BOT) — Telegram NFT Gift Rentals, TON Vault, Stars, Premium &amp; TON Top-Ups.
  3. # TG-Market — Telegram NFT Gifts, TON Rental Vault, Stars/Premium REST API v2 & Remote MCP Server
  4. [](https://tg-market.store/)
  5. [](https://t.me/TgMarketX_BOT)
  6. [](https://mcp.tg-market.store/mcp)
  7. [](https://tg-market.store/en/api-docs)
  8. Official developer reference, code examples, and Remote Model Context Protocol (MCP) connection guide for **[TG-Market (`@TgMarketX_BOT`)](https://tg-market.store/)** — the automated Telegram Mini-App and marketplace for:
  9. - **Upgraded Telegram NFT Collectible Gifts**: Buy, sell, rent by the day (with One-Tap Auto-Link or `Fragment tc://` display-only binding), and **Sub-Lease** active rentals (`100%` daily net + `+$0.15` recurring bonus).
  10. - **TON Wallet Rental Vault (`TON Connect 2.0`)**: Deposit on-chain `TEP-62` Telegram NFT gifts into isolated sub-vault addresses with automatic on-chain sub-address rotation upon lease expiry and 24/7 withdrawal (`$0.10` fee).
  11. - **Instant Telegram Services**: Telegram Stars (min 50 Stars), Telegram Premium (3 / 6 / 12 months), TON coin top-ups, and Channel Boosts with live `@username` profile verification and 10-tier cashback up to `2%` (`8%` max combined reduction).
  12. - **Custody & Security Guarantees**: 1:1 USDT full-reserve backing, atomic escrow with `<60s` automatic failed-order refunds, and a binding 100% make-whole compensation policy documented in the [Security & Transparency Center](https://tg-market.store/en/security).
  13. ---
  14. ## 1. Connect AI Agents via Official Remote MCP Server
  15. Connect Claude Code, Cursor, Claude Desktop, Windsurf, VS Code, or OpenAI agents directly to TG-Market's live pricing, rentable gift catalog, and authenticated order endpoints.
  16. - **Streamable HTTP Endpoint**: `https://mcp.tg-market.store/mcp`
  17. - **Legacy SSE Endpoint**: `https://mcp.tg-market.store/sse`
  18. - **Discovery Manifest**: `https://tg-market.store/.well-known/mcp.json`
  19. - **AI Documentation (`llms.txt`)**: `https://tg-market.store/llms.txt`
  20. > **Public vs. Private Mode**: Without an API key, agents can read full documentation, live Stars/Premium/TON prices, cashback tiers, and the rentable gift catalog. Pass your personal `X-API-Key` header only when checking balances or executing live orders.
  21. ### Claude Code (CLI)
  22. ```bash
  23. # Public mode (prices, gift catalog, docs)
  24. claude mcp add --transport http tg-market https://mcp.tg-market.store/mcp
  25. # Authenticated mode (balance & live orders)
  26. claude mcp add --transport http tg-market https://mcp.tg-market.store/mcp \
  27. --header "X-API-Key: YOUR_API_KEY"
  28. ```
  29. ### Cursor (`.cursor/mcp.json`) / VS Code (`.vscode/mcp.json`)
  30. ```json
  31. {
  32. "mcpServers": {
  33. "tg-market": {
  34. "url": "https://mcp.tg-market.store/mcp",
  35. "headers": {
  36. "X-API-Key": "YOUR_API_KEY"
  37. }
  38. }
  39. }
  40. }
  41. ```
  42. ### Example Prompt After Connecting
  43. > *"Show me current Telegram Stars and Telegram Premium prices on TG-Market, and list the lowest-priced upgraded Telegram gifts available to rent for 3 days."*
  44. ---
  45. ## 2. REST API v2 Quickstart
  46. - **Base URL**: `https://tg-market.store/api/v2/`
  47. - **Authentication Header**: `X-API-Key: <your_key>`
  48. - **Replay Protection**: `Idempotency-Key: <unique-uuid>` on mutating `POST` requests
  49. - **Full Interactive Reference & Sandbox**: [English Docs](https://tg-market.store/en/api-docs) | [الوثائق بالعربية](https://tg-market.store/ar/api-docs)
  50. ### Public Verification Endpoints (No API Key Required)
  51. ```bash
  52. # Live rentable upgraded Telegram NFT gifts & daily USDT rates
  53. curl -s https://tg-market.store/api/v2/rent/gifts
  54. # Verified Telegram gift collections & metadata
  55. curl -s https://tg-market.store/api/v2/gifts/collections
  56. # Real-time Telegram Stars, Premium, and TON prices
  57. curl -s https://tg-market.store/api/v2/prices/stars
  58. curl -s https://tg-market.store/api/v2/prices/premium
  59. curl -s https://tg-market.store/api/v2/prices/ton
  60. # Live 10-tier cashback schedule
  61. curl -s https://tg-market.store/api/cashback-info
  62. ```
  63. ### Python Example — Buy Telegram Stars
  64. ```python
  65. import uuid
  66. import requests
  67. API_BASE = "https://tg-market.store/api/v2"
  68. HEADERS = {
  69. "X-API-Key": "YOUR_API_KEY",
  70. "Idempotency-Key": str(uuid.uuid4()),
  71. "Content-Type": "application/json",
  72. }
  73. resp = requests.post(
  74. f"{API_BASE}/stars/buy",
  75. headers=HEADERS,
  76. json={"username": "recipient_username", "quantity": 100},
  77. timeout=20,
  78. )
  79. print(resp.status_code, resp.json())
  80. ```
  81. ---
  82. ## 3. Verified Fee & Policy Summary
  83. | Parameter | Verified Specification |
  84. | :--- | :--- |
  85. | **TON Vault NFT Withdrawal Fee** | `$0.10` (24/7 whenever unrented) |
  86. | **Telegram Upgraded Gift Withdrawal Fee** | `$0.40` (from My Inventory) |
  87. | **Sub-Lease Contract Fee** | `$0.20` (`$0.05` platform + `$0.15` recurring seller bonus) |
  88. | **Failed Order Escrow Refund** | Automated in `< 60 seconds` (100% USDT rollback) |
  89. | **Cashback Program** | 10-tier cashback up to `2%` (`8%` max combined reduction) |
  90. | **Supported Payment Methods** | TON Connect, Binance Pay, Jaib, Cryptomus, ShamCash, Vodafone Cash |
  91. ---
  92. ## 4. Official Verified Links
  93. - **Official Website**: [https://tg-market.store/](https://tg-market.store/) (AR) | [https://tg-market.store/en](https://tg-market.store/en) (EN)
  94. - **Telegram Bot & Mini-App**: [https://t.me/TgMarketX_BOT](https://t.me/TgMarketX_BOT)
  95. - **Security & Custody Center**: [https://tg-market.store/en/security](https://tg-market.store/en/security)
  96. - **Terms of Service (12 Articles)**: [https://tg-market.store/en/terms](https://tg-market.store/en/terms)
  97. - **Official Announcements**: [https://t.me/TG_MARKET_X](https://t.me/TG_MARKET_X)
  98. - **Support & Dispute SLA Desk**: [https://t.me/T_A_Tl](https://t.me/T_A_Tl) · `support@tgmarketx.com`
  99. - **X (Twitter)**: [@TGMarketX](https://x.com/TGMarketX) · **Instagram**: [@tgmarket.bot](https://www.instagram.com/tgmarket.bot)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.