Server definition
- Hash
- sha256:5d9b7dc1d93753fd2ff4b031451920d7d4c2c8d1fe09c30e26a5c04d5b2c3aec
- What it is
- What a remote MCP server returned when asked what it offers: 7 tools
The blob, as servednamed by its sha256
{
"instructions": "Use search for ordinary U.S. free-trial and savings questions, then fetch the best returned id before giving detailed terms. Use search_freebies only when explicit scope controls or rich normalized results are needed, then inspect a selected result with get_record. Never call flag_expired_deal without an exact existing id and relevant current first-party evidence; blocked pages and third-party rumors are not enough. Do not purchase, access accounts, submit applications, or guarantee eligibility. Actionable trial and savings results require incorporated first-party catalog evidence plus a supporting audit. An audit confirms only the normalized fields it tested and never promotes a directory-listed record by itself. A null action_url or official_action.status=withheld means the record is evidence-only and must not be recommended for action. Never treat blocked, fetch-error, unknown, or not-found as proof of expiration without the required repeated or first-party evidence. State material fees, payment or deposit requirements, geography, personalization, expiration, renewal, and cancellation terms. Present a non-null offer action_url only when the user wants to proceed, and cite source_url for current terms. Public-benefit records provide informational eligibility paths, not eligibility decisions.",
"tools": [
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"id": {
"description": "A guide:SLUG, trial:SLUG, or entitlement:SLUG id returned by search.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "fetch",
"outputSchema": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"metadata": {
"additionalProperties": false,
"properties": {
"action_url": {
"format": "uri",
"type": [
"string",
"null"
]
},
"copy_checked_at": {
"type": [
"string",
"null"
]
},
"last_checked": {
"type": "string"
},
"matched_offer_count": {
"minimum": 0,
"type": "integer"
},
"offers_truncated": {
"type": "boolean"
},
"official_action": {
"additionalProperties": false,
"properties": {
"allowed": {
"type": "boolean"
},
"reason": {
"type": "string"
},
"status": {
"enum": [
"ready",
"source-navigation",
"withheld"
],
"type": "string"
}
},
"required": [
"allowed",
"status",
"reason"
],
"type": "object"
},
"provider": {
"type": "string"
},
"record_type": {
"enum": [
"trial",
"entitlement",
"guide"
],
"type": "string"
},
"returned_offer_count": {
"minimum": 0,
"type": "integer"
},
"source_url": {
"format": "uri",
"type": "string"
},
"status": {
"type": "string"
},
"verification_readiness": {
"additionalProperties": false,
"properties": {
"interpretation": {
"type": "string"
},
"latest_checked_at": {
"type": [
"string",
"null"
]
},
"latest_outcome": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"audit-confirmed-exact",
"audit-confirmed-partial",
"audit-inconclusive",
"audit-warning",
"not-audited"
],
"type": "string"
}
},
"required": [
"status",
"latest_outcome",
"latest_checked_at",
"interpretation"
],
"type": "object"
}
},
"required": [
"record_type",
"provider",
"status",
"last_checked",
"source_url",
"action_url"
],
"type": "object"
},
"offers": {
"description": "Current matched records for a guide. Each action_url is a measured redirect to that record's cataloged official destination.",
"items": {
"additionalProperties": false,
"properties": {
"action_url": {
"format": "uri",
"type": "string"
},
"id": {
"type": "string"
},
"last_checked": {
"type": "string"
},
"provider": {
"type": "string"
},
"record_type": {
"enum": [
"trial",
"entitlement"
],
"type": "string"
},
"source_url": {
"format": "uri",
"type": "string"
},
"status": {
"type": "string"
},
"summary": {
"type": "string"
},
"terms": {
"additionalProperties": {
"type": [
"string",
"null"
]
},
"type": "object"
},
"title": {
"type": "string"
},
"verification_readiness": {
"additionalProperties": false,
"properties": {
"interpretation": {
"type": "string"
},
"latest_checked_at": {
"type": [
"string",
"null"
]
},
"latest_outcome": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"audit-confirmed-exact",
"audit-confirmed-partial",
"audit-inconclusive",
"audit-warning",
"not-audited"
],
"type": "string"
}
},
"required": [
"status",
"latest_outcome",
"latest_checked_at",
"interpretation"
],
"type": "object"
}
},
"required": [
"id",
"record_type",
"title",
"provider",
"summary",
"status",
"last_checked",
"source_url",
"action_url",
"verification_readiness",
"terms"
],
"type": "object"
},
"type": "array"
},
"text": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"id",
"title",
"text",
"url",
"metadata"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"evidence_url": {
"description": "Current first-party HTTP(S) page supporting the report. Do not submit a rumor, search result, directory, or unrelated provider page.",
"format": "uri",
"maxLength": 2048,
"type": "string"
},
"note": {
"description": "Optional concise factual observation, up to 1,000 characters; never include credentials or personal data.",
"type": "string"
},
"record_id": {
"description": "Exact existing id returned by Andrew’s Freebies search or record lookup.",
"type": "string"
},
"record_type": {
"description": "Use the record type returned by search when known; omit only when the id uniquely resolves.",
"enum": [
"trial",
"entitlement"
],
"type": "string"
},
"reporter": {
"description": "Optional agent or integration label, up to 120 characters; never include a person’s identity.",
"type": "string"
}
},
"required": [
"record_id",
"evidence_url"
],
"type": "object"
},
"name": "flag_expired_deal",
"outputSchema": {
"additionalProperties": false,
"properties": {
"api_version": {
"type": "string"
},
"flag": {
"additionalProperties": true,
"description": "Append-only internal review signal receipt.",
"type": "object"
},
"original_record_unchanged": {
"const": true,
"type": "boolean"
},
"record": {
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"record_id": {
"type": "string"
},
"record_type": {
"enum": [
"trial",
"entitlement"
],
"type": "string"
},
"web_url": {
"type": "string"
}
},
"required": [
"record_type",
"record_id",
"name",
"web_url"
],
"type": "object"
},
"review_status": {
"const": "open",
"type": "string"
}
},
"required": [
"api_version",
"flag",
"record",
"original_record_unchanged",
"review_status"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"default": 50,
"description": "Maximum matching records to return.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"outcome": {
"description": "Optional latest-audit outcome filter; outcomes describe evidence, not guaranteed availability.",
"enum": [
"confirmed-exact",
"confirmed-partial",
"terms-changed",
"explicitly-expired",
"moved",
"blocked",
"fetch-error",
"not-found",
"unknown"
],
"type": "string"
},
"record_id": {
"description": "Optional exact non-directory record id; requires record_type and scopes totals and items to that record.",
"maxLength": 200,
"type": "string"
},
"record_type": {
"description": "Optional corpus filter; required when record_id is provided.",
"enum": [
"trial",
"entitlement"
],
"type": "string"
}
},
"type": "object"
},
"name": "get_freshness",
"outputSchema": {
"additionalProperties": false,
"properties": {
"api_version": {
"type": "string"
},
"by_evidence_resolution": {
"additionalProperties": {
"minimum": 0,
"type": "integer"
},
"type": "object"
},
"by_freshness": {
"additionalProperties": {
"minimum": 0,
"type": "integer"
},
"type": "object"
},
"by_outcome": {
"additionalProperties": {
"minimum": 0,
"type": "integer"
},
"type": "object"
},
"catalog_scope": {
"description": "The exact record population used by cadence and evidence totals.",
"type": "string"
},
"evidence_resolution_interpretation": {
"type": "string"
},
"filters": {
"additionalProperties": false,
"properties": {
"outcome": {
"type": [
"string",
"null"
]
},
"record_id": {
"type": [
"string",
"null"
]
},
"record_type": {
"type": [
"string",
"null"
]
}
},
"required": [
"record_type",
"record_id",
"outcome"
],
"type": "object"
},
"items": {
"description": "Newest matching records and their cadence schedules.",
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"newest_checked_at": {
"type": [
"string",
"null"
]
},
"oldest_checked_at": {
"type": [
"string",
"null"
]
},
"operations": {
"additionalProperties": true,
"description": "Scheduler-origin heartbeat and liveness fields.",
"type": "object"
},
"policy": {
"type": "string"
},
"totals": {
"additionalProperties": {
"type": "number"
},
"description": "Catalog, cadence, attempted-coverage, and supporting-evidence totals.",
"type": "object"
}
},
"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"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"id": {
"description": "Exact record id returned by search_freebies.",
"type": "string"
},
"record_type": {
"description": "Use the record_type returned by search_freebies when known.",
"enum": [
"trial",
"entitlement"
],
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_record",
"outputSchema": {
"additionalProperties": true,
"properties": {
"action_url": {
"format": "uri",
"type": [
"string",
"null"
]
},
"id": {
"type": "string"
},
"last_checked": {
"type": "string"
},
"name": {
"type": "string"
},
"official_action": {
"additionalProperties": false,
"properties": {
"allowed": {
"type": "boolean"
},
"reason": {
"type": "string"
},
"status": {
"enum": [
"ready",
"source-navigation",
"withheld"
],
"type": "string"
}
},
"required": [
"allowed",
"status",
"reason"
],
"type": "object"
},
"provider": {
"type": "string"
},
"record_type": {
"enum": [
"trial",
"entitlement"
],
"type": "string"
},
"source_url": {
"format": "uri",
"type": "string"
},
"status": {
"type": "string"
},
"verification_readiness": {
"additionalProperties": false,
"properties": {
"interpretation": {
"type": "string"
},
"latest_checked_at": {
"type": [
"string",
"null"
]
},
"latest_outcome": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"audit-confirmed-exact",
"audit-confirmed-partial",
"audit-inconclusive",
"audit-warning",
"not-audited"
],
"type": "string"
}
},
"required": [
"status",
"latest_outcome",
"latest_checked_at",
"interpretation"
],
"type": "object"
}
},
"required": [
"record_type",
"id",
"name",
"provider",
"status",
"last_checked",
"source_url",
"action_url",
"official_action",
"verification_readiness"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"default": 20,
"description": "Maximum append-only audit events to return.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"record_id": {
"description": "Exact trial or entitlement id returned by search or search_freebies.",
"type": "string"
},
"record_type": {
"description": "Use the record type returned by search when known; omit only when the id uniquely resolves.",
"enum": [
"trial",
"entitlement"
],
"type": "string"
}
},
"required": [
"record_id"
],
"type": "object"
},
"name": "get_verification",
"outputSchema": {
"additionalProperties": false,
"properties": {
"api_version": {
"type": "string"
},
"append_only": {
"const": true,
"type": "boolean"
},
"count": {
"minimum": 0,
"type": "integer"
},
"items": {
"description": "Newest-first append-only verification events.",
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"record": {
"additionalProperties": false,
"properties": {
"category": {
"type": "string"
},
"name": {
"type": "string"
},
"record_id": {
"type": "string"
},
"record_type": {
"enum": [
"trial",
"entitlement"
],
"type": "string"
},
"web_url": {
"type": "string"
}
},
"required": [
"record_type",
"record_id",
"name",
"category",
"web_url"
],
"type": "object"
}
},
"required": [
"api_version",
"record",
"count",
"items",
"append_only"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"query": {
"description": "The user’s natural-language savings question, including a provider, product, desired value, condition, or task when known.",
"maxLength": 160,
"minLength": 2,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search",
"outputSchema": {
"additionalProperties": false,
"properties": {
"results": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"id",
"title",
"url"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"results"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"default": 12,
"description": "Maximum normalized items to return; answer guides are reported separately.",
"maximum": 25,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "The user's need in natural language, including provider, product, eligibility, or desired value.",
"maxLength": 160,
"minLength": 2,
"type": "string"
},
"scope": {
"default": "auto",
"description": "auto routes ordinary requests to actionable trials/savings and explicit public-service needs to the broader benefits corpus.",
"enum": [
"auto",
"actionable",
"software",
"savings",
"public-benefits",
"open-source",
"all"
],
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_freebies",
"outputSchema": {
"additionalProperties": false,
"properties": {
"answer_guide_count": {
"minimum": 0,
"type": "integer"
},
"answer_guides": {
"items": {
"additionalProperties": false,
"properties": {
"agent_instruction": {
"type": "string"
},
"description": {
"type": "string"
},
"id": {
"type": "string"
},
"markdown_url": {
"format": "uri",
"type": "string"
},
"result_type": {
"const": "answer-guide",
"type": "string"
},
"source_backed_matches": {
"minimum": 0,
"type": "integer"
},
"title": {
"type": "string"
},
"updated": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"result_type",
"id",
"title",
"description",
"updated",
"source_backed_matches",
"url",
"markdown_url",
"agent_instruction"
],
"type": "object"
},
"type": "array"
},
"api_version": {
"description": "Andrew’s Freebies search contract version.",
"type": "string"
},
"count": {
"description": "Normalized record and repository results returned in items.",
"minimum": 0,
"type": "integer"
},
"items": {
"description": "Ranked normalized records or, only under an explicit open-source scope, public repository results.",
"items": {
"additionalProperties": true,
"properties": {
"action_url": {
"format": "uri",
"type": [
"string",
"null"
]
},
"id": {
"type": [
"string",
"integer"
]
},
"name": {
"type": "string"
},
"record_type": {
"enum": [
"trial",
"entitlement",
null
],
"type": [
"string",
"null"
]
},
"result_type": {
"enum": [
"trial",
"saving",
"public-benefit",
"open-source-repository"
],
"type": "string"
}
},
"required": [
"result_type",
"record_type"
],
"type": "object"
},
"type": "array"
},
"query": {
"description": "Normalized user query used for retrieval.",
"type": "string"
},
"requested_scope": {
"enum": [
"auto",
"actionable",
"software",
"savings",
"public-benefits",
"open-source",
"all"
],
"type": "string"
},
"resolved_scope": {
"enum": [
"actionable",
"software",
"savings",
"public-benefits",
"open-source",
"all"
],
"type": "string"
},
"result_count": {
"description": "Complete count across answer_guides and items.",
"minimum": 0,
"type": "integer"
},
"sources": {
"additionalProperties": true,
"description": "Per-corpus matched, omitted, and returned counts.",
"type": "object"
},
"usage": {
"additionalProperties": {
"type": "string"
},
"description": "Next-step, ranking, and caution guidance for the returned result set.",
"type": "object"
}
},
"required": [
"api_version",
"query",
"requested_scope",
"resolved_scope",
"count",
"answer_guide_count",
"result_count",
"sources",
"answer_guides",
"items",
"usage"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:5d9b7dc1d93753fd2ff4b031451920d7d4c2c8d1fe09c30e26a5c04d5b2c3aec | sha256sum