gib-fatura-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| gib_loginA | GİB e-Arşiv portala giriş yapar ve oturum tokenı alır. testMode=true ve kullanıcı adı verilmezse otomatik olarak yeni bir test hesabı alınır. Gerçek kullanıcı bilgilerini muhasebecinizden veya GİB İnteraktif Vergi Dairesi'nden edinebilirsiniz. |
| gib_set_tokenB | Daha önce alınmış bir oturum tokenını tanımlar; token süresi dolana kadar login olmadan işlem yapılabilir. |
| gib_logoutA | GİB e-Arşiv portal oturumunu sonlandırır. |
| gib_session_infoA | Mevcut oturum durumunu (token, kullanıcı, test modu) gösterir. |
| gib_create_invoiceA | GİB e-Arşiv portalda e-Fatura taslağı oluşturur (Satış, İade, Tevkifat, İstisna, Özel Matrah). Tutar, iskonto, KDV ve vergi toplamları otomatik hesaplanır. uuid + belgeNumarasi birlikte verilirse portaldaki mevcut belge güncellenir. Belge taslak olarak kaydedilir; imzalanana kadar mali değeri yoktur. |
| gib_create_producer_receiptB | GİB e-Arşiv portalda e-Müstahsil makbuzu taslağı oluşturur. GV stopajı ve toplamlar otomatik hesaplanır. |
| gib_create_self_employed_receiptB | GİB e-Arşiv portalda Serbest Meslek Makbuzu (e-SMM) taslağı oluşturur. Stopaj, KDV, tevkifat ve net tutarlar otomatik hesaplanır. |
| gib_list_documentsA | Belirtilen tarih aralığında düzenlenen belgeleri (taslak + imzalı) listeler. Onay durumu, belge türü, alıcı adı/VKN, belge no ve ETTN filtreleri uygulanabilir. |
| gib_list_documents_issued_to_meA | Belirtilen tarih aralığında adınıza düzenlenen belgeleri listeler. (Not: GİB tarafında bu servis zaman zaman stabil çalışmayabiliyor.) |
| gib_get_documentB | Portalda kayıtlı bir belgenin detaylarını UUID (ETTN) ile getirir. |
| gib_get_last_documentC | Portalda en son oluşturulan belgenin detaylarını getirir (varsayılan olarak son 1 yıl içinde arar). |
| gib_get_document_htmlC | Portalda kayıtlı belgenin HTML çıktısını getirir. |
| gib_get_download_urlA | Belgenin zip indirme adresini üretir. Not: Bu adrese yalnızca tokenın oluşturulduğu IP adresinden erişilebilir; farklı IP için gib_save_document_to_disk kullanın. |
| gib_save_document_to_diskB | Portalda kayıtlı belgeyi zip olarak indirir ve diske kaydeder; kaydedilen dosyanın tam yolunu döndürür. |
| gib_delete_draftsB | İmzalanmamış taslak belgeleri siler. Silinecek belgelerin UUID (ETTN) listesi verilmelidir. |
| gib_start_sms_verificationA | Belge imzalamak için SMS doğrulaması başlatır: portalda kayıtlı GSM numarasına doğrulama kodu gönderilir ve imzalama adımında kullanılacak Operasyon ID (oid) döndürülür. SMS doğrulama test hesaplarıyla çalışmaz. |
| gib_complete_sms_verificationA | ☢️ DİKKAT: Belge imzalama, faturanın/makbuzun resmen kesilmesi işlemidir ve vergi sisteminde mali veri oluşturur. İmzalanan belge değiştirilemez ve silinemez. SMS ile gelen kod, gib_start_sms_verification'dan alınan oid ve imzalanacak belgelerin UUID listesi gönderilmelidir. |
| gib_cancellation_requestC | İmzalanmış bir belge için iptal talebi oluşturur. |
| gib_objection_requestB | İmzalanmış bir belge için itiraz talebi oluşturur. |
| gib_get_requestsC | Belirtilen tarih aralığındaki iptal/itiraz taleplerini listeler. |
| gib_get_user_dataB | Portalda kayıtlı kullanıcı (mükellef) profil bilgilerini getirir. |
| gib_update_user_dataA | Portalda kayıtlı kullanıcı profil bilgilerini günceller. Önce mevcut bilgiler okunur, verilen alanlar üzerine yazılır ve kaydedilir. |
| gib_get_recipient_dataA | TC Kimlik No veya Vergi Kimlik No ile mükellef bilgilerini (ünvan, ad, soyad, vergi dairesi) sorgular. Fatura kesmeden önce VKN doğrulamak için kullanılabilir. Test ortamında sonuç boş döner. |
| gib_get_reference_dataA | Belge oluştururken kullanılan sabit listeleri döndürür: birimler, vergiler, KDV tevkifat kodları, özel matrah nedenleri, fatura tipleri, para birimleri, itiraz yöntemleri. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 24 tools
Each tool has a clearly distinct purpose covering different aspects of the document lifecycle: authentication, document creation (invoice, producer receipt, self-employed receipt), retrieval, deletion, signing, and dispute management. The use of unique verbs and nouns prevents any ambiguity.
All tools consistently use the 'gib_' prefix followed by a verb_noun pattern (e.g., gib_create_invoice, gib_list_documents, gib_get_document). This uniform naming convention makes the API predictable and easy to navigate.
With 24 tools, the count is on the higher side but justified by the complexity of the Turkish tax document domain which requires authentication, document creation (multiple types), signing, dispute management, and reference data operations. Each tool serves a distinct and necessary function.
The tool set covers the full lifecycle: authentication, session management, document creation (invoice, producer receipt, self-employed receipt), retrieval, listing, deletion, signing via SMS verification, cancellation, objection, reference data, user profile management, and recipient verification. No obvious gaps are present for the stated purpose of interacting with the GİB e-Arşiv portal.