Server definition
- Hash
- sha256:350ab37553afe03efa8b8bad5421c67dd4bad38e4791f7f62b8a11453552e124
- What it is
- What a remote MCP server returned when asked what it offers: 3 tools
The blob, as servednamed by its sha256
{
"instructions": "Skipshit provides contact and property records through three tools.\n\nTool selection:\n- search_person_or_address: starting point. Returns records for a person (by name with city/state/zip) or by address. Billed 1 credit per non-null result; empty results are free.\n- expand_person_record: expand a person id into its full record. Free when you pass it with the searchId of a prior result that contains the id; billed 1 credit only when elevating a stub id (relative, associate, or property owner) that no prior result contains. meta.source reports cache (free) or fresh (billed).\n- get_search_history: FREE. List recent searches, re-read a prior result, expand one id to a full record, or page through full records — all without consuming a credit. Use this for any follow-up on data you already have.\n\nPicking the right tool: \"I have a name (and city/state)\" → search_person_or_address; \"more detail on a result, relative, or property from a search I ran\" → get_search_history (free), or expand_person_record WITH its searchId (also free); reserve billed expand_person_record for a stub id no prior result contains.\n\nReturned fields: name, address (current + prior), age, phone, email, relatives/associates, property, liens, judgments, bankruptcies, business affiliations, and IP-address signals. Field availability is fixed by the account's data contract and enforced at the gateway.",
"tools": [
{
"description": "Expand a person id into its full record. If you pass the searchId of a prior result that already contains the id, the record is returned free. A credit is charged only when elevating a stub id (a relative, associate, or property owner) that no prior result contains. The response meta.source reports whether the record came from cache (free) or fresh (billed).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"pid": {
"description": "Person identifier from a prior result. Pass it with searchId to re-read an already-owned record free; pass it without searchId (or for a stub id no stored result contains) to elevate it into a full record for 1 credit.",
"minLength": 1,
"type": "string"
},
"searchId": {
"description": "Optional. The searchId from a prior result that already contains this pid. When provided and the record is found in your stored results, the full record is returned free (no credit); otherwise a credit is charged to elevate the stub id.",
"type": "string"
}
},
"required": [
"pid"
],
"type": "object"
},
"name": "expand_person_record",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"balance": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"credits": {
"type": "number"
},
"display": {
"type": "string"
}
},
"required": [
"credits",
"display"
],
"type": "object"
},
{
"type": "null"
}
]
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"NO_CREDITS",
"INVALID_INPUT",
"RATE_LIMITED",
"UPSTREAM_UNAVAILABLE",
"INTERNAL_ERROR",
"TOO_BROAD",
"UNSUPPORTED_COMBO",
"ACCESS_DENIED"
],
"type": "string"
},
"hint": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"meta": {
"additionalProperties": false,
"properties": {
"creditConsumed": {
"type": "boolean"
},
"degraded": {
"type": "boolean"
},
"searchId": {
"type": "string"
},
"source": {
"enum": [
"cache",
"fresh"
],
"type": "string"
}
},
"required": [
"creditConsumed"
],
"type": "object"
},
"ok": {
"type": "boolean"
}
},
"required": [
"ok",
"balance",
"meta"
],
"type": "object"
}
},
{
"description": "Free detail-expander for prior results, and the way to check the current credit balance. Four call modes: (1) no args → list recent searches and return current credit balance in the response envelope (use this when the user asks how many credits they have left); (2) `searchId` → re-read trimmed envelope; (3) `searchId + pid` → full record for one hit; (4) `searchId + offset + limit` → paged slice of full records (default limit 5, max 25). Use this for follow-ups on existing results — do NOT call `search_person_or_address` again to drill in. Zero credits consumed.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"description": "Max records to return (1-25). Default depends on mode: 20 for list-mode, 5 for paged-slice mode.",
"maximum": 25,
"minimum": 1,
"type": "integer"
},
"offset": {
"description": "Zero-based offset for pagination. Used with limit in paged-slice mode (searchId + offset/limit).",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"pid": {
"description": "Person identifier within a stored search. Pass with searchId to expand that one record from the stored result to its full form. Free.",
"type": "string"
},
"searchId": {
"description": "Identifier from a prior search response (meta.searchId). Pass alone to re-emit the trimmed envelope; pass with pid for full-record expansion; pass with offset/limit for paged full records. All four modes are free (no credit consumed).",
"type": "string"
}
},
"type": "object"
},
"name": "get_search_history",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"balance": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"credits": {
"type": "number"
},
"display": {
"type": "string"
}
},
"required": [
"credits",
"display"
],
"type": "object"
},
{
"type": "null"
}
]
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"NO_CREDITS",
"INVALID_INPUT",
"RATE_LIMITED",
"UPSTREAM_UNAVAILABLE",
"INTERNAL_ERROR",
"TOO_BROAD",
"UNSUPPORTED_COMBO",
"ACCESS_DENIED"
],
"type": "string"
},
"hint": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"meta": {
"additionalProperties": false,
"properties": {
"creditConsumed": {
"type": "boolean"
},
"degraded": {
"type": "boolean"
},
"searchId": {
"type": "string"
},
"source": {
"enum": [
"cache",
"fresh"
],
"type": "string"
}
},
"required": [
"creditConsumed"
],
"type": "object"
},
"ok": {
"type": "boolean"
}
},
"required": [
"ok",
"balance",
"meta"
],
"type": "object"
}
},
{
"description": "Returns contact and property records for a person (by name with city/state/zip) or by address. Billed 1 credit per non-null result; empty results are not billed. Results are trimmed per-hit summaries; expand individual records or page through full results with `get_search_history` (free).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"address": {
"description": "Street address. Required for address-mode searches (must combine with city + state). Free-form line, no normalization needed.",
"type": "string"
},
"addressRecency": {
"description": "Filter address-based search results by how recently a person was linked to the search address. `all` = no recency filter (broadest, default when omitted); `current` = address is the subject's current residence; `lastOneYear` / `lastThreeYears` / `lastFiveYears` / `lastTenYears` = include only people linked within the past 1 / 3 / 5 / 10 years. Only applies to address-based searches.",
"enum": [
"all",
"current",
"lastOneYear",
"lastThreeYears",
"lastFiveYears",
"lastTenYears"
],
"type": "string"
},
"city": {
"description": "City name. Used with lastName for name-mode OR with address + state for address-mode.",
"type": "string"
},
"firstName": {
"description": "Person's first name. Optional but recommended for name-mode searches. Combines with lastName + locality (city/state/zip). Nickname expansion controlled by nicknameSearch.",
"type": "string"
},
"lastName": {
"description": "Person's last name. Required for name-mode searches (must combine with city, state, or zip).",
"type": "string"
},
"middleName": {
"description": "Person's middle name. Optional. Tightens name-mode match precision; rarely required.",
"type": "string"
},
"nicknameSearch": {
"default": true,
"description": "Controls how aggressively firstName is expanded to spelling/nickname variants. `true` (default) = broad expansion (Megan → Meagan, Meggan, Meg; Jon → John, Jonathan; Katie → Katy, Kate). `false` = narrower expansion — drops loose nickname variants but the dataset may still surface tight phonetic neighbors (observed: searching firstName=MEGAN with nicknameSearch=false still returned MEAGAN at rank 0 when she was the strongest local match). Pass `false` to reduce noise from long-form variants; do NOT rely on `false` for strict literal-spelling-only matching.",
"type": "boolean"
},
"state": {
"description": "Two-letter US state code (e.g. CA, NY, TX). Used with lastName for name-mode OR with address + city for address-mode.",
"type": "string"
},
"zip": {
"description": "5-digit US ZIP code. Used with lastName for name-mode (combines with city/state).",
"type": "string"
}
},
"type": "object"
},
"name": "search_person_or_address",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"balance": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"credits": {
"type": "number"
},
"display": {
"type": "string"
}
},
"required": [
"credits",
"display"
],
"type": "object"
},
{
"type": "null"
}
]
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"NO_CREDITS",
"INVALID_INPUT",
"RATE_LIMITED",
"UPSTREAM_UNAVAILABLE",
"INTERNAL_ERROR",
"TOO_BROAD",
"UNSUPPORTED_COMBO",
"ACCESS_DENIED"
],
"type": "string"
},
"hint": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"meta": {
"additionalProperties": false,
"properties": {
"creditConsumed": {
"type": "boolean"
},
"degraded": {
"type": "boolean"
},
"searchId": {
"type": "string"
},
"source": {
"enum": [
"cache",
"fresh"
],
"type": "string"
}
},
"required": [
"creditConsumed"
],
"type": "object"
},
"ok": {
"type": "boolean"
}
},
"required": [
"ok",
"balance",
"meta"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:350ab37553afe03efa8b8bad5421c67dd4bad38e4791f7f62b8a11453552e124 | sha256sum