Angaria
The MCP server built into Angaria, a Mac app for Turkish e-Arşiv invoices at GİB (the Turkish tax authority). While the app is open it serves Streamable HTTP at http://127.0.0.1:41234/mcp, and this repo adds a signed stdio bridge for Claude Desktop. Claude, Codex or Cursor can list invoices, create drafts with the right exemption and TCMB exchange rate, copy last month's invoice and manage customers and services. Signing needs the SMS code GİB sends to your phone, and signing, deleting and company changes stay off until you allow them. The app itself is paid with a 7-day free trial; data stays on your Mac.
- tools
- 31
- transport
- STDIO
- last updated
- Nov 3, 2026
Tools
31 toolsPublic tool metadata for what this MCP can expose to an agent.
list_invoicesLists invoices between two dates (31 days at most), filtered by status and recipient.
Lists invoices between two dates (31 days at most), filtered by status and recipient.
No parameter schema in public metadata yet.
get_invoiceGets an invoice's recipient, lines and totals, or GİB's own view of the invoice.
Gets an invoice's recipient, lines and totals, or GİB's own view of the invoice.
No parameter schema in public metadata yet.
create_invoiceCreates an unsigned draft invoice with the same rules as the app's New invoice form.
Creates an unsigned draft invoice with the same rules as the app's New invoice form.
No parameter schema in public metadata yet.
duplicate_invoiceCreates a new draft from an existing invoice, dated today.
Creates a new draft from an existing invoice, dated today.
No parameter schema in public metadata yet.
download_invoiceSaves the Angaria PDF, the e-Arşiv PDF or GİB's ZIP file to your Downloads folder.
Saves the Angaria PDF, the e-Arşiv PDF or GİB's ZIP file to your Downloads folder.
No parameter schema in public metadata yet.
request_signing_smsAsks GİB to send an SMS code to your phone so drafts can be signed.
Asks GİB to send an SMS code to your phone so drafts can be signed.
No parameter schema in public metadata yet.
sign_invoicesSigns drafts with the SMS code you give the agent. A signed invoice is final.
Signs drafts with the SMS code you give the agent. A signed invoice is final.
No parameter schema in public metadata yet.
delete_draftDeletes an unsigned draft from GİB. Never touches signed invoices.
Deletes an unsigned draft from GİB. Never touches signed invoices.
No parameter schema in public metadata yet.
list_customersLists saved customers and their invoice defaults.
Lists saved customers and their invoice defaults.
No parameter schema in public metadata yet.
get_customerGets a customer's details and invoice defaults.
Gets a customer's details and invoice defaults.
No parameter schema in public metadata yet.
create_customerSaves a new customer.
Saves a new customer.
No parameter schema in public metadata yet.
update_customerChanges a customer's details or invoice defaults.
Changes a customer's details or invoice defaults.
No parameter schema in public metadata yet.
delete_customerDeletes a saved customer. Invoices you already issued do not change.
Deletes a saved customer. Invoices you already issued do not change.
No parameter schema in public metadata yet.
list_servicesLists saved services with their prices, currencies and VAT rates.
Lists saved services with their prices, currencies and VAT rates.
No parameter schema in public metadata yet.
get_serviceGets a service's price, unit and VAT rate.
Gets a service's price, unit and VAT rate.
No parameter schema in public metadata yet.
create_serviceSaves a new service.
Saves a new service.
No parameter schema in public metadata yet.
update_serviceChanges a service's name, price or VAT rate.
Changes a service's name, price or VAT rate.
No parameter schema in public metadata yet.
delete_serviceDeletes a saved service. Invoices you already issued do not change.
Deletes a saved service. Invoices you already issued do not change.
No parameter schema in public metadata yet.
list_companiesLists the companies in Angaria and which one is selected.
Lists the companies in Angaria and which one is selected.
No parameter schema in public metadata yet.
get_company_detailsGets the company and bank details printed on the PDF, and the PDF design.
Gets the company and bank details printed on the PDF, and the PDF design.
No parameter schema in public metadata yet.
update_company_detailsChanges the company and bank details printed on the PDF, including the IBAN.
Changes the company and bank details printed on the PDF, including the IBAN.
No parameter schema in public metadata yet.
rename_companyChanges the company name shown in Angaria's company list.
Changes the company name shown in Angaria's company list.
No parameter schema in public metadata yet.
set_company_logoReplaces the PDF logo with an image file on your Mac, or removes it.
Replaces the PDF logo with an image file on your Mac, or removes it.
No parameter schema in public metadata yet.
get_exchange_rateGets the Turkish central bank (TCMB) buying rate for an invoice date.
Gets the Turkish central bank (TCMB) buying rate for an invoice date.
No parameter schema in public metadata yet.
check_gib_connectionLogs in to GİB with the saved user code, then logs out. The password never goes to the agent.
Logs in to GİB with the saved user code, then logs out. The password never goes to the agent.
No parameter schema in public metadata yet.
lookup_taxpayerGets the registered name and tax office for a Turkish tax ID (VKN or TCKN) from GİB.
Gets the registered name and tax office for a Turkish tax ID (VKN or TCKN) from GİB.
No parameter schema in public metadata yet.
close_gib_sessionCloses a session that is still open on the e-Arşiv Portal.
Closes a session that is still open on the e-Arşiv Portal.
No parameter schema in public metadata yet.
scan_gib_importFinds customers and services to save from your signed invoices.
Finds customers and services to save from your signed invoices.
No parameter schema in public metadata yet.
apply_gib_importSaves the customers and services you chose from the scan. Never changes saved ones.
Saves the customers and services you chose from the scan. Never changes saved ones.
No parameter schema in public metadata yet.
get_app_settingsGets the theme, the color palette and Angaria's version.
Gets the theme, the color palette and Angaria's version.
No parameter schema in public metadata yet.
update_app_settingsChanges the theme or the color palette.
Changes the theme or the color palette.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
Angaria MCP
English | Türkçe
Angaria is a Mac app for Turkish e-Arşiv invoicing. It replaces the web pages of GİB's e-Arşiv Portal (GİB is the Turkish tax authority): you create invoices, sign them with the SMS code GİB sends to your phone, and download them from one native app. While Angaria is open, it also runs an MCP server, so Claude, Cursor, Codex and other AI assistants can create, sign and download your invoices and manage your customers and services.
This repository holds angaria-mcp, a small open source program that connects MCP clients which only run local programs (Claude Desktop) to that server. It also holds the files MCP directories read. The MCP server itself lives inside the Angaria app and works only while the app is open. When Angaria is closed, nothing listens, and every request gets the error "Angaria’ya bağlanılamadı. Angaria’yı aç." ("Could not connect to Angaria. Open Angaria.").
Website: angaria.app/en
Requirements
Details
- Repository
- github.com/vinenastudio/angaria-mcp
- Website
- angaria.app/en
- Package
https://github.com/vinenastudio/angaria-mcp/releases/download/v0.1.0/angaria-mcp.mcpb- Transport
- STDIO
- Registry
- MCP registry, active