Fonzip

Name: Fonzip
Author: ubaranzorlu

by ubaranzorluversion 0.1.2i★ –iRuns on your computer

Registry nameio.github.ubaranzorlu/fonzip

Install

Overview

Description from the maker (original English)

Dernek ve vakiflar icin Fonzip API v2 MCP sunucusu: bagis, uye, aidat ve etkinlik verileri.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiVery new↓ 42/wk · ★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Other
You need to fill in: FONZIP_CLIENT_ID, FONZIP_CLIENT_SECRET

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: FONZIP_CLIENT_ID, FONZIP_CLIENT_SECRET, FONZIP_SCHEMA_MODE, FONZIP_BASE_URL

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "fonzip": {
      "command": "npx",
      "args": [
        "-y",
        "@ubaranzorlu/fonzip-mcp"
      ],
      "env": {
        "FONZIP_CLIENT_ID": "your-value",
        "FONZIP_CLIENT_SECRET": "your-value",
        "FONZIP_SCHEMA_MODE": "your-value",
        "FONZIP_BASE_URL": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add fonzip --env FONZIP_CLIENT_ID=your-value --env FONZIP_CLIENT_SECRET=your-value --env FONZIP_SCHEMA_MODE=your-value --env FONZIP_BASE_URL=your-value -- npx -y @ubaranzorlu/fonzip-mcp

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "fonzip": {
      "command": "npx",
      "args": [
        "-y",
        "@ubaranzorlu/fonzip-mcp"
      ],
      "env": {
        "FONZIP_CLIENT_ID": "your-value",
        "FONZIP_CLIENT_SECRET": "your-value",
        "FONZIP_SCHEMA_MODE": "your-value",
        "FONZIP_BASE_URL": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "fonzip": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ubaranzorlu/fonzip-mcp"
      ],
      "env": {
        "FONZIP_CLIENT_ID": "your-value",
        "FONZIP_CLIENT_SECRET": "your-value",
        "FONZIP_SCHEMA_MODE": "your-value",
        "FONZIP_BASE_URL": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

FONZIP_CLIENT_ID secret required env
Fonzip API client id. Fonzip > Ayarlar > Gelismis > Fonzip API menusunden olusturulur.
FONZIP_CLIENT_SECRET secret required env
Fonzip API client secret.
FONZIP_SCHEMA_MODE env
Tool semasi ayrintisi: full (varsayilan) veya compact.
FONZIP_BASE_URL env
Fonzip API adresi.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 9, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account ubaranzorlu, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Otheri

More stars than 0% of the other 18659 servers in this category
Published to the registry more recently than 30% of the other 18659 servers in this category
Basic checks equal to or better than 100% of the other 18659 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Fonzip safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: FONZIP_CLIENT_ID, FONZIP_CLIENT_SECRET

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.1.2) reached the registry 2 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, alalanet — check before you pay

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

by formulahendryEarly↓ 66/wk★ 440Updated 14 months ago

Runs on your computer

Install

Remote Desktop Commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

by desktop-commanderGrowing★ 211Updated 3 days ago

Runs in the cloud✓ desktopcommander.app

Install

alalanet — check before you pay

Check packages, MCP servers and x402 endpoints before agents install or pay. Signed.

by alalanetEarlyUpdated today

Runs in the cloud✓ alalanet.com

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

fonzip-mcp

[Fonzip](https://fonzip.com) API v2 için Model Context Protocol sunucusu

Dernek ve vakıfların bağış, üye, aidat, etkinlik ve kampanya verilerine AI ajanlarından erişim.

Bağımsız bir açık kaynak projesidir; Fonzip Yazılım A.Ş. tarafından geliştirilmemiş, desteklenmemekte ve onaylanmamaktadır.

Claude Code, Claude Desktop, Cursor, VS Code, Codex ve MCP destekleyen diğer istemcilerin Fonzip verilerinize doğrudan erişmesini sağlar.

Sen:    Bu ay kaç düzenli bağışçı kaydolmuş, toplam ne kadar?

Ajan: [fonzip_donations / list çağrılır] Ağustos'ta 34 yeni düzenli bağışçı, aylık toplam 41.250 TL.

13 tool, Fonzip API v2'nin 113 operasyonunu kapsar
Tool tanımları OpenAPI spec'inden otomatik üretilir — elle senkron tutulmaz
OAuth2 client_credentials, token'ı süreçler arası saklama dahil
Türkçe hata mesajları; hatalı çağrıda beklenen şema modele geri döner

Kurulum

Node.js 20 veya üstü gerekir. Önce Fonzip'te Ayarlar > Gelişmiş > Fonzip API menüsünden API anahtarı oluşturun; size bir client_id ve client_secret verilir.

[!IMPORTANT]

Fonzip anahtarları $2b$12$... ile başlar. Kabukta tek tırnak kullanın — çift tırnak veya tırnaksız yazarsanız kabuk $2b ve $12 kısımlarını değişken sanıp siler ve HTTP 403 alırsınız. JSON dosyalarında bu sorun yoktur.

Claude Code

claude mcp add fonzip \

-e FONZIP_CLIENT_ID='...' \ -e FONZIP_CLIENT_SECRET='...' \ -- npx -y @ubaranzorlu/fonzip-mcp

Sadece bulunduğunuz projeye ekler. Tüm projelerde kullanmak için -s user, ekiple paylaşmak için -s project ekleyin.

Claude Desktop

Ayarlar > Developer > Edit Config ile claude_desktop_config.json dosyasını açın:

"mcpServers": { "fonzip": { "command": "npx", "args": ["-y", "@ubaranzorlu/fonzip-mcp"], "env": { "FONZIP_CLIENT_ID": "...", "FONZIP_CLIENT_SECRET": "..." } } } }

Claude Desktop'ı yeniden başlatın.

Cursor

~/.cursor/mcp.json (global) veya proje kökünde .cursor/mcp.json:

"mcpServers": { "fonzip": { "command": "npx", "args": ["-y", "@ubaranzorlu/fonzip-mcp"], "env": { "FONZIP_CLIENT_ID": "...", "FONZIP_CLIENT_SECRET": "..." } } } }

VS Code / GitHub Copilot

code --add-mcp '{"name":"fonzip","command":"npx","args":["-y","@ubaranzorlu/fonzip-mcp"],"env":{"FONZIP_CLIENT_ID":"...","FONZIP_CLIENT_SECRET":"..."}}'

Ya da .vscode/mcp.json dosyasına yazıp anahtarları girdi olarak sorun:

"inputs": [ { "type": "promptString", "id": "fonzip-id", "description": "Fonzip client id", "password": true }, { "type": "promptString", "id": "fonzip-secret", "description": "Fonzip client secret", "password": true } ], "servers": { "fonzip": { "command": "npx", "args": ["-y", "@ubaranzorlu/fonzip-mcp"], "env": { "FONZIP_CLIENT_ID": "${input:fonzip-id}", "FONZIP_CLIENT_SECRET": "${input:fonzip-secret}" } } } }

Codex CLI

~/.codex/config.toml:

[mcp_servers.fonzip]

command = "npx" args = ["-y", "@ubaranzorlu/fonzip-mcp"] env = { FONZIP_CLIENT_ID = "...", FONZIP_CLIENT_SECRET = "..." }

Zed, Windsurf, Continue ve diğerleri

Standart stdio MCP sunucusudur. İstemcinizin yapılandırmasına şunu tanıtın:

komut:    npx

argüman: -y @ubaranzorlu/fonzip-mcp ortam: FONZIP_CLIENT_ID, FONZIP_CLIENT_SECRET

Sunucu MCP Registry'de io.github.ubaranzorlu/fonzip adıyla kayıtlıdır; registry'den kurulum destekleyen istemciler doğrudan bulabilir.

Doğrulama

İstemcinize sorun: *"Fonzip hesabımın bilgilerini göster"* — sunucu fonzip_system / me çağrısıyla kurum adınızı döndürmeli.

Ortam değişkenleri

Değişken	Zorunlu	Varsayılan	Açıklama
`FONZIP_CLIENT_ID`	evet¹	—	Fonzip API client id
`FONZIP_CLIENT_SECRET`	evet¹	—	Fonzip API client secret
`FONZIP_ACCESS_TOKEN`	hayır	—	Hazır token. Verilirse `client_credentials` akışı atlanır
`FONZIP_BASE_URL`	hayır	`https://fonzip.com/api/v2`	API adresi
`FONZIP_SCHEMA_MODE`	hayır	`full`	`full` veya `compact` — şema modu
`FONZIP_TOKEN_CACHE`	hayır	`~/.cache/fonzip-mcp/tokens.json`	Token önbelleği yolu. `off` ile kapatılır
`FONZIP_TIMEOUT_MS`	hayır	`30000`	İstek zaman aşımı
`FONZIP_MAX_RETRIES`	hayır	`3`	429 ve 5xx için yeniden deneme sayısı
`FONZIP_USER_AGENT`	hayır	`fonzip-mcp/`	Boş bırakmayın — neden

¹ FONZIP_ACCESS_TOKEN verilmediyse zorunlu.

Tool'lar

Fonzip API v2'de 115 operasyon var. Her biri ayrı bir tool olsaydı istemcinin tool listesi şişerdi; bunun yerine operasyonlar konu başlığına göre 13 tool'da gruplandı. Her tool zorunlu bir action parametresi alır.

Tool	Action	Kapsam
`fonzip_system`	5	Kurum bilgisi (`me`), ödeme sistemleri, banka hesapları, pazarlama kanalları
`fonzip_users`	18	Üye/bağışçı kayıtları, zaman tüneli, etiketler, kişiye bağlı listeler
`fonzip_donations`	14	Bağışlar, bağış kategorileri, mikro bağışlar, bağış sayfaları ve formları
`fonzip_monthly_donations`	5	Düzenli bağış tutar/kart değişikliği ve iptal
`fonzip_membership_dues`	9	Aidat abonelikleri ve borçlar
`fonzip_events`	12	Etkinlikler, biletler, bilet satışları
`fonzip_fundraising`	19	Bağış kampanyaları, kampanya etkinlikleri, takımlar
`fonzip_forms`	4	Formlar ve form cevapları
`fonzip_ecards`	9	E-kartlar, kategoriler, satış işlemleri
`fonzip_tags`	4	Etiket yönetimi
`fonzip_templates`	5	Mesaj şablonları
`fonzip_webhooks`	6	Webhook yönetimi ve test bildirimi
`fonzip_communication_permissions`	3	E-posta/SMS/telefon izinleri

/token ve /authorize uçları tool olarak sunulmaz; kimlik doğrulama sunucunun kendi işidir.

Örnek çağrı:

"name": "fonzip_donations", "arguments": { "action": "list", "status": "paid", "start_date": "2026-01-01T00:00:00+03:00", "end_date": "2026-01-31T23:59:59+03:00" } }

Şema modu

full (varsayılan) modda her tool'un tüm parametreleri JSON Schema olarak istemciye gönderilir. 13 tool'un toplam şeması yaklaşık 70 KB (~19 bin token) tutar; model tek turda doğru çağrıyı kurabilir.

Bağlam bütçesi darsa FONZIP_SCHEMA_MODE=compact kullanın: şemalar yalnızca action ve serbest bir params objesine iner, alan adları ise tool açıklamasında özetlenir. Toplam yaklaşık 22 KB (~6 bin token), yani full modun üçte biri. Eksik alan gönderildiğinde hata mesajı o action'ın tam şemasını geri döndürür, böylece model kendini düzeltir.

Her iki modda da hem düz ({"action": "get", "user_id": 1}) hem sarmalanmış ({"action": "get", "params": {"user_id": 1}}) biçim kabul edilir.

Bilinmesi gerekenler

Fonzip aynı anda tek token verir. Geçerli bir token varken /token çağrısı HTTP 409 "Token already created" döner. MCP sunucuları sık yeniden başlatıldığından, token varsayılan olarak ~/.cache/fonzip-mcp/tokens.json dosyasına (0600 izniyle, client id yazılmadan) kaydedilir ve yeniden başlatmada tekrar kullanılır. Bu önbelleği kapatırsanız sunucu yeniden başladığında bir saate kadar token alamayabilir.

User-Agent zorunludur. Fonzip'in önündeki Cloudflare, User-Agent başlığı olmayan istekleri HTTP 403 (error code 1010) ile reddeder. FONZIP_USER_AGENT değerini boş bırakmayın.

Hız sınırı dakikada 240 istektir. HTTP 429 alındığında Retry-After başlığına uyularak yeniden denenir.

İşlem listeleri tarih aralığı ister. start_date ve end_date şu action'larda zorunludur; eksikse istek Fonzip'e gitmeden reddedilir:

fonzip_donations → list, list_micro, report · fonzip_membership_dues → list · fonzip_events → list_ticket_sales · fonzip_forms → list_answers · fonzip_ecards → list_transactions

Sayfalama (start_page, varsayılan 1) ve sayfa boyutu (how_many, varsayılan 10, en fazla 100) göndermezseniz varsayılanları otomatik eklenir. Aynı şekilde fonzip_donations / list için status varsayılan olarak paid gider.

Yazma işlemleri açıktır. Sunucu tüm CRUD operasyonlarını sunar; silme işlemleri geri alınamaz. Silme içeren tool'lar MCP destructiveHint ile işaretlenir, istemciniz bunlar için onay isteyebilir. Yalnızca okuma istiyorsanız Fonzip'te salt okunur yetkili bir API anahtarı oluşturun.

Kişisel veri modele gider. Fonzip yanıtları ad, e-posta, telefon, TC kimlik no ve IBAN içerebilir; bunlar MCP istemcinize ve kullandığınız modele aktarılır. KVKK yükümlülükleriniz açısından değerlendirin. Ayrıntı için SECURITY.md.

Büyük yanıtlar kırpılır. 100.000 karakteri aşan yanıtlar kesilir ve sayfalama önerilir.

Geliştirme

git clone https://github.com/ubaranzorlu/fonzip-mcp.git

cd fonzip-mcp npm install npm test # 97 test npm run build

Depoda .mcp.json var; npm run build sonrası Claude Code bu projede sunucuyu yerel dist/ üzerinden çalıştırır. Kabuğunuzda FONZIP_CLIENT_ID ve FONZIP_CLIENT_SECRET tanımlı olmalıdır.

Tool tanımları elle yazılmaz — scripts/generate.ts, openapi/fonzip-v2.yaml dosyasından src/generated/operations.ts üretir. Ayrıntılar ve sürüm çıkarma adımları için CONTRIBUTING.md.

Katkı

Katkılar memnuniyetle karşılanır. Başlamadan önce CONTRIBUTING.md ve CODE_OF_CONDUCT.md dosyalarına göz atın. Güvenlik açıkları için SECURITY.md.

Lisans

openapi/fonzip-v2.yaml Fonzip Yazılım A.Ş.'nin kendi API dokümanıdır ve MIT kapsamı dışındadır; depoda yalnızca tool tanımlarının üretilmesi için referans olarak bulunur. Aynı istisna, spec'ten türeyen src/generated/operations.ts ve yayınlanan dist/ içeriği için de geçerlidir. "Fonzip" adı yalnızca sunucunun hangi servise bağlandığını belirtmek için kullanılır. Ayrıntı: NOTICE.

API ile ilgili sorular için: help@fonzip.com

Fonzip

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Otheri

Common questions

Alternatives

Spec Driven Development

Remote Desktop Commander

alalanet — check before you pay

README from the maker

fonzip-mcp

Kurulum

Doğrulama

Ortam değişkenleri

Tool'lar

Şema modu

Bilinmesi gerekenler

Geliştirme

Katkı

Lisans