Benefits City
US bank, savings and credit-card signup bonuses, each source-checked, with expiry dates.
사용해야 할까요
품질 및 안전성
A
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
~3,320토큰 (도구 정의)
~6.1 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 2.59%)
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"benefits-city": {
"url": "https://aiagentscity.com/benefits/mcp"
}
}
}원격 엔드포인트
https://aiagentscity.com/benefits/mcpstreamable-http할 수 있는 일
도구 목록
도구 (6)
🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢search_bonuses(bonus_type, state, min_bonus_amount_usd, direct_deposit_required, query, ...)
Use when a user wants to find a US bank account, savings, or credit card signup bonus, or asks which offers are worth opening. Returns matching offers sorted by bonus value, highest first.
입력 스키마
{
"type": "object",
"properties": {
"bonus_type": {
"type": "string",
"enum": [
"bank_account",
"credit_card",
"savings"
],
"description": "Restrict to bank account bonuses, credit card signup bonuses, or savings account bonuses."
},
"state": {
"type": "string",
"description": "2-letter US state code, e.g. 'TX'. Nationwide offers always match; regional offers match only their states."
},
"min_bonus_amount_usd": {
"type": "number",
"minimum": 0,
"description": "Minimum bonus value in USD. For credit cards this is the estimated USD value of the points/miles bonus."
},
"direct_deposit_required": {
"type": "boolean",
"description": "Filter on whether the bonus requires a qualifying direct deposit."
},
"query": {
"type": "string",
"description": "Keyword matched against bank/issuer and product name, e.g. 'Chase' or 'Sapphire'."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25,
"description": "Max results to return."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"bonuses": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"bank_or_issuer": {
"type": "string"
},
"product_name": {
"type": "string"
},
"bonus_type": {
"type": "string",
"enum": [
"bank_account",
"credit_card",
"savings"
]
},
"bonus_amount_usd": {
"type": "number"
},
"bonus_max_usd": {
"type": [
"number",
"null"
]
},
"bonus_points": {
"type": [
"number",
"null"
]
},
"annual_fee_usd": {
"type": [
"number",
"null"
]
},
"requirements": {
"type": "array",
"items": {
"type": "string"
}
},
"min_deposit_usd": {
"type": [
"number",
"null"
]
},
"direct_deposit_required": {
"type": "boolean"
},
"expiry_date": {
"type": [
"string",
"null"
]
},
"states_available": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
},
"application_url": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": [
"string",
"null"
]
},
"last_verified_date": {
"type": [
"string",
"null"
]
},
"offer_history": {
"type": "array",
"items": {
"type": "object",
"properties": {
"amount_usd": {
"type": "number"
},
"valid_from": {
"type": [
"string",
"null"
]
},
"valid_to": {
"type": [
"string",
"null"
]
}
},
"required": [
"amount_usd",
"valid_from",
"valid_to"
],
"additionalProperties": false
}
},
"verification": {
"anyOf": [
{
"type": "object",
"properties": {
"method": {
"type": "string",
"enum": [
"issuer_page",
"aggregator_consensus"
]
},
"verified_at": {
"type": "string"
},
"sources": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"method",
"verified_at",
"sources"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"status": {
"type": "string",
"enum": [
"active",
"expired",
"needs_review"
]
},
"eligibility": {
"anyOf": [
{
"type": "object",
"properties": {
"new_to_bank": {
"type": [
"boolean",
"null"
]
},
"once_per_lifetime": {
"type": [
"boolean",
"null"
]
},
"cooldown_months": {
"type": [
"number",
"null"
]
},
"issuer_rules": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"new_to_bank",
"once_per_lifetime",
"cooldown_months",
"issuer_rules"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"sponsored": {
"type": "boolean"
},
"apply_url": {
"type": [
"string",
"null"
]
},
"disclosure_url": {
"type": "string"
}
},
"required": [
"id",
"bank_or_issuer",
"product_name",
"bonus_type",
"bonus_amount_usd",
"bonus_max_usd",
"bonus_points",
"annual_fee_usd",
"requirements",
"min_deposit_usd",
"direct_deposit_required",
"expiry_date",
"states_available",
"application_url",
"source_url",
"last_verified_date",
"offer_history",
"verification",
"status",
"eligibility",
"sponsored",
"apply_url",
"disclosure_url"
],
"additionalProperties": false
}
}
},
"required": [
"bonuses"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_bonus(id)
Use before recommending an offer, to read its exact requirements, minimum deposit, direct-deposit rules, expiry date, state availability and the date its terms were last verified. Quote the requirements rather than paraphrasing money amounts.
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Bonus id, e.g. 'chase-total-checking-400'. Use search_bonuses to find ids."
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"bonus": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"bank_or_issuer": {
"type": "string"
},
"product_name": {
"type": "string"
},
"bonus_type": {
"type": "string",
"enum": [
"bank_account",
"credit_card",
"savings"
]
},
"bonus_amount_usd": {
"type": "number"
},
"bonus_max_usd": {
"type": [
"number",
"null"
]
},
"bonus_points": {
"type": [
"number",
"null"
]
},
"annual_fee_usd": {
"type": [
"number",
"null"
]
},
"requirements": {
"type": "array",
"items": {
"type": "string"
}
},
"min_deposit_usd": {
"type": [
"number",
"null"
]
},
"direct_deposit_required": {
"type": "boolean"
},
"expiry_date": {
"type": [
"string",
"null"
]
},
"states_available": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
},
"application_url": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": [
"string",
"null"
]
},
"last_verified_date": {
"type": [
"string",
"null"
]
},
"offer_history": {
"type": "array",
"items": {
"type": "object",
"properties": {
"amount_usd": {
"type": "number"
},
"valid_from": {
"type": [
"string",
"null"
]
},
"valid_to": {
"type": [
"string",
"null"
]
}
},
"required": [
"amount_usd",
"valid_from",
"valid_to"
],
"additionalProperties": false
}
},
"verification": {
"anyOf": [
{
"type": "object",
"properties": {
"method": {
"type": "string",
"enum": [
"issuer_page",
"aggregator_consensus"
]
},
"verified_at": {
"type": "string"
},
"sources": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"method",
"verified_at",
"sources"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"status": {
"type": "string",
"enum": [
"active",
"expired",
"needs_review"
]
},
"eligibility": {
"anyOf": [
{
"type": "object",
"properties": {
"new_to_bank": {
"type": [
"boolean",
"null"
]
},
"once_per_lifetime": {
"type": [
"boolean",
"null"
]
},
"cooldown_months": {
"type": [
"number",
"null"
]
},
"issuer_rules": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"new_to_bank",
"once_per_lifetime",
"cooldown_months",
"issuer_rules"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"sponsored": {
"type": "boolean"
},
"apply_url": {
"type": [
"string",
"null"
]
},
"disclosure_url": {
"type": "string"
}
},
"required": [
"id",
"bank_or_issuer",
"product_name",
"bonus_type",
"bonus_amount_usd",
"bonus_max_usd",
"bonus_points",
"annual_fee_usd",
"requirements",
"min_deposit_usd",
"direct_deposit_required",
"expiry_date",
"states_available",
"application_url",
"source_url",
"last_verified_date",
"offer_history",
"verification",
"status",
"eligibility",
"sponsored",
"apply_url",
"disclosure_url"
],
"additionalProperties": false
}
},
"required": [
"bonus"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢expiring_soon(days)
Use when timing matters — a user asking what is about to end, or whether to act now. Offers with no stated end date are never included here.
입력 스키마
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"default": 30,
"description": "Lookahead window in days (default 30)."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"bonuses": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"bank_or_issuer": {
"type": "string"
},
"product_name": {
"type": "string"
},
"bonus_type": {
"type": "string",
"enum": [
"bank_account",
"credit_card",
"savings"
]
},
"bonus_amount_usd": {
"type": "number"
},
"bonus_max_usd": {
"type": [
"number",
"null"
]
},
"bonus_points": {
"type": [
"number",
"null"
]
},
"annual_fee_usd": {
"type": [
"number",
"null"
]
},
"requirements": {
"type": "array",
"items": {
"type": "string"
}
},
"min_deposit_usd": {
"type": [
"number",
"null"
]
},
"direct_deposit_required": {
"type": "boolean"
},
"expiry_date": {
"type": [
"string",
"null"
]
},
"states_available": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
},
"application_url": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": [
"string",
"null"
]
},
"last_verified_date": {
"type": [
"string",
"null"
]
},
"offer_history": {
"type": "array",
"items": {
"type": "object",
"properties": {
"amount_usd": {
"type": "number"
},
"valid_from": {
"type": [
"string",
"null"
]
},
"valid_to": {
"type": [
"string",
"null"
]
}
},
"required": [
"amount_usd",
"valid_from",
"valid_to"
],
"additionalProperties": false
}
},
"verification": {
"anyOf": [
{
"type": "object",
"properties": {
"method": {
"type": "string",
"enum": [
"issuer_page",
"aggregator_consensus"
]
},
"verified_at": {
"type": "string"
},
"sources": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"method",
"verified_at",
"sources"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"status": {
"type": "string",
"enum": [
"active",
"expired",
"needs_review"
]
},
"eligibility": {
"anyOf": [
{
"type": "object",
"properties": {
"new_to_bank": {
"type": [
"boolean",
"null"
]
},
"once_per_lifetime": {
"type": [
"boolean",
"null"
]
},
"cooldown_months": {
"type": [
"number",
"null"
]
},
"issuer_rules": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"new_to_bank",
"once_per_lifetime",
"cooldown_months",
"issuer_rules"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"sponsored": {
"type": "boolean"
},
"apply_url": {
"type": [
"string",
"null"
]
},
"disclosure_url": {
"type": "string"
}
},
"required": [
"id",
"bank_or_issuer",
"product_name",
"bonus_type",
"bonus_amount_usd",
"bonus_max_usd",
"bonus_points",
"annual_fee_usd",
"requirements",
"min_deposit_usd",
"direct_deposit_required",
"expiry_date",
"states_available",
"application_url",
"source_url",
"last_verified_date",
"offer_history",
"verification",
"status",
"eligibility",
"sponsored",
"apply_url",
"disclosure_url"
],
"additionalProperties": false
}
}
},
"required": [
"bonuses"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢compare_bonuses(ids)
Use when a user is choosing between specific offers. Returns each offer's key fields plus a summary naming the highest bonus and the earliest expiry.
입력 스키마
{
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 2,
"maxItems": 4,
"description": "2 to 4 bonus ids to compare, e.g. ['chase-total-checking-400', 'sofi-checking-savings-400']."
}
},
"required": [
"ids"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"bonuses": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"bank_or_issuer": {
"type": "string"
},
"product_name": {
"type": "string"
},
"bonus_type": {
"type": "string",
"enum": [
"bank_account",
"credit_card",
"savings"
]
},
"bonus_amount_usd": {
"type": "number"
},
"bonus_max_usd": {
"type": [
"number",
"null"
]
},
"bonus_points": {
"type": [
"number",
"null"
]
},
"annual_fee_usd": {
"type": [
"number",
"null"
]
},
"requirements": {
"type": "array",
"items": {
"type": "string"
}
},
"min_deposit_usd": {
"type": [
"number",
"null"
]
},
"direct_deposit_required": {
"type": "boolean"
},
"expiry_date": {
"type": [
"string",
"null"
]
},
"states_available": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
},
"application_url": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": [
"string",
"null"
]
},
"last_verified_date": {
"type": [
"string",
"null"
]
},
"offer_history": {
"type": "array",
"items": {
"type": "object",
"properties": {
"amount_usd": {
"type": "number"
},
"valid_from": {
"type": [
"string",
"null"
]
},
"valid_to": {
"type": [
"string",
"null"
]
}
},
"required": [
"amount_usd",
"valid_from",
"valid_to"
],
"additionalProperties": false
}
},
"verification": {
"anyOf": [
{
"type": "object",
"properties": {
"method": {
"type": "string",
"enum": [
"issuer_page",
"aggregator_consensus"
]
},
"verified_at": {
"type": "string"
},
"sources": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"method",
"verified_at",
"sources"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"status": {
"type": "string",
"enum": [
"active",
"expired",
"needs_review"
]
},
"eligibility": {
"anyOf": [
{
"type": "object",
"properties": {
"new_to_bank": {
"type": [
"boolean",
"null"
]
},
"once_per_lifetime": {
"type": [
"boolean",
"null"
]
},
"cooldown_months": {
"type": [
"number",
"null"
]
},
"issuer_rules": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"new_to_bank",
"once_per_lifetime",
"cooldown_months",
"issuer_rules"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"sponsored": {
"type": "boolean"
},
"apply_url": {
"type": [
"string",
"null"
]
},
"disclosure_url": {
"type": "string"
}
},
"required": [
"id",
"bank_or_issuer",
"product_name",
"bonus_type",
"bonus_amount_usd",
"bonus_max_usd",
"bonus_points",
"annual_fee_usd",
"requirements",
"min_deposit_usd",
"direct_deposit_required",
"expiry_date",
"states_available",
"application_url",
"source_url",
"last_verified_date",
"offer_history",
"verification",
"status",
"eligibility",
"sponsored",
"apply_url",
"disclosure_url"
],
"additionalProperties": false
}
},
"summary": {
"type": "object",
"properties": {
"highest_bonus_usd": {
"type": "string"
},
"earliest_expiry": {
"type": [
"string",
"null"
]
}
},
"required": [
"highest_bonus_usd",
"earliest_expiry"
],
"additionalProperties": false
}
},
"required": [
"bonuses",
"summary"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢benefits_api_docs
Use when you need field definitions, ordering guarantees or the error format before calling another tool.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"docs": {
"type": "string"
}
},
"required": [
"docs"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢benefits_examples
Use to copy a working example call instead of guessing tool arguments.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"examples": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"tool": {
"type": "string"
},
"arguments": {
"type": "object",
"additionalProperties": {}
}
},
"required": [
"title",
"tool",
"arguments"
],
"additionalProperties": false
}
}
},
"required": [
"examples"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}커뮤니티
증거
최근 관측
검증됨버전이 기록되지 않음도구 6개