Andrew's Freebies
Find evidence-backed U.S. free trials and savings; public benefits are available by explicit scope.
我該用這個嗎
品質與安全性
發現項目(1)
- LOW在 fetch 中
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高,可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案:
{
"mcpServers": {
"mcp": {
"url": "https://andrewsfreebies.com/api/mcp"
}
}
}遠端端點
https://andrewsfreebies.com/api/mcpstreamable-http它能做什麼
工具清單
工具(7)
🟢search(query)
Use this when the user wants to find, compare, or answer a question about current U.S. free trials, rebates, bonuses, cash back, or other actionable savings. It returns citable answer guides and normalized records. Fetch the best returned id before giving detailed terms. Do not use it for purchases, account access, or guaranteed eligibility.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 2,
"maxLength": 160,
"description": "The user’s natural-language savings question, including a provider, product, desired value, condition, or task when known."
}
},
"required": [
"query"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
}
},
"required": [
"id",
"title",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"results"
],
"additionalProperties": false
}🟢fetch(id)
Use this after search returns a guide:SLUG, trial:SLUG, or entitlement:SLUG id and the user needs the complete answer, terms, evidence, verification state, or official action path. Do not guess ids, substitute a guide URL for an offer action, or use this for an id from another service.
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "A guide:SLUG, trial:SLUG, or entitlement:SLUG id returned by search."
}
},
"required": [
"id"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"text": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"metadata": {
"type": "object",
"properties": {
"record_type": {
"type": "string",
"enum": [
"trial",
"entitlement",
"guide"
]
},
"provider": {
"type": "string"
},
"status": {
"type": "string"
},
"last_checked": {
"type": "string"
},
"copy_checked_at": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": "string",
"format": "uri"
},
"action_url": {
"type": [
"string",
"null"
],
"format": "uri"
},
"official_action": {
"type": "object",
"properties": {
"allowed": {
"type": "boolean"
},
"status": {
"type": "string",
"enum": [
"ready",
"source-navigation",
"withheld"
]
},
"reason": {
"type": "string"
}
},
"required": [
"allowed",
"status",
"reason"
],
"additionalProperties": false
},
"matched_offer_count": {
"type": "integer",
"minimum": 0
},
"returned_offer_count": {
"type": "integer",
"minimum": 0
},
"offers_truncated": {
"type": "boolean"
},
"verification_readiness": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"audit-confirmed-exact",
"audit-confirmed-partial",
"audit-inconclusive",
"audit-warning",
"not-audited"
]
},
"latest_outcome": {
"type": [
"string",
"null"
]
},
"latest_checked_at": {
"type": [
"string",
"null"
]
},
"interpretation": {
"type": "string"
}
},
"required": [
"status",
"latest_outcome",
"latest_checked_at",
"interpretation"
],
"additionalProperties": false
}
},
"required": [
"record_type",
"provider",
"status",
"last_checked",
"source_url",
"action_url"
],
"additionalProperties": false
},
"offers": {
"type": "array",
"description": "Current matched records for a guide. Each action_url is a measured redirect to that record's cataloged official destination.",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"record_type": {
"type": "string",
"enum": [
"trial",
"entitlement"
]
},
"title": {
"type": "string"
},
"provider": {
"type": "string"
},
"summary": {
"type": "string"
},
"status": {
"type": "string"
},
"last_checked": {
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri"
},
"action_url": {
"type": "string",
"format": "uri"
},
"verification_readiness": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"audit-confirmed-exact",
"audit-confirmed-partial",
"audit-inconclusive",
"audit-warning",
"not-audited"
]
},
"latest_outcome": {
"type": [
"string",
"null"
]
},
"latest_checked_at": {
"type": [
"string",
"null"
]
},
"interpretation": {
"type": "string"
}
},
"required": [
"status",
"latest_outcome",
"latest_checked_at",
"interpretation"
],
"additionalProperties": false
},
"terms": {
"type": "object",
"additionalProperties": {
"type": [
"string",
"null"
]
}
}
},
"required": [
"id",
"record_type",
"title",
"provider",
"summary",
"status",
"last_checked",
"source_url",
"action_url",
"verification_readiness",
"terms"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"title",
"text",
"url",
"metadata"
],
"additionalProperties": false
}🟢search_freebies(query, scope, limit)
Use this when the user needs explicit corpus scope, result limits, or a rich normalized list rather than the standard citable search/fetch flow. It is read-only: the default uses site-controlled actionable U.S. trials and savings, while only an explicit open-source scope reads public GitHub. Use public-benefits only for eligibility-based services. Do not use it for purchases, account access, or guaranteed eligibility.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 2,
"maxLength": 160,
"description": "The user's need in natural language, including provider, product, eligibility, or desired value."
},
"scope": {
"type": "string",
"enum": [
"auto",
"actionable",
"software",
"savings",
"public-benefits",
"open-source",
"all"
],
"default": "auto",
"description": "auto routes ordinary requests to actionable trials/savings and explicit public-service needs to the broader benefits corpus."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"default": 12,
"description": "Maximum normalized items to return; answer guides are reported separately."
}
},
"required": [
"query"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"api_version": {
"type": "string",
"description": "Andrew’s Freebies search contract version."
},
"query": {
"type": "string",
"description": "Normalized user query used for retrieval."
},
"requested_scope": {
"type": "string",
"enum": [
"auto",
"actionable",
"software",
"savings",
"public-benefits",
"open-source",
"all"
]
},
"resolved_scope": {
"type": "string",
"enum": [
"actionable",
"software",
"savings",
"public-benefits",
"open-source",
"all"
]
},
"count": {
"type": "integer",
"minimum": 0,
"description": "Normalized record and repository results returned in items."
},
"answer_guide_count": {
"type": "integer",
"minimum": 0
},
"result_count": {
"type": "integer",
"minimum": 0,
"description": "Complete count across answer_guides and items."
},
"sources": {
"type": "object",
"description": "Per-corpus matched, omitted, and returned counts.",
"additionalProperties": true
},
"answer_guides": {
"type": "array",
"items": {
"type": "object",
"properties": {
"result_type": {
"type": "string",
"const": "answer-guide"
},
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"type": "string"
},
"updated": {
"type": "string"
},
"source_backed_matches": {
"type": "integer",
"minimum": 0
},
"url": {
"type": "string",
"format": "uri"
},
"markdown_url": {
"type": "string",
"format": "uri"
},
"agent_instruction": {
"type": "string"
}
},
"required": [
"result_type",
"id",
"title",
"description",
"updated",
"source_backed_matches",
"url",
"markdown_url",
"agent_instruction"
],
"additionalProperties": false
}
},
"items": {
"type": "array",
"description": "Ranked normalized records or, only under an explicit open-source scope, public repository results.",
"items": {
"type": "object",
"properties": {
"result_type": {
"type": "string",
"enum": [
"trial",
"saving",
"public-benefit",
"open-source-repository"
]
},
"record_type": {
"type": [
"string",
"null"
],
"enum": [
"trial",
"entitlement",
null
]
},
"id": {
"type": [
"string",
"integer"
]
},
"name": {
"type": "string"
},
"action_url": {
"type": [
"string",
"null"
],
"format": "uri"
}
},
"required": [
"result_type",
"record_type"
],
"additionalProperties": true
}
},
"usage": {
"type": "object",
"description": "Next-step, ranking, and caution guidance for the returned result set.",
"additionalProperties": {
"type": "string"
}
}
},
"required": [
"api_version",
"query",
"requested_scope",
"resolved_scope",
"count",
"answer_guide_count",
"result_count",
"sources",
"answer_guides",
"items",
"usage"
],
"additionalProperties": false
}🟢get_record(id, record_type)
Use this after search_freebies returns an exact trial or entitlement id and the user needs its complete normalized terms, conditions, sources, official action path, or latest verification state. Do not guess ids or treat a directory-only or inconclusive record as confirmed.
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Exact record id returned by search_freebies."
},
"record_type": {
"type": "string",
"enum": [
"trial",
"entitlement"
],
"description": "Use the record_type returned by search_freebies when known."
}
},
"required": [
"id"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"record_type": {
"type": "string",
"enum": [
"trial",
"entitlement"
]
},
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"provider": {
"type": "string"
},
"status": {
"type": "string"
},
"last_checked": {
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri"
},
"action_url": {
"type": [
"string",
"null"
],
"format": "uri"
},
"official_action": {
"type": "object",
"properties": {
"allowed": {
"type": "boolean"
},
"status": {
"type": "string",
"enum": [
"ready",
"source-navigation",
"withheld"
]
},
"reason": {
"type": "string"
}
},
"required": [
"allowed",
"status",
"reason"
],
"additionalProperties": false
},
"verification_readiness": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"audit-confirmed-exact",
"audit-confirmed-partial",
"audit-inconclusive",
"audit-warning",
"not-audited"
]
},
"latest_outcome": {
"type": [
"string",
"null"
]
},
"latest_checked_at": {
"type": [
"string",
"null"
]
},
"interpretation": {
"type": "string"
}
},
"required": [
"status",
"latest_outcome",
"latest_checked_at",
"interpretation"
],
"additionalProperties": false
}
},
"required": [
"record_type",
"id",
"name",
"provider",
"status",
"last_checked",
"source_url",
"action_url",
"official_action",
"verification_readiness"
],
"additionalProperties": true
}🟢get_verification(record_id, record_type, limit)
Use this when the user asks how or when one exact Andrew’s Freebies record was checked, whether its terms matched, or what audit warnings exist. Catalog status and audit outcome are separate; blocked, unknown, and fetch errors never prove expiration, and audits never remove or change records.
輸入結構描述
{
"type": "object",
"properties": {
"record_id": {
"type": "string",
"description": "Exact trial or entitlement id returned by search or search_freebies."
},
"record_type": {
"type": "string",
"enum": [
"trial",
"entitlement"
],
"description": "Use the record type returned by search when known; omit only when the id uniquely resolves."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20,
"description": "Maximum append-only audit events to return."
}
},
"required": [
"record_id"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"api_version": {
"type": "string"
},
"record": {
"type": "object",
"properties": {
"record_type": {
"type": "string",
"enum": [
"trial",
"entitlement"
]
},
"record_id": {
"type": "string"
},
"name": {
"type": "string"
},
"category": {
"type": "string"
},
"web_url": {
"type": "string"
}
},
"required": [
"record_type",
"record_id",
"name",
"category",
"web_url"
],
"additionalProperties": false
},
"count": {
"type": "integer",
"minimum": 0
},
"items": {
"type": "array",
"description": "Newest-first append-only verification events.",
"items": {
"type": "object",
"additionalProperties": true
}
},
"append_only": {
"type": "boolean",
"const": true
}
},
"required": [
"api_version",
"record",
"count",
"items",
"append_only"
],
"additionalProperties": false
}🟢get_freshness(record_type, record_id, outcome, limit)
Use this when the user asks about verification freshness for the actionable-candidate corpus, overdue coverage, scheduler liveness, records sharing an audit outcome, or whether one exact non-directory record is still inside cadence. Directory-only leads and public services remain inspectable elsewhere but are excluded from this denominator. For one record, provide both record_type and record_id; its audit outcome still proves only the fields checked. Blocked or unknown never means expired.
輸入結構描述
{
"type": "object",
"properties": {
"record_type": {
"type": "string",
"enum": [
"trial",
"entitlement"
],
"description": "Optional corpus filter; required when record_id is provided."
},
"record_id": {
"type": "string",
"maxLength": 200,
"description": "Optional exact non-directory record id; requires record_type and scopes totals and items to that record."
},
"outcome": {
"type": "string",
"enum": [
"confirmed-exact",
"confirmed-partial",
"terms-changed",
"explicitly-expired",
"moved",
"blocked",
"fetch-error",
"not-found",
"unknown"
],
"description": "Optional latest-audit outcome filter; outcomes describe evidence, not guaranteed availability."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 50,
"description": "Maximum matching records to return."
}
},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"api_version": {
"type": "string"
},
"catalog_scope": {
"type": "string",
"description": "The exact record population used by cadence and evidence totals."
},
"filters": {
"type": "object",
"properties": {
"record_type": {
"type": [
"string",
"null"
]
},
"record_id": {
"type": [
"string",
"null"
]
},
"outcome": {
"type": [
"string",
"null"
]
}
},
"required": [
"record_type",
"record_id",
"outcome"
],
"additionalProperties": false
},
"totals": {
"type": "object",
"description": "Catalog, cadence, attempted-coverage, and supporting-evidence totals.",
"additionalProperties": {
"type": "number"
}
},
"by_freshness": {
"type": "object",
"additionalProperties": {
"type": "integer",
"minimum": 0
}
},
"by_evidence_resolution": {
"type": "object",
"additionalProperties": {
"type": "integer",
"minimum": 0
}
},
"by_outcome": {
"type": "object",
"additionalProperties": {
"type": "integer",
"minimum": 0
}
},
"evidence_resolution_interpretation": {
"type": "string"
},
"oldest_checked_at": {
"type": [
"string",
"null"
]
},
"newest_checked_at": {
"type": [
"string",
"null"
]
},
"operations": {
"type": "object",
"description": "Scheduler-origin heartbeat and liveness fields.",
"additionalProperties": true
},
"items": {
"type": "array",
"description": "Newest matching records and their cadence schedules.",
"items": {
"type": "object",
"additionalProperties": true
}
},
"policy": {
"type": "string"
}
},
"required": [
"api_version",
"catalog_scope",
"filters",
"totals",
"by_freshness",
"by_evidence_resolution",
"by_outcome",
"evidence_resolution_interpretation",
"oldest_checked_at",
"newest_checked_at",
"operations",
"items",
"policy"
],
"additionalProperties": false
}⚪flag_expired_deal(record_id, record_type, evidence_url, note, reporter)
Use this only when the user supplies an exact existing record id and relevant current first-party evidence showing that its offer ended or is unavailable. Do not use it for rumors, third-party summaries, speculation, or a merely blocked or unreachable page. It writes one non-destructive review signal and never removes or changes the catalog record.
輸入結構描述
{
"type": "object",
"properties": {
"record_id": {
"type": "string",
"description": "Exact existing id returned by Andrew’s Freebies search or record lookup."
},
"record_type": {
"type": "string",
"enum": [
"trial",
"entitlement"
],
"description": "Use the record type returned by search when known; omit only when the id uniquely resolves."
},
"evidence_url": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Current first-party HTTP(S) page supporting the report. Do not submit a rumor, search result, directory, or unrelated provider page."
},
"note": {
"type": "string",
"description": "Optional concise factual observation, up to 1,000 characters; never include credentials or personal data."
},
"reporter": {
"type": "string",
"description": "Optional agent or integration label, up to 120 characters; never include a person’s identity."
}
},
"required": [
"record_id",
"evidence_url"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"api_version": {
"type": "string"
},
"flag": {
"type": "object",
"description": "Append-only internal review signal receipt.",
"additionalProperties": true
},
"record": {
"type": "object",
"properties": {
"record_type": {
"type": "string",
"enum": [
"trial",
"entitlement"
]
},
"record_id": {
"type": "string"
},
"name": {
"type": "string"
},
"web_url": {
"type": "string"
}
},
"required": [
"record_type",
"record_id",
"name",
"web_url"
],
"additionalProperties": false
},
"original_record_unchanged": {
"type": "boolean",
"const": true
},
"review_status": {
"type": "string",
"const": "open"
}
},
"required": [
"api_version",
"flag",
"record",
"original_record_unchanged",
"review_status"
],
"additionalProperties": false
}社群
證據