MCP tool reference
Creator MCP
| Tool | Description |
|---|---|
list_my_apps | Paginated listings owned by you |
get_app | Single app metadata |
update_app_draft | Patch short description, description, tags |
submit_listing | Submit for review |
list_communities | Channels and groups |
get_promotion_catalog | Promote slots and quotes |
get_creator_analytics | Views, clicks, referrals |
search_catalog | Public catalog search |
preview_listing_card | MCP App UI preview |
run_batch_operation | Bulk tag updates on drafts (bulk_draft_tags) |
Admin MCP
Server URL: https://tg.app/mcp/admin. Keys are created in Admin Panel → Admin MCP (admin role only).
| Tool | Description |
|---|---|
list_catalog_listings | Paginated admin catalog list |
get_catalog_listing | Single listing by app id |
create_catalog_listing | Add listing from telegramLink (no creator ownership) |
update_catalog_listing | Patch listing fields as admin |
search_catalog | Public catalog search |
list_blog_posts | Blog posts, including drafts |
get_blog_post | One post and its markdown |
upsert_blog_post | Create or update. Default status is draft (not on /blog). Optional coverPath |
host_blog_cover | Upload PNG/JPEG to tg.app (base64 or sourceUrl), returns coverPath |
attach_blog_cover | Attach an existing image URL or site path as the post cover |
generate_blog_cover | 1024x576 cover in the TG clay style |
list_users | Users by role, name, @username, Telegram id, or advertiser email |
get_user | Profile, creator, advertiser, counts, live Telegram profile |
update_user | Role or ban. Cannot change your own role or ban yourself |
get_user_timeline | Payments, catalog, social, advertising, account events |
list_payment_orders | Orders plus status totals |
get_payment_order | Order, deposit intent, recent transactions |
update_payment_order | Status, admin notes, failure reason, external id |
list_payouts | Payout requests |
complete_payout | Mark a payout completed with a tx hash |
list_payment_inquiries | Advertising inquiries |
update_payment_inquiry | Inquiry status or admin notes |
list_payment_transactions | Ledger rows, optional user filter |
list_claims | Listing ownership claims |
review_claim | Approve (transfer the listing) or reject |
Scopes: admin:read, admin:write, admin:catalog, admin:content, admin:users, admin:payments, admin:claims, catalog:read.
A full key includes every admin scope. Existing full keys that only stored admin:read and admin:write can still call users, payments, and claims. A content key (admin:content only) can write blog posts and covers. It cannot change the catalog, users, payments, or claims. Create that key in Admin Panel → Admin MCP and choose Blog only.
Support MCP
| Tool | Description |
|---|---|
list_open_tickets | Inbox list (default: active queue). Filters: status, q, labelId, visitorTelegramUserId, visitorId |
list_tickets | Same as list_open_tickets |
list_inbox_labels | Custom label palette for the key owner agent |
update_inbox_labels | Replace label palette (name + color) |
set_ticket_labels | Apply label ids to a ticket |
get_ticket | Thread + messages |
reply_to_ticket | Agent reply |
update_ticket_status | open, pending_agent, resolved, closed |
suggest_reply | AI draft (plan permitting) |
list_knowledge | KB documents |
upsert_knowledge | Create or update FAQ |
get_support_config | Bot/widget status |
get_support_analytics | Widget metrics |
ticket_inbox | MCP App inbox UI |
kb_editor | MCP App KB preview |
run_batch_operation | Bulk KB import (bulk_kb_upsert) |
Prompts
- Creator:
promote_my_app,optimize_listing - Support:
draft_kb_article,triage_ticket
Resources
tgapp://pricing/promotionstgapp://support/docs/inboxui://creator/listing-previewui://support/ticket-inbox