יש שאלות או בעיות? כתבו ב-GitHub Discussions.

המירו מטבעות וחפשו שערי חליפין עדכניים או היסטוריים ישירות מעוזר ה-AI שלכם, דרך שרת ה-Model Context Protocol הרשמי. ההיסטוריה היומית מגיעה עד 1948.

הוסיפו את https://mcp.frankfurter.dev/ כשרת HTTP מרוחק. לא נדרשים מפתח API או הרשמה.

ChatGPT

  1. פתחו את Settings, ואז את Apps (או Connectors).
  2. בחלק העליון, לחצו על Advanced settings והפעילו את Developer mode כדי לאפשר אפליקציות מותאמות אישית.
  3. חזרו לתפריט המשנה Apps ולחצו על Create app (או Create connector).
  4. הזינו את כתובת נקודת הקצה: https://mcp.frankfurter.dev/.
  5. תחת אימות (authentication), בחרו None.

Claude

ב-Claude Code:

claude mcp add frankfurter https://mcp.frankfurter.dev/

ב-Claude Desktop או ב-Claude.ai:

  1. פתחו את Settings, ואז את Connectors.
  2. לחצו על Add custom connector.
  3. הזינו את כתובת נקודת הקצה: https://mcp.frankfurter.dev/.
  4. לחצו על Add כדי לסיים. אחרי החיבור, הפעילו את המחבר בממשק הצ'אט.

לקוחות אחרים

הוסיפו להגדרות ה-MCP שלכם (Cursor, Windsurf, VS Code ועוד):

{
  "mcpServers": {
    "frankfurter": {
      "url": "https://mcp.frankfurter.dev/"
    }
  }
}

כלים

אחרי החיבור, העוזר שלכם יכול להשתמש בכלים האלה:

convert
ממיר סכום בין שני מטבעות. כברירת מחדל מחזיר רק את הסכום המומר ואת המטבע שלו. הגדירו details: true כדי לקבל גם את השער, תאריך התחולה והמקור, אם נבחר מקור.
פרמטרים:
  • amount (מספר, חובה): הסכום להמרה.
  • from (מחרוזת, חובה): קוד מטבע או נכס המקור (למשל USD, XAU או BTC).
  • to (מחרוזת, חובה): קוד מטבע או נכס היעד (למשל EUR).
  • date (מחרוזת, אופציונלי): תאריך מסוים YYYY-MM-DD להמרה היסטורית.
  • provider (מחרוזת, אופציונלי): מפתח מקור (למשל ECB או UST), לקבלת השער שמפרסם מוסד אחד במקום השער המשוקלל. תאריך בתוך תקופה של מקור שבועי, חודשי או רבעוני מחזיר את השער שבתוקף.
  • details (בוליאני, אופציונלי): כולל את השער, תאריך התחולה והמקור שנבחר (ברירת מחדל: false). המרה בין מטבע לעצמו מחזירה שער 1 ותאריך null, ללא מקור.
get_rates
מחזיר שערי חליפין יציגים.
פרמטרים:
  • date (מחרוזת, אופציונלי): תאריך השער YYYY-MM-DD (ברירת המחדל היא העדכני ביותר).
  • base (מחרוזת, אופציונלי): קוד מטבע או נכס הבסיס (ברירת מחדל: EUR).
  • quotes (מחרוזת או מערך, אופציונלי): מסנן את התוצאות לפי קודי מטבעות או נכסים.
  • provider (מחרוזת או מערך, אופציונלי): מפתח מקור אחד או יותר. במטבע הבסיס של המקור עצמו, הספרות מוצגות כפי שפורסמו, עם התאריך שבו נכנסו לתוקף.
הכינוי הישן providers עדיין מתקבל. השתמשו ב-provider או ב-providers, לא בשניהם.
list_currencies
מוצא קודים נתמכים של מטבעות, מתכות יקרות ונכסי קריפטו ואת שמותיהם, כולל מטבעות היסטוריים. השמיטו את המסנן כדי להציג את כל הקודים.
פרמטרים:
  • query (מחרוזת, אופציונלי): קוד או חלק משם, בלי הבחנה בין אותיות רישיות לקטנות. קוד מדויק קודם להתאמות חלקיות.
list_providers
מוצא מקורות, עם מפתח, סוג שער, תדירות ותאריכי כיסוי, לבחירת provider. מקור שמפרסם כמה סדרות מציג גם את מערכי הנתונים שלו; העבירו מפתח של מערך נתונים כמו NBP.B בתור provider כדי לבחור אחד. המסננים משתלבים זה בזה ואינם תלויי רישיות. השמיטו אותם כדי להציג את כל המקורות.
פרמטרים:
  • query (מחרוזת, אופציונלי): מפתח מקור או חלק משמו. מפתח מדויק קודם להתאמות חלקיות.
  • country (מחרוזת, אופציונלי): קוד מדינה בן שתי אותיות (למשל US).
  • currency (מחרוזת, אופציונלי): קוד של מטבע נתמך, כולל מטבע הבסיס של המקור.

אם אתם צריכים סדרה עתית, טווח היסטורי או נתונים בכמויות גדולות, השתמשו ב-REST API.