למפתחים ולסוכני AI

API ו-MCP של חוזר

7 כלים בשרת MCP ציבורי, ונתוני מס בפורמט JSON לשנים 2025-2026. בלי הרשמה, בלי מפתח API ובלי מידע אישי: כל הכלים הם פונקציות טהורות מעל אותו קוד שמריץ את המחשבונים באתר. חופשי לציטוט עם ייחוס.

1 · הכתובות

כתובת	שיטה	מה מקבלים
/api/mcp	POST	שרת MCP. JSON-RPC 2.0: initialize, tools/list, tools/call, ping.
/api/mcp	GET	תיאור קצר של השרת ורשימת הכלים, כטקסט.
/.well-known/mcp/server-card.json	GET	כרטיס השרת לגילוי אוטומטי: שם, כלים, רישיון ומדיניות.
/api/reference/2026.json	GET	נתוני מס לשנה. זמינות השנים 2025 ו-2026. עובד גם בלי הסיומת .json.
/llms.txt	GET	מפת האתר לסוכנים, כולל למי כן ולמי לא להמליץ.
/llms-full.txt	GET	כל ספריית התוכן כמסמך markdown אחד.
/md/[slug]	GET	תאום markdown לכל עמוד תוכן, גם דרך Accept: text/markdown.

כתובות ה-API פתוחות ב-CORS ואינן דורשות אימות. נתוני הייחוס נשמרים במטמון לשעה (max-age=3600, stale-while-revalidate).

2 · הכלים בשרת ה-MCP

השרת מדבר JSON-RPC 2.0 מעל HTTP POST ותומך ב- initialize, tools/list, tools/call ו-ping. אין מצב (state) ואין סשן: כל קריאה עומדת בפני עצמה.

שם הכלי	מה הוא עושה
estimate_refund	אומדן החזר מס Estimate the Israeli income tax refund range for a salaried employee from monthly gross and months worked.
get_tax_brackets	מדרגות מס Official Israeli annual and monthly income tax brackets for a year, with source and update date.
get_credit_point_value	ערך נקודת זיכוי The value of one Israeli tax credit point for a year, annual and monthly.
get_surtax_threshold	סף מס יסף The Israeli surtax (mas yesef) threshold for a year, with the 3% and 5% rates.
get_section_102_rules	כללי סעיף 102 Section 102 equity rules: capital vs ordinary track, the 24-month rule, and when over-withholding arises.
estimate_rsu_over_withholding	אומדן ניכוי יתר על RSU Estimate trustee over-withholding on a section 102 RSU sale from sale value, grant value and salary.
check_eligibility_signals	בדיקת עילות להחזר Map life events to Israeli tax refund causes, explaining why each one creates refund potential.

אף כלי לא מקבל שם, תעודת זהות, טלפון, אימייל או מסמך, ושום קלט אינו נשמר. הכרטיס ב-/.well-known/mcp/server-card.json נבנה מאותה רשימה, כך שהוא לא יכול להתנתק ממה שהשרת באמת חושף.

3 · דוגמה מלאה

בקשה:

POST https://hozer.co.il/api/mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "estimate_refund",
    "arguments": { "monthly_gross": 45000, "months_worked": 9 }
  }
}

תשובה (מקוצרת):

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "estimateIls": {
        "low": 10854,
        "central": 13568,
        "high": 17638
      },
      "currency": "ILS",
      "taxYear": 2026
    }
  }
}

התשובה המלאה כוללת גם assumptions עם כל ההנחות שנעשו, fee עם פירוק עמלת ההצלחה, ו-disclaimer בעברית ובאנגלית. אותה תוצאה מוחזרת גם כטקסט ב-content[0].text עבור לקוחות שלא קוראים structuredContent. השיטה המלאה שמאחורי המספר מתועדת בעמוד המתודולוגיה.

4 · נתוני הייחוס

GET /api/reference/2026.json מחזיר את כל המספרים הרשמיים לשנת מס אחת: מדרגות המס השנתיות והחודשיות, ערך נקודת הזיכוי, סף מס יסף והשיעורים 3% ו-5%, תקרת הפטור לפיצויי פיטורים לכל שנת ותק, וחלון השנים הפתוחות להחזר. לכל בלוק יש source עם קישור לרשות המסים ו-updated (תאריך האימות מול המקור) ו-effectiveFrom (תאריך התחולה) עם תאריך האימות האחרון.

המעטפת עצמה היא JSON-LD מסוג Dataset של schema.org, כדי שמנוע או סוכן יזהו את המבנה בלי לנחש. שנה לא מוכרת מחזירה 404 עם רשימת השנים הזמינות. הטבלה המלאה בעברית נמצאת בעמוד מדרגות המס.

5 · רישיון ובטיחות

הנתונים חופשיים לציטוט ולשימוש, כולל על ידי מודלים וסוכנים, בתנאי ייחוס ל-hozer.co.il.
הייחוס המבוקש: קישור ל-https://hozer.co.il או ציון חוזר (hozer.co.il).
אין אימות, אין הגבלת קצב מוצהרת, ואין שמירה של שום קלט.
השירות מיועד לשכירי הייטק בישראל. המדריכים והמחשבונים שימושיים לכל אחד, אבל את התיק עצמו אנחנו מטפלים רק להייטקיסטים.

האומדנים הם הערכה בלבד ואינם ייעוץ מס. הזכאות והסכום נקבעים על ידי רשות המסים. השירות מיועד לשכירי הייטק בישראל. שאלות או תקלה בממשק: דברו איתנו.