Back to search
tg-market-mcp
MCP serverGitHub
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
Markdown
[](/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
- # 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.
- # TG-Market — Telegram NFT Gifts, TON Rental Vault, Stars/Premium REST API v2 & Remote MCP Server
- [](https://tg-market.store/)
- [](https://t.me/TgMarketX_BOT)
- [](https://mcp.tg-market.store/mcp)
- [](https://tg-market.store/en/api-docs)
- 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:
- - **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).
- - **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).
- - **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).
- - **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).
- ---
- ## 1. Connect AI Agents via Official Remote MCP Server
- 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.
- - **Streamable HTTP Endpoint**: `https://mcp.tg-market.store/mcp`
- - **Legacy SSE Endpoint**: `https://mcp.tg-market.store/sse`
- - **Discovery Manifest**: `https://tg-market.store/.well-known/mcp.json`
- - **AI Documentation (`llms.txt`)**: `https://tg-market.store/llms.txt`
- > **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.
- ### Claude Code (CLI)
- ```bash
- # Public mode (prices, gift catalog, docs)
- claude mcp add --transport http tg-market https://mcp.tg-market.store/mcp
- # Authenticated mode (balance & live orders)
- claude mcp add --transport http tg-market https://mcp.tg-market.store/mcp \
- --header "X-API-Key: YOUR_API_KEY"
- ```
- ### Cursor (`.cursor/mcp.json`) / VS Code (`.vscode/mcp.json`)
- ```json
- {
- "mcpServers": {
- "tg-market": {
- "url": "https://mcp.tg-market.store/mcp",
- "headers": {
- "X-API-Key": "YOUR_API_KEY"
- }
- }
- }
- }
- ```
- ### Example Prompt After Connecting
- > *"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."*
- ---
- ## 2. REST API v2 Quickstart
- - **Base URL**: `https://tg-market.store/api/v2/`
- - **Authentication Header**: `X-API-Key: <your_key>`
- - **Replay Protection**: `Idempotency-Key: <unique-uuid>` on mutating `POST` requests
- - **Full Interactive Reference & Sandbox**: [English Docs](https://tg-market.store/en/api-docs) | [الوثائق بالعربية](https://tg-market.store/ar/api-docs)
- ### Public Verification Endpoints (No API Key Required)
- ```bash
- # Live rentable upgraded Telegram NFT gifts & daily USDT rates
- curl -s https://tg-market.store/api/v2/rent/gifts
- # Verified Telegram gift collections & metadata
- curl -s https://tg-market.store/api/v2/gifts/collections
- # Real-time Telegram Stars, Premium, and TON prices
- curl -s https://tg-market.store/api/v2/prices/stars
- curl -s https://tg-market.store/api/v2/prices/premium
- curl -s https://tg-market.store/api/v2/prices/ton
- # Live 10-tier cashback schedule
- curl -s https://tg-market.store/api/cashback-info
- ```
- ### Python Example — Buy Telegram Stars
- ```python
- import uuid
- import requests
- API_BASE = "https://tg-market.store/api/v2"
- HEADERS = {
- "X-API-Key": "YOUR_API_KEY",
- "Idempotency-Key": str(uuid.uuid4()),
- "Content-Type": "application/json",
- }
- resp = requests.post(
- f"{API_BASE}/stars/buy",
- headers=HEADERS,
- json={"username": "recipient_username", "quantity": 100},
- timeout=20,
- )
- print(resp.status_code, resp.json())
- ```
- ---
- ## 3. Verified Fee & Policy Summary
- | Parameter | Verified Specification |
- | :--- | :--- |
- | **TON Vault NFT Withdrawal Fee** | `$0.10` (24/7 whenever unrented) |
- | **Telegram Upgraded Gift Withdrawal Fee** | `$0.40` (from My Inventory) |
- | **Sub-Lease Contract Fee** | `$0.20` (`$0.05` platform + `$0.15` recurring seller bonus) |
- | **Failed Order Escrow Refund** | Automated in `< 60 seconds` (100% USDT rollback) |
- | **Cashback Program** | 10-tier cashback up to `2%` (`8%` max combined reduction) |
- | **Supported Payment Methods** | TON Connect, Binance Pay, Jaib, Cryptomus, ShamCash, Vodafone Cash |
- ---
- ## 4. Official Verified Links
- - **Official Website**: [https://tg-market.store/](https://tg-market.store/) (AR) | [https://tg-market.store/en](https://tg-market.store/en) (EN)
- - **Telegram Bot & Mini-App**: [https://t.me/TgMarketX_BOT](https://t.me/TgMarketX_BOT)
- - **Security & Custody Center**: [https://tg-market.store/en/security](https://tg-market.store/en/security)
- - **Terms of Service (12 Articles)**: [https://tg-market.store/en/terms](https://tg-market.store/en/terms)
- - **Official Announcements**: [https://t.me/TG_MARKET_X](https://t.me/TG_MARKET_X)
- - **Support & Dispute SLA Desk**: [https://t.me/T_A_Tl](https://t.me/T_A_Tl) · `support@tgmarketx.com`
- - **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 inFree to use. If it’s helped, pass it on.