SwitchWize MCP

Twenty-four read-only US rate, savings-gap, Fed, card and CD tools with sources and freshness.

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
98%
Vollständigkeit des Schemas
86%
Qualität der Benennung
96%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Befunde (1)

  • LOWTool 'compare_switch_savings' description lacks action verbin compare_switch_savings

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~10,224Tokens (Tool-Definitionen)
~6.0 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (7.99% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

{
  "mcpServers": {
    "switchwize-mcp": {
      "command": "npx",
      "args": [
        "switchwize-mcp"
      ]
    }
  }
}

Ausführbare Pakete

npmswitchwize-mcp0.3.0stdio

Remote-Endpunkte

https://www.switchwize.com/api/mcpstreamable-http

Was es kann

Tool-Inventar

Tools (18)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢get_top_rates(category, limit, approvedOnly, detail)

Return top SwitchWize rates with freshness and attribution. Savings, CDs, checking and money market answer only from their editor-approved snapshot. A category with no approved release yet returns no ranked rates and says so (approval_status: not_yet_approved) rather than serving unverified observations; approvedOnly makes that requirement explicit. Approved responses include product terms and field evidence; stale or unavailable releases return no ranked rates. detail=full (savings) adds the complete shared build: every listed account marked verified or tracked, best picks, movers, history and a headline summary.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "savings",
        "hysa",
        "cds",
        "money-market",
        "mma",
        "checking"
      ],
      "description": "U.S. deposit category: savings (alias hysa), cds, money-market (alias mma), or checking."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "approvedOnly": {
      "type": "boolean",
      "description": "Require an editor-approved deposit snapshot. Savings, CDs, checking and money market always answer from their own approved release; a category with no release yet returns no ranked rates (approval_status: not_yet_approved), as do stale or unavailable releases."
    },
    "detail": {
      "type": "string",
      "enum": [
        "summary",
        "full"
      ],
      "description": "summary (default) adds list_counts. full (savings) adds the complete shared build: accounts (verified and tracked, each marked), best_picks, movers, history and summary. rates stays verified-only either way."
    }
  },
  "required": [
    "category"
  ],
  "additionalProperties": false
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "releaseId": {
      "type": [
        "string",
        "null"
      ]
    },
    "releaseStatus": {
      "type": "string",
      "enum": [
        "observed",
        "unavailable"
      ]
    },
    "releaseSize": {
      "type": "number"
    },
    "category": {
      "type": "string"
    },
    "rate_type": {
      "type": "string",
      "enum": [
        "APY",
        "APR"
      ]
    },
    "count": {
      "type": "number"
    },
    "asOf": {
      "type": [
        "string",
        "null"
      ]
    },
    "generatedAt": {
      "type": "string"
    },
    "freshnessStatus": {
      "type": "string",
      "enum": [
        "fresh",
        "aging",
        "stale",
        "unavailable"
      ]
    },
    "attribution": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "object",
          "additionalProperties": true
        }
      ]
    },
    "attributionDetails": {
      "type": "object",
      "additionalProperties": true
    },
    "source": {
      "type": "string"
    },
    "sourceDetails": {
      "type": "object",
      "additionalProperties": true
    },
    "methodologyUrl": {
      "type": "string"
    },
    "terms": {
      "type": "string"
    },
    "supportedCategories": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "dataStatus": {
      "type": "string",
      "enum": [
        "available",
        "no_observations",
        "no_eligible_rates",
        "source_error",
        "unavailable",
        "stale",
        "conflicted"
      ]
    },
    "emptyReason": {
      "type": [
        "string",
        "null"
      ]
    },
    "rates": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "tool": {
      "type": "string"
    },
    "toolMeta": {
      "type": "object",
      "description": "Version and stability of the tool that produced this reply. See /developers#tool-versions.",
      "properties": {
        "version": {
          "type": "string"
        },
        "stability": {
          "type": "string",
          "enum": [
            "stable",
            "beta"
          ]
        },
        "changelogUrl": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        },
        "suggestions": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "object",
                "additionalProperties": true
              }
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "schemaVersion",
    "generatedAt"
  ],
  "anyOf": [
    {
      "required": [
        "category",
        "count",
        "freshnessStatus",
        "rates"
      ],
      "properties": {
        "attribution": {
          "type": "string"
        }
      }
    },
    {
      "required": [
        "tool",
        "error",
        "attribution"
      ],
      "properties": {
        "attribution": {
          "type": "object",
          "additionalProperties": true
        }
      }
    }
  ],
  "additionalProperties": true
}
🟢get_top_hysa_rates(limit, approvedOnly, detail)

Return top high-yield savings rates with freshness and attribution. Answers only from the editor-approved snapshot; before its first release it returns no ranked rates and says so (approval_status: not_yet_approved). approvedOnly makes the requirement explicit. detail=full adds every listed account marked verified or tracked, best picks, movers, history and a headline summary.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "approvedOnly": {
      "type": "boolean",
      "description": "Require an editor-approved HYSA snapshot. The default tool already answers only from the approved release; before its first release it returns no ranked rates (approval_status: not_yet_approved)."
    },
    "detail": {
      "type": "string",
      "enum": [
        "summary",
        "full"
      ],
      "description": "summary (default) adds list_counts. full (savings) adds the complete shared build: accounts (verified and tracked, each marked), best_picks, movers, history and summary. rates stays verified-only either way."
    }
  },
  "additionalProperties": false
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "releaseId": {
      "type": [
        "string",
        "null"
      ]
    },
    "releaseStatus": {
      "type": "string",
      "enum": [
        "observed",
        "unavailable"
      ]
    },
    "releaseSize": {
      "type": "number"
    },
    "category": {
      "type": "string"
    },
    "rate_type": {
      "type": "string",
      "enum": [
        "APY",
        "APR"
      ]
    },
    "count": {
      "type": "number"
    },
    "asOf": {
      "type": [
        "string",
        "null"
      ]
    },
    "generatedAt": {
      "type": "string"
    },
    "freshnessStatus": {
      "type": "string",
      "enum": [
        "fresh",
        "aging",
        "stale",
        "unavailable"
      ]
    },
    "attribution": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "object",
          "additionalProperties": true
        }
      ]
    },
    "attributionDetails": {
      "type": "object",
      "additionalProperties": true
    },
    "source": {
      "type": "string"
    },
    "sourceDetails": {
      "type": "object",
      "additionalProperties": true
    },
    "methodologyUrl": {
      "type": "string"
    },
    "terms": {
      "type": "string"
    },
    "supportedCategories": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "dataStatus": {
      "type": "string",
      "enum": [
        "available",
        "no_observations",
        "no_eligible_rates",
        "source_error",
        "unavailable",
        "stale",
        "conflicted"
      ]
    },
    "emptyReason": {
      "type": [
        "string",
        "null"
      ]
    },
    "rates": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "tool": {
      "type": "string"
    },
    "toolMeta": {
      "type": "object",
      "description": "Version and stability of the tool that produced this reply. See /developers#tool-versions.",
      "properties": {
        "version": {
          "type": "string"
        },
        "stability": {
          "type": "string",
          "enum": [
            "stable",
            "beta"
          ]
        },
        "changelogUrl": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        },
        "suggestions": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "object",
                "additionalProperties": true
              }
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "schemaVersion",
    "generatedAt"
  ],
  "anyOf": [
    {
      "required": [
        "category",
        "count",
        "freshnessStatus",
        "rates"
      ],
      "properties": {
        "attribution": {
          "type": "string"
        }
      }
    },
    {
      "required": [
        "tool",
        "error",
        "attribution"
      ],
      "properties": {
        "attribution": {
          "type": "object",
          "additionalProperties": true
        }
      }
    }
  ],
  "additionalProperties": true
}
🟢get_bank_gap(bank, balance)

Estimate annual savings interest forgone for a supplied balance and optional bank name. comparisonApy is the average of the top three tracked savings rates, not an average across all banks; bankCount is the size of the tracked set. baselineApy is the named bank's APY, or the national savings benchmark when no bank is supplied. Return annualGap, APYs, observation date, freshness and methodology. This is a hypothetical estimate, not guaranteed savings or an account recommendation; verify eligibility, fees and current provider terms.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "bank": {
      "type": "string",
      "description": "Optional bank name for user-facing context."
    },
    "balance": {
      "type": "number",
      "minimum": 0,
      "maximum": 10000000
    }
  },
  "additionalProperties": false
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string"
    },
    "tool": {
      "type": "string"
    },
    "generatedAt": {
      "type": "string",
      "description": "ISO timestamp this response was computed at."
    },
    "attribution": {
      "type": "object",
      "additionalProperties": true
    },
    "source": {
      "type": "string",
      "description": "Where the data comes from (URL)."
    },
    "toolMeta": {
      "type": "object",
      "description": "Version and stability of the tool that produced this reply. See /developers#tool-versions.",
      "properties": {
        "version": {
          "type": "string"
        },
        "stability": {
          "type": "string",
          "enum": [
            "stable",
            "beta"
          ]
        },
        "changelogUrl": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "asOf": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO timestamp of the underlying data this response reflects."
    },
    "verified_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "freshnessStatus": {
      "type": "string",
      "enum": [
        "fresh",
        "aging",
        "stale",
        "unavailable"
      ]
    },
    "methodologyUrl": {
      "type": "string"
    },
    "bank": {
      "type": [
        "object",
        "string",
        "null"
      ]
    },
    "balance": {
      "type": "number"
    },
    "annualGap": {
      "type": "number"
    },
    "bankApy": {
      "type": [
        "number",
        "null"
      ]
    },
    "baselineApy": {
      "type": "number",
      "description": "Named bank APY, or national savings benchmark when no bank is supplied. Percentage units."
    },
    "comparisonApy": {
      "type": "number",
      "description": "Average of the top three tracked savings rates (or all available rates if fewer than three). Not an average across bankCount banks. Percentage units."
    },
    "bankCount": {
      "type": "number",
      "description": "Number of tracked banks in the comparison set, not the number averaged into comparisonApy."
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        },
        "suggestions": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "object",
                "additionalProperties": true
              }
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "schemaVersion",
    "tool",
    "generatedAt"
  ],
  "additionalProperties": true
}
🟢compare_switch_savings(currentApy, balance)

Compare a user's current APY with SwitchWize's current top savings APY for a balance.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "currentApy": {
      "type": "number",
      "minimum": 0,
      "maximum": 25
    },
    "balance": {
      "type": "number",
      "minimum": 0,
      "maximum": 10000000
    }
  },
  "required": [
    "currentApy"
  ],
  "additionalProperties": false
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string"
    },
    "tool": {
      "type": "string"
    },
    "generatedAt": {
      "type": "string",
      "description": "ISO timestamp this response was computed at."
    },
    "attribution": {
      "type": "object",
      "additionalProperties": true
    },
    "source": {
      "type": "string",
      "description": "Where the data comes from (URL)."
    },
    "toolMeta": {
      "type": "object",
      "description": "Version and stability of the tool that produced this reply. See /developers#tool-versions.",
      "properties": {
        "version": {
          "type": "string"
        },
        "stability": {
          "type": "string",
          "enum": [
            "stable",
            "beta"
          ]
        },
        "changelogUrl": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "asOf": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO timestamp of the underlying data this response reflects."
    },
    "verified_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "freshnessStatus": {
      "type": "string",
      "enum": [
        "fresh",
        "aging",
        "stale",
        "unavailable"
      ]
    },
    "methodologyUrl": {
      "type": "string"
    },
    "balance": {
      "type": "number"
    },
    "currentApy": {
      "type": "number"
    },
    "comparisonApy": {
      "type": [
        "number",
        "null"
      ]
    },
    "currentInterest": {
      "type": "number"
    },
    "comparisonInterest": {
      "type": [
        "number",
        "null"
      ]
    },
    "annualGap": {
      "type": [
        "number",
        "null"
      ]
    },
    "recommendationStatus": {
      "type": "string",
      "enum": [
        "comparison_available",
        "data_unavailable"
      ]
    },
    "breakEvenFraming": {
      "type": "string"
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        },
        "suggestions": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "object",
                "additionalProperties": true
              }
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "schemaVersion",
    "tool",
    "generatedAt"
  ],
  "additionalProperties": true
}
🟢get_rate_freshness(category)

Return public data source freshness status and affected routes. savings is an alias for hysa; money-market is an alias for mma. Also supports cds, checking, macro, bank-gap-index, and indices. Omit category for all supported sources. Unknown categories return an error; a source with no observations is explicitly unavailable. Source collection freshness does not establish that a ranked deposit release is approved or current.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "savings",
        "hysa",
        "cds",
        "money-market",
        "mma",
        "checking",
        "macro",
        "bank-gap-index",
        "indices"
      ],
      "description": "Optional freshness category. savings maps to hysa; money-market maps to mma. Also supports cds, checking, macro, bank-gap-index, and indices. Omit for all supported sources. Unknown values return an error; a known source without observations is unavailable."
    }
  },
  "additionalProperties": false
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string"
    },
    "tool": {
      "type": "string"
    },
    "generatedAt": {
      "type": "string",
      "description": "ISO timestamp this response was computed at."
    },
    "attribution": {
      "type": "object",
      "additionalProperties": true
    },
    "source": {
      "type": "string",
      "description": "Where the data comes from (URL)."
    },
    "toolMeta": {
      "type": "object",
      "description": "Version and stability of the tool that produced this reply. See /developers#tool-versions.",
      "properties": {
        "version": {
          "type": "string"
        },
        "stability": {
          "type": "string",
          "enum": [
            "stable",
            "beta"
          ]
        },
        "changelogUrl": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "affectedRoutes": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        },
        "suggestions": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "object",
                "additionalProperties": true
              }
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "schemaVersion",
    "tool",
    "generatedAt"
  ],
  "additionalProperties": true
}
🟢get_index_dataset(indexId, limit)

Return a SwitchWize index dataset summary and recent series.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "indexId": {
      "type": "string",
      "description": "Index id, e.g. bank-gap-index, cd-spread, mma-spread, checking-gap."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 60
    }
  },
  "required": [
    "indexId"
  ],
  "additionalProperties": false
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string"
    },
    "tool": {
      "type": "string"
    },
    "generatedAt": {
      "type": "string",
      "description": "ISO timestamp this response was computed at."
    },
    "attribution": {
      "type": "object",
      "additionalProperties": true
    },
    "source": {
      "type": "string",
      "description": "Where the data comes from (URL)."
    },
    "toolMeta": {
      "type": "object",
      "description": "Version and stability of the tool that produced this reply. See /developers#tool-versions.",
      "properties": {
        "version": {
          "type": "string"
        },
        "stability": {
          "type": "string",
          "enum": [
            "stable",
            "beta"
          ]
        },
        "changelogUrl": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "asOf": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO timestamp of the underlying data this response reflects."
    },
    "verified_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "freshnessStatus": {
      "type": "string",
      "enum": [
        "fresh",
        "aging",
        "stale",
        "unavailable"
      ]
    },
    "methodologyUrl": {
      "type": "string"
    },
    "index_id": {
      "type": "string"
    },
    "label": {
      "type": "string"
    },
    "series": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        },
        "suggestions": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "object",
                "additionalProperties": true
              }
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "schemaVersion",
    "tool",
    "generatedAt"
  ],
  "additionalProperties": true
}
🟢get_bank_gap_index

Return the current SwitchWize Bank Gap Index headline value, latest release, and methodology URL.

Eingabe-Schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string"
    },
    "tool": {
      "type": "string"
    },
    "generatedAt": {
      "type": "string",
      "description": "ISO timestamp this response was computed at."
    },
    "attribution": {
      "type": "object",
      "additionalProperties": true
    },
    "source": {
      "type": "string",
      "description": "Where the data comes from (URL)."
    },
    "toolMeta": {
      "type": "object",
      "description": "Version and stability of the tool that produced this reply. See /developers#tool-versions.",
      "properties": {
        "version": {
          "type": "string"
        },
        "stability": {
          "type": "string",
          "enum": [
            "stable",
            "beta"
          ]
        },
        "changelogUrl": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "asOf": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO timestamp of the underlying data this response reflects."
    },
    "verified_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "freshnessStatus": {
      "type": "string",
      "enum": [
        "fresh",
        "aging",
        "stale",
        "unavailable"
      ]
    },
    "methodologyUrl": {
      "type": "string"
    },
    "index_id": {
      "type": "string"
    },
    "label": {
      "type": "string"
    },
    "headlineValue": {
      "type": [
        "number",
        "null"
      ]
    },
    "month": {
      "type": [
        "string",
        "null"
      ]
    },
    "nationalAvgApy": {
      "type": [
        "number",
        "null"
      ]
    },
    "topAvgApy": {
      "type": [
        "number",
        "null"
      ]
    },
    "gapPoints": {
      "type": [
        "number",
        "null"
      ]
    },
    "banksTracked": {
      "type": [
        "number",
        "null"
      ]
    },
    "datasetUrl": {
      "type": "string"
    },
    "releaseArchiveUrl": {
      "type": "string"
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        },
        "suggestions": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "object",
                "additionalProperties": true
              }
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "schemaVersion",
    "tool",
    "generatedAt"
  ],
  "additionalProperties": true
}
🟢get_reality_score(card, segment)

Estimate the modeled annual value of a supported premium credit card for a consumer segment. Supply a card slug or name and optionally a segment ID; the default is occasional-traveler. Return segment assumptions, score, rewards, credits, perks, fee, interest, friction, net value, caveats, sources, verification date, freshness and methodology. Gross recovered value is rewards + credits + perks. breakageMultiplier is gross recovered value / advertised value, NOT divided by annual fee. feeRecoveryMultiplier is max(0, gross recovered value - interest drag - rewards friction discount) / annual fee, before subtracting the fee. Friction applies to raw rewards only. Reality Score is 100 * net realized value / advertised value. Ratios are rounded. These are scenario estimates, not personalized advice or guaranteed benefits. Preserve stale or unavailable labels; do not infer that all terms share the observation date. Unknown cards or segments return a structured error with suggestions.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "card": {
      "type": "string",
      "description": "Card slug or name, e.g. platinum-card or Chase Sapphire Reserve."
    },
    "segment": {
      "type": "string",
      "description": "Optional segment id, e.g. occasional-traveler, small-business-owner, balance-carrier."
    }
  },
  "required": [
    "card"
  ],
  "additionalProperties": false
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string"
    },
    "tool": {
      "type": "string"
    },
    "generatedAt": {
      "type": "string",
      "description": "ISO timestamp this response was computed at."
    },
    "attribution": {
      "type": "object",
      "additionalProperties": true
    },
    "source": {
      "type": "string",
      "description": "Where the data comes from (URL)."
    },
    "toolMeta": {
      "type": "object",
      "description": "Version and stability of the tool that produced this reply. See /developers#tool-versions.",
      "properties": {
        "version": {
          "type": "string"
        },
        "stability": {
          "type": "string",
          "enum": [
            "stable",
            "beta"
          ]
        },
        "changelogUrl": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "asOf": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO timestamp of the underlying data this response reflects."
    },
    "verified_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "freshnessStatus": {
      "type": "string",
      "enum": [
        "fresh",
        "aging",
        "stale",
        "unavailable"
      ]
    },
    "methodologyUrl": {
      "type": "string"
    },
    "index_id": {
      "type": "string"
    },
    "segment": {
      "type": "object",
      "additionalProperties": true
    },
    "result": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "advertisedValue": {
          "type": "number"
        },
        "realizedRewards": {
          "type": "number"
        },
        "realizedStatementCredits": {
          "type": "number"
        },
        "realizedPerks": {
          "type": "number"
        },
        "annualFee": {
          "type": "number"
        },
        "interestDrag": {
          "type": "number"
        },
        "redemptionFrictionDiscount": {
          "type": "number",
          "description": "Discount applied to raw rewards, not to credits or perks."
        },
        "realizedValue": {
          "type": "number",
          "description": "Rewards + credits + perks minus annual fee, interest drag and rewards friction discount."
        },
        "realityScore": {
          "type": "number",
          "description": "100 * net realized value / advertised value, rounded to an integer."
        },
        "breakageMultiplier": {
          "type": "number",
          "description": "Gross recovered value (rewards + credits + perks) / advertised value, rounded to two decimals. Annual fee is not this denominator."
        },
        "feeRecoveryMultiplier": {
          "type": "number",
          "description": "max(0, gross recovered value - interest drag - rewards friction discount) / annual fee, rounded to two decimals; before subtracting the annual fee."
        }
      },
      "additionalProperties": true
    },
    "datasetUrl": {
      "type": "string"
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        },
        "suggestions": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "object",
                "additionalProperties": true
              }
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "schemaVersion",
    "tool",
    "generatedAt"
  ],
  "additionalProperties": true
}
🟢get_card_offers(card, limit)

Return current credit-card welcome-bonus offers (non-targeted, confidence-gated), each with a verified timestamp, source URL, and the card's own 12-month best.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "card": {
      "type": "string",
      "description": "Optional card id (issuer:slug), slug, or name to filter to one card, e.g. chase:sapphire-preferred or Sapphire Preferred."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "additionalProperties": false
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string"
    },
    "tool": {
      "type": "string"
    },
    "generatedAt": {
      "type": "string",
      "description": "ISO timestamp this response was computed at."
    },
    "attribution": {
      "type": "object",
      "additionalProperties": true
    },
    "source": {
      "type": "string",
      "description": "Where the data comes from (URL)."
    },
    "toolMeta": {
      "type": "object",
      "description": "Version and stability of the tool that produced this reply. See /developers#tool-versions.",
      "properties": {
        "version": {
          "type": "string"
        },
        "stability": {
          "type": "string",
          "enum": [
            "stable",
            "beta"
          ]
        },
        "changelogUrl": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "asOf": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO timestamp of the underlying data this response reflects."
    },
    "verified_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "freshnessStatus": {
      "type": "string",
      "enum": [
        "fresh",
        "aging",
        "stale",
        "unavailable"
      ]
    },
    "methodologyUrl": {
      "type": "string"
    },
    "count": {
      "type": "number"
    },
    "totalTracked": {
      "type": "number"
    },
    "offers": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "datasetUrl": {
      "type": "string"
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        },
        "suggestions": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "object",
                "additionalProperties": true
              }
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "schemaVersion",
    "tool",
    "generatedAt"
  ],
  "additionalProperties": true
}
🟢get_transfer_bonuses(program)

Return current point-transfer bonuses across tracked bank-to-partner routes, each with a verified timestamp, source URL, and best-ever-for-route when real history exists.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "program": {
      "type": "string",
      "description": "Optional program id or name to filter routes by source or destination, e.g. chase-ultimate-rewards or Flying Blue."
    }
  },
  "additionalProperties": false
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string"
    },
    "tool": {
      "type": "string"
    },
    "generatedAt": {
      "type": "string",
      "description": "ISO timestamp this response was computed at."
    },
    "attribution": {
      "type": "object",
      "additionalProperties": true
    },
    "source": {
      "type": "string",
      "description": "Where the data comes from (URL)."
    },
    "toolMeta": {
      "type": "object",
      "description": "Version and stability of the tool that produced this reply. See /developers#tool-versions.",
      "properties": {
        "version": {
          "type": "string"
        },
        "stability": {
          "type": "string",
          "enum": [
            "stable",
            "beta"
          ]
        },
        "changelogUrl": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "asOf": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO timestamp of the underlying data this response reflects."
    },
    "verified_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "freshnessStatus": {
      "type": "string",
      "enum": [
        "fresh",
        "aging",
        "stale",
        "unavailable"
      ]
    },
    "methodologyUrl": {
      "type": "string"
    },
    "count": {
      "type": "number"
    },
    "routes": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "datasetUrl": {
      "type": "string"
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        },
        "suggestions": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "object",
                "additionalProperties": true
              }
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "schemaVersion",
    "tool",
    "generatedAt"
  ],
  "additionalProperties": true
}
🟢get_card_changes(sinceDays, limit)

Return recent verified credit-card fee and APR changes, most recent first. Each event is a diff between two confirmed snapshots of the same card.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "sinceDays": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Only changes observed within this many days."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "additionalProperties": false
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string"
    },
    "tool": {
      "type": "string"
    },
    "generatedAt": {
      "type": "string",
      "description": "ISO timestamp this response was computed at."
    },
    "attribution": {
      "type": "object",
      "additionalProperties": true
    },
    "source": {
      "type": "string",
      "description": "Where the data comes from (URL)."
    },
    "toolMeta": {
      "type": "object",
      "description": "Version and stability of the tool that produced this reply. See /developers#tool-versions.",
      "properties": {
        "version": {
          "type": "string"
        },
        "stability": {
          "type": "string",
          "enum": [
            "stable",
            "beta"
          ]
        },
        "changelogUrl": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "asOf": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO timestamp of the underlying data this response reflects."
    },
    "verified_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "freshnessStatus": {
      "type": "string",
      "enum": [
        "fresh",
        "aging",
        "stale",
        "unavailable"
      ]
    },
    "methodologyUrl": {
      "type": "string"
    },
    "sinceDays": {
      "type": [
        "number",
        "null"
      ]
    },
    "count": {
      "type": "number"
    },
    "changes": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "datasetUrl": {
      "type": "string"
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        },
        "suggestions": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "object",
                "additionalProperties": true
              }
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "schemaVersion",
    "tool",
    "generatedAt"
  ],
  "additionalProperties": true
}
🟢get_reward_valuations(currency)

Return SwitchWize points/miles valuations (cents per point) per reward currency, with sample size and provisional/published status.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "currency": {
      "type": "string",
      "description": "Optional reward currency id or name, e.g. chase-ultimate-rewards or Membership Rewards."
    }
  },
  "additionalProperties": false
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string"
    },
    "tool": {
      "type": "string"
    },
    "generatedAt": {
      "type": "string",
      "description": "ISO timestamp this response was computed at."
    },
    "attribution": {
      "type": "object",
      "additionalProperties": true
    },
    "source": {
      "type": "string",
      "description": "Where the data comes from (URL)."
    },
    "toolMeta": {
      "type": "object",
      "description": "Version and stability of the tool that produced this reply. See /developers#tool-versions.",
      "properties": {
        "version": {
          "type": "string"
        },
        "stability": {
          "type": "string",
          "enum": [
            "stable",
            "beta"
          ]
        },
        "changelogUrl": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "asOf": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO timestamp of the underlying data this response reflects."
    },
    "verified_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "freshnessStatus": {
      "type": "string",
      "enum": [
        "fresh",
        "aging",
        "stale",
        "unavailable"
      ]
    },
    "methodologyUrl": {
      "type": "string"
    },
    "count": {
      "type": "number"
    },
    "valuations": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "datasetUrl": {
      "type": "string"
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        },
        "suggestions": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "object",
                "additionalProperties": true
              }
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "schemaVersion",
    "tool",
    "generatedAt"
  ],
  "additionalProperties": true
}
🟢best_move_this_week(wallet, categories, usedBenefits, savingsBalance, currentSavingsApy)

Given the credit cards a user holds, rank this week's dollar-valued actions: which held card to use per spend category, welcome offers at a 12-month high on cards not held, active transfer bonuses, and (optionally) the savings-rate move beside the card move.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 25,
      "description": "Card ids the user holds, in the form issuer:slug, e.g. [\"chase:sapphire-preferred\", \"amex:gold-card\"]."
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "dining",
          "rideshare",
          "travel",
          "lounge",
          "entertainment",
          "insurance",
          "groceries",
          "gas",
          "other"
        ]
      },
      "description": "Optional spend categories to rank held cards for; defaults to all nine."
    },
    "usedBenefits": {
      "type": "array",
      "maxItems": 200,
      "items": {
        "type": "object",
        "properties": {
          "cardId": {
            "type": "string"
          },
          "benefitKey": {
            "type": "string"
          },
          "periodStart": {
            "type": "string",
            "description": "ISO first-of-month key for the period the credit was used in, e.g. 2026-09-01T00:00:00.000Z."
          }
        },
        "required": [
          "cardId",
          "benefitKey",
          "periodStart"
        ],
        "additionalProperties": false
      },
      "description": "Optional log of period credits already used this month; excluded from picks and counted toward renewal value. Omit to treat every credit as unused."
    },
    "savingsBalance": {
      "type": "number",
      "minimum": 0,
      "maximum": 10000000,
      "description": "Optional cash balance, to include the savings-rate move beside the card moves."
    },
    "currentSavingsApy": {
      "type": "number",
      "minimum": 0,
      "maximum": 25,
      "description": "Optional current savings APY, used with savingsBalance."
    }
  },
  "required": [
    "wallet"
  ],
  "additionalProperties": false
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string"
    },
    "tool": {
      "type": "string"
    },
    "generatedAt": {
      "type": "string",
      "description": "ISO timestamp this response was computed at."
    },
    "attribution": {
      "type": "object",
      "additionalProperties": true
    },
    "source": {
      "type": "string",
      "description": "Where the data comes from (URL)."
    },
    "toolMeta": {
      "type": "object",
      "description": "Version and stability of the tool that produced this reply. See /developers#tool-versions.",
      "properties": {
        "version": {
          "type": "string"
        },
        "stability": {
          "type": "string",
          "enum": [
            "stable",
            "beta"
          ]
        },
        "changelogUrl": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "asOf": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO timestamp of the underlying data this response reflects."
    },
    "verified_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "freshnessStatus": {
      "type": "string",
      "enum": [
        "fresh",
        "aging",
        "stale",
        "unavailable"
      ]
    },
    "methodologyUrl": {
      "type": "string"
    },
    "cardMoves": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "unheldOffers": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "transferBonuses": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "savingsMove": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": true
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        },
        "suggestions": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "object",
                "additionalProperties": true
              }
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "schemaVersion",
    "tool",
    "generatedAt"
  ],
  "additionalProperties": true
}
🟢get_cd_rollover_rules(institutionId)

Return verified CD rollover rules for one bank, or every bank SwitchWize has verified: what happens automatically at maturity if the customer does nothing, the grace period, how to stop the rollover, and the early-withdrawal penalty. Each fact is sourced directly from the bank's own disclosure; an unverified field is omitted, never guessed.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "institutionId": {
      "type": "string",
      "description": "Optional institution_registry id, e.g. chase, american-express, wells-fargo. Omit to return every bank SwitchWize has verified."
    }
  },
  "additionalProperties": false
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string"
    },
    "tool": {
      "type": "string"
    },
    "generatedAt": {
      "type": "string",
      "description": "ISO timestamp this response was computed at."
    },
    "attribution": {
      "type": "object",
      "additionalProperties": true
    },
    "source": {
      "type": "string",
      "description": "Where the data comes from (URL)."
    },
    "toolMeta": {
      "type": "object",
      "description": "Version and stability of the tool that produced this reply. See /developers#tool-versions.",
      "properties": {
        "version": {
          "type": "string"
        },
        "stability": {
          "type": "string",
          "enum": [
            "stable",
            "beta"
          ]
        },
        "changelogUrl": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "asOf": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO timestamp of the underlying data this response reflects."
    },
    "verified_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "freshnessStatus": {
      "type": "string",
      "enum": [
        "fresh",
        "aging",
        "stale",
        "unavailable"
      ]
    },
    "methodologyUrl": {
      "type": "string"
    },
    "institutionId": {
      "type": "string"
    },
    "autoRenewDefault": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "autoRenewDescription": {
      "type": "string"
    },
    "gracePeriodDays": {
      "type": [
        "number",
        "null"
      ]
    },
    "earlyWithdrawalPenalty": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "sourceUrl": {
      "type": [
        "string",
        "null"
      ]
    },
    "count": {
      "type": "number"
    },
    "institutions": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "datasetUrl": {
      "type": "string"
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        },
        "suggestions": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "object",
                "additionalProperties": true
              }
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "schemaVersion",
    "tool",
    "generatedAt"
  ],
  "additionalProperties": true
}
🟢get_card_downgrade_path(cardId)

Return verified credit-card product-change (downgrade) paths and the issuer's fee-refund window: which no-fee or lower-fee card a given card can be product-changed to, and how long after the annual fee posts a refund is available on cancellation. Optionally filtered to one card id (issuer:slug); returns every verified path and window when omitted.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "cardId": {
      "type": "string",
      "description": "Optional card id (issuer:slug), e.g. chase:sapphire-reserve or capital-one:venture-x-rewards. Omit to return every verified downgrade path and fee-refund window."
    }
  },
  "additionalProperties": false
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string"
    },
    "tool": {
      "type": "string"
    },
    "generatedAt": {
      "type": "string",
      "description": "ISO timestamp this response was computed at."
    },
    "attribution": {
      "type": "object",
      "additionalProperties": true
    },
    "source": {
      "type": "string",
      "description": "Where the data comes from (URL)."
    },
    "toolMeta": {
      "type": "object",
      "description": "Version and stability of the tool that produced this reply. See /developers#tool-versions.",
      "properties": {
        "version": {
          "type": "string"
        },
        "stability": {
          "type": "string",
          "enum": [
            "stable",
            "beta"
          ]
        },
        "changelogUrl": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "asOf": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO timestamp of the underlying data this response reflects."
    },
    "verified_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "freshnessStatus": {
      "type": "string",
      "enum": [
        "fresh",
        "aging",
        "stale",
        "unavailable"
      ]
    },
    "methodologyUrl": {
      "type": "string"
    },
    "cardId": {
      "type": "string"
    },
    "downgradePaths": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "feeRefundWindow": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": true
    },
    "feeRefundWindows": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "count": {
      "type": "number"
    },
    "datasetUrl": {
      "type": "string"
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        },
        "suggestions": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "object",
                "additionalProperties": true
              }
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "schemaVersion",
    "tool",
    "generatedAt"
  ],
  "additionalProperties": true
}
🟢get_fed_hike_pass_through(institutionId)

Return how much of the latest Federal Reserve rate hike each tracked savings account has passed through to savers so far: rate before the hike, rate now, change in basis points, pass-through share, and days until the bank moved. One source per bank; each row carries its source type and observation dates. Optionally filtered to one institution id.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "institutionId": {
      "type": "string",
      "description": "Optional institution_registry id, e.g. tab, ally, marcus. Omit to return every savings account measured against the latest Fed hike."
    }
  },
  "additionalProperties": false
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string"
    },
    "tool": {
      "type": "string"
    },
    "generatedAt": {
      "type": "string",
      "description": "ISO timestamp this response was computed at."
    },
    "attribution": {
      "type": "object",
      "additionalProperties": true
    },
    "source": {
      "type": "string",
      "description": "Where the data comes from (URL)."
    },
    "toolMeta": {
      "type": "object",
      "description": "Version and stability of the tool that produced this reply. See /developers#tool-versions.",
      "properties": {
        "version": {
          "type": "string"
        },
        "stability": {
          "type": "string",
          "enum": [
            "stable",
            "beta"
          ]
        },
        "changelogUrl": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "asOf": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO timestamp of the underlying data this response reflects."
    },
    "verified_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "freshnessStatus": {
      "type": "string",
      "enum": [
        "fresh",
        "aging",
        "stale",
        "unavailable"
      ]
    },
    "methodologyUrl": {
      "type": "string"
    },
    "move": {
      "type": "object",
      "additionalProperties": true
    },
    "daysSinceAnnouncement": {
      "type": [
        "number",
        "null"
      ]
    },
    "summary": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": true
    },
    "excluded": {
      "type": "object",
      "additionalProperties": true
    },
    "institution": {
      "type": "object",
      "additionalProperties": true
    },
    "count": {
      "type": "number"
    },
    "institutions": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "datasetUrl": {
      "type": "string"
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        },
        "suggestions": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "object",
                "additionalProperties": true
              }
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "schemaVersion",
    "tool",
    "generatedAt"
  ],
  "additionalProperties": true
}
🟢compare_accounts(category, accounts, balance, termMonths)

Compare two to five named banks on the editor-approved rates for savings, money market, checking or CDs (CDs by termMonths, default 12). For a balance, return each bank's APY, yearly interest, the gap to the best bank in your set and to the best verified rate, with verified date and source. Only banks in the approved set can be compared; a category with no current approved release returns data_unavailable and no rates. Illustrative interest before taxes, not a recommendation; verify eligibility and minimums.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "savings",
        "mma",
        "checking",
        "cds"
      ]
    },
    "accounts": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 80
      },
      "minItems": 2,
      "maxItems": 5,
      "description": "Two to five bank names or ids, e.g. [\"Ally\", \"Capital One\"]."
    },
    "balance": {
      "type": "number",
      "minimum": 0,
      "maximum": 10000000,
      "description": "Dollars. Default 10000."
    },
    "termMonths": {
      "type": "integer",
      "minimum": 1,
      "maximum": 120,
      "description": "CDs only. Default 12."
    }
  },
  "required": [
    "category",
    "accounts"
  ],
  "additionalProperties": false
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string"
    },
    "tool": {
      "type": "string"
    },
    "generatedAt": {
      "type": "string",
      "description": "ISO timestamp this response was computed at."
    },
    "attribution": {
      "type": "object",
      "additionalProperties": true
    },
    "source": {
      "type": "string",
      "description": "Where the data comes from (URL)."
    },
    "toolMeta": {
      "type": "object",
      "description": "Version and stability of the tool that produced this reply. See /developers#tool-versions.",
      "properties": {
        "version": {
          "type": "string"
        },
        "stability": {
          "type": "string",
          "enum": [
            "stable",
            "beta"
          ]
        },
        "changelogUrl": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "asOf": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO timestamp of the underlying data this response reflects."
    },
    "verified_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "freshnessStatus": {
      "type": "string",
      "enum": [
        "fresh",
        "aging",
        "stale",
        "unavailable"
      ]
    },
    "methodologyUrl": {
      "type": "string"
    },
    "category": {
      "type": "string"
    },
    "balance": {
      "type": "number"
    },
    "comparison_status": {
      "type": "string",
      "enum": [
        "comparison_available",
        "partial",
        "data_unavailable"
      ]
    },
    "accounts": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "notFound": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "winner": {
      "type": [
        "object",
        "null"
      ]
    },
    "bestVerified": {
      "type": [
        "object",
        "null"
      ]
    },
    "note": {
      "type": "string"
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        },
        "suggestions": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "object",
                "additionalProperties": true
              }
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "schemaVersion",
    "tool",
    "generatedAt"
  ],
  "additionalProperties": true
}
🟢business_card_cost(monthlySpend, monthlyBonusCategorySpend, foreignSharePct, latePaymentsPerYear)

Estimate yearly rewards minus annual, foreign and late fees for four small-business credit cards, given monthly spend, spend in the bonus category, share of spend abroad and late payments per year. Fees come from issuer pages a reviewer read and quoted; a fee with no current quote is marked not verified and left out of the ranking, never treated as zero. Excludes welcome bonuses, credits, interest and approval odds. Pay-in-full scenario, not personalized advice.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "monthlySpend": {
      "type": "number",
      "minimum": 0,
      "maximum": 5000000,
      "description": "Business card spend per month in dollars. Default 5000."
    },
    "monthlyBonusCategorySpend": {
      "type": "number",
      "minimum": 0,
      "maximum": 5000000,
      "description": "Part of monthlySpend in a bonus category (for example shipping or advertising). Default 0."
    },
    "foreignSharePct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Percent of spend made abroad. Default 0."
    },
    "latePaymentsPerYear": {
      "type": "integer",
      "minimum": 0,
      "maximum": 120,
      "description": "Late payments per year. Default 0."
    }
  },
  "additionalProperties": false
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string"
    },
    "tool": {
      "type": "string"
    },
    "generatedAt": {
      "type": "string",
      "description": "ISO timestamp this response was computed at."
    },
    "attribution": {
      "type": "object",
      "additionalProperties": true
    },
    "source": {
      "type": "string",
      "description": "Where the data comes from (URL)."
    },
    "toolMeta": {
      "type": "object",
      "description": "Version and stability of the tool that produced this reply. See /developers#tool-versions.",
      "properties": {
        "version": {
          "type": "string"
        },
        "stability": {
          "type": "string",
          "enum": [
            "stable",
            "beta"
          ]
        },
        "changelogUrl": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "asOf": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO timestamp of the underlying data this response reflects."
    },
    "verified_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "freshnessStatus": {
      "type": "string",
      "enum": [
        "fresh",
        "aging",
        "stale",
        "unavailable"
      ]
    },
    "methodologyUrl": {
      "type": "string"
    },
    "comparison_status": {
      "type": "string",
      "enum": [
        "comparison_available",
        "data_unavailable"
      ]
    },
    "cards": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "winner": {
      "type": [
        "object",
        "null"
      ]
    },
    "recommendation": {
      "type": "string"
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "assumptions": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "verifiedThrough": {
      "type": [
        "string",
        "null"
      ]
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        },
        "suggestions": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "object",
                "additionalProperties": true
              }
            ]
          }
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "schemaVersion",
    "tool",
    "generatedAt"
  ],
  "additionalProperties": true
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet18 Tools
verifiziertVersion nicht aufgezeichnet16 Tools
verifiziertVersion nicht aufgezeichnet16 Tools
verifiziertVersion nicht aufgezeichnet16 Tools
verifiziertVersion nicht aufgezeichnet16 Tools
verifiziertVersion nicht aufgezeichnet16 Tools
verifiziertVersion nicht aufgezeichnet15 Tools