Müvezzi MCP

npx add-mcp 'https://muvezzi.com/api/mcp'

Müvezzi, yayımlanmış haberlerine, kayıtlı gazete ön sayfalarına ve bu sitede açık finansal modüllerin kayıtlı verilerine yapay zekâ uygulamalarından salt okunur erişim sunar. Giriş veya API anahtarı gerekmez.

Sunucu: https://muvezzi.com/api/mcp

Bu adres GET ile açıklama sayfasıdır; MCP çağrıları POST ile Streamable HTTP üzerinden yapılır. GET bir SSE oturumu açmaz.

Nasıl bağlanılır?

Aşağıdaki kaydı belirtilen dosyaya mevcut ayarlarınızı koruyarak ekleyin. Claude ve Gemini örnekleri Code/CLI istemcilerine aittir; Codex TOML kullanır.

Claude Code · JSON

.mcp.json

{
  "mcpServers": {
    "muvezzi_com": {
      "type": "http",
      "url": "https://muvezzi.com/api/mcp"
    }
  }
}

Gemini CLI · JSON

~/.gemini/settings.json

{
  "mcpServers": {
    "muvezzi_com": {
      "httpUrl": "https://muvezzi.com/api/mcp"
    }
  }
}

Cursor · JSON

.cursor/mcp.json

{
  "mcpServers": {
    "muvezzi_com": {
      "url": "https://muvezzi.com/api/mcp"
    }
  }
}

Codex · TOML

~/.codex/config.toml

[mcp_servers.muvezzi_com]
url = "https://muvezzi.com/api/mcp"

Kullanılabilir araçlar

Yalnız bu sitede açık olan araçlar listelenir. Haber listeleri ve varlık araması en fazla 50 sonuç döndürür.

Finansal geçmişte 30, 90, 180, 365 veya 730 gün (varsayılan 365) kullanılabilir.

Fon karşılaştırması 2–5 farklı kod alır; varsayılan dönem 1y, diğer dönemler 1g, 1h, 1a, 3a, 6a, yb, 3y ve 5y'dir.

Araç	Girdi alanları	Açıklama
get_latest_news	limit, category	En son yayımlanan haberleri getirir; isteğe bağlı kategori filtresi kullanılabilir.
get_article	id, slug	Haberin sayısal URL kimliği veya slug değeriyle tam metni, tarih, kategori ve kaynak bilgilerini getirir.
search_news	query, limit, category	Haber başlıkları, açıklamaları ve anahtar kelimelerinde arama yapar; kategoriyle sınırlandırılabilir.
get_category_news	category, limit	Belirli bir kategorideki son yayımlanan haberleri listeler.
list_categories	language	Aktif ana kategorileri adları ve slug değerleriyle listeler.
search	query, limit	Kısa haber sonuçları ve fetch için kullanılabilecek article:123 biçiminde kimlikler döndürür.
fetch	id	Arama sonucundan alınan içerik kimliğiyle haberin tam metnini ve kaynak bilgilerini getirir.
search_financial_assets	query, type, limit	Aktif hisseleri ve fonları kod veya adla arar; yalnız bu sitede açık varlık türlerini listeler.
get_stock_quote	symbol	Kayıtlı son fiyat, değişim ve temel bilgileri getirir; gerçek zamanlı fiyat garantisi yoktur.
get_stock_history	symbol, days	Yalnız kayıtlı gerçek kapanışları getirir; dış kaynağa istek veya sentetik fiyat üretmez.
get_fund_details	code	Fon künyesi, birim fiyat, kategori, ücret, risk değeri ve mevcut varlık dağılımını getirir.
get_fund_history	code, days	Günlük kayıtlardan gerçek birim fiyatları getirir; yaklaşık getiri endeksini fiyat olarak sunmaz.
get_fund_returns	code	Kayıtlı günlük, haftalık, aylık ve uzun dönem getirilerini yüzde olarak sunar.
compare_funds	codes, period	2–5 farklı fonu aynı dönemle karşılaştırır; eksik veriyi ve tarih farklarını belirtir.
get_market_overview	limit	Açık endeks ve son turdaki hisse listelerini getirir; kapalı bölümler çağrılmaz.
get_stock_financials	symbol	Kayıtlı şirket finansallarını dönemleri ve mevcut birimleriyle getirir; hesaplanmış seriler ayrıca belirtilir.
list_company_disclosures	symbol, days, limit	Şirketin kayıtlı KAP bildirimlerini yeniden eskiye listeler.
list_fund_leaders	period, direction, category, limit	Dönemsel kazandıran/kaybettiren fonları listeler; yönün modül izni ayrıca kontrol edilir.
get_fund_holdings	code, limit	Kayıtlı en büyük fon hisse pozisyonlarını getirir; tam portföy olduğu iddia edilmez.
list_newspapers	query, limit	Gazete adlarını, slug değerlerini ve ilk/son mevcut arşiv tarihlerini listeler; aradaki günlerin varlığını garanti etmez.
get_newspaper_headlines	date, limit, offset	İstenen günün kayıtlı gazete ön sayfalarını kaynak ve görsel bağlantılarıyla listeler; tarih yoksa İstanbul bugün kullanılır.
get_newspaper_front_page	newspaper, date	Gazetenin tam ön sayfasını istenen tarihte MCP image ve bağlantılarla getirir. OCR/kesme yapmaz; eksik tarihte başka güne geçmez.

Örnek çağrılar

Araçları listeleyin:

curl -X POST 'https://muvezzi.com/api/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Son beş haberi getirin:

curl -X POST 'https://muvezzi.com/api/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_latest_news","arguments":{"limit":5}}}'

Gazete manşetleri ve ön sayfalar

Tarih verilmezse Europe/Istanbul'a göre bugün kullanılır. Tarihler gerçek YYYY-MM-DD günleri olmalı; gelecekteki günler kabul edilmez. Gazete adı veya slug kullanılabilir. Günlük listeler en fazla 50 sonuç, offset 0–1000 alır. Arşivde bulunmayan tarihte başka güne geçilmez; ilk/son arşiv tarihleri aradaki her günün mevcut olduğunu garanti etmez.

Tek gazete çağrısı tam ön sayfayı MCP image içeriği ve kaynak/görsel bağlantılarıyla döndürür. OCR veya haber kesme yapılmaz. Büyük görsel 2 MiB sınırına uymazsa mevcut küçük görsel denenir; toplam okuma süresi 10 saniyedir. Görsel eklenemediğinde image_embedded: false ve açıklayıcı uyarı döner.

Günün manşetleri:

curl -X POST 'https://muvezzi.com/api/mcp' -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_newspaper_headlines","arguments":{}}}'

Akşam gazetesinin bugünkü ön sayfası:

curl -X POST 'https://muvezzi.com/api/mcp' -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_newspaper_front_page","arguments":{"newspaper":"Akşam"}}}'

Akşam gazetesinin 8 Kasım 2024 ön sayfası:

curl -X POST 'https://muvezzi.com/api/mcp' -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_newspaper_front_page","arguments":{"newspaper":"Akşam","date":"2024-11-08"}}}'

2024-11-08 bir çağrı örneğidir; o tarihte arşiv bulunacağı garanti edilmez.

Ajan becerileri

Bu sitenin beceri keşif indeksi: /.well-known/agent-skills/index.json. Beceri dosyaları araçların nasıl kullanılacağını anlatır; bu indeks sitenin sunduğu bir keşif yüzeyidir.

• Haber araştırma — Haber arama, tam metni alma ve tarih/kaynak gösterme.
• Borsa veri okuma — Kayıtlı hisse verisini kaynak ve veri zamanı ayrımını koruyarak okuma.
• Gazete manşetleri — Gazete adını ve istenen tarihi doğrulayıp arşivdeki tam ön sayfa görselini kaynakla gösterme.
• Fon karşılaştırma — Fonları aynı dönemle, veri tarihleri ve eksik değerleri koruyarak karşılaştırma.

Kurallar ve sınırlar

• Ücretsiz. MCP için ödeme planı veya abonelik yoktur — /pricing.md. Bağlandığınız uygulamanın kendi ücretleri olabilir.
• Kimlik doğrulama yok. Hesap, token veya API anahtarı gerekmez — /auth.md.
• Atıf zorunlu. Müvezzi içeriğini kullanırken ilgili haberin veya veri sayfasının kalıcı adresine bağlantı verin.
• Eğitim verisi: ai-train=no — içeriğin model eğitimi veri kümelerine dahil edilmesini istemiyoruz; robots.txt. Bu tercih tüm istemcilerin uyacağına dair garanti değildir.
• Görsel hakları. Haber görselleri ve gazete ön sayfaları ilgili hak sahiplerinin telifine tabi olabilir. Erişim yeniden kullanım lisansı vermez; mevcut kaynak/lisans bilgisini koruyun, belirtilmeyen lisansı varsaymayın.
• Hata biçimi: HTTP koruma hataları application/json ile JSON-RPC error; araç hataları MCP isError ile döner. RFC 9457 application/problem+json kullanılmaz.

Tam kullanım rehberi: /AGENTS.md.

Güvenlik ve sınırlar

• Site + güvenilir IP başına 120 istek/dakika; search ve search_news birlikte 60 çağrı/dakika. Finansal araçlar ayrıca ortak 30 çağrı/dakika; üç gazete aracı ortak 60 çağrı/dakika; tek-gazete görsel aracı ayrıca 10 çağrı/dakika kotasını kullanır. Tümü genel kotadan da düşer. Sabit dakika pencereleri uygulanır.
• 429 yanıtında Retry-After süresini bekleyin. X-RateLimit-Limit, Remaining ve Reset başlıkları genel kotayı gösterir. Redis kota servisi erişilemiyorsa araçlar 503 ve Retry-After: 5 döndürür.
• Gövde sınırı 256 KiB; batch ve MCP oturum kimlikleri desteklenmez. Origin varsa aynı siteye ait olmalıdır.
• Bozuk JSON 400, izin verilmeyen Origin 403, fazla gövde 413, oturum kimliği 404 ve desteklenmeyen HTTP yöntemi 405 döner. Araç içi hatalar MCP isError ile açıklanır.
• Silinmiş, taslak, ileri tarihli veya bu sitede yayından kaldırılmış haberler sunulmaz. İçerik ekleme/düzenleme/silme aracı yoktur.

Finansal veri nasıl okunmalı?

Finansal çağrılar yalnız veritabanı ve önbelleği okur; dış sağlayıcıya istek yapmaz. Veriler 15 dakika gecikmelidir. Burada sunulan finansal veriler ve içerikler yatırım tavsiyesi değildir. Fiyatlar gerçek zamanlı garanti taşımaz. retrieved_at erişim zamanı, record_updated_at kayıt güncelleme zamanı, data_date varsa gerçek veri tarihidir; birbirinin yerine kullanılmaz. Bilinmeyen kaynak ve zaman tahmin edilmez. Eksik sayılar null olarak kalır, uyarılar sonuçla birlikte aktarılır.

Fiyat geçmişinde yalnız gerçek kayıtlar vardır. Yaklaşık getiri endeksleri, boş günler için doldurulmuş veya sentetik bugünkü fiyatlar sunulmaz. Fon karşılaştırmasında farklı veri tarihlerini dikkate alın; geçmiş getiriler gelecek getiri garantisi değildir. İçeriği ve veriyi aktarırken kaynak bağlantısını koruyun.

MCP keşif manifesti · llms.txt