Server definition
- Hash
- sha256:7fc97501e33a1a6ba206ed4bd042c105b5a9efb5597efd6827643a530f1d8656
- What it is
- What a remote MCP server returned when asked what it offers: 43 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "Checks an e-mail address: syntax, whether the domain can actually receive mail, disposable and role-account detection, and typo correction.\n\nNo SMTP probing. Most competitors connect to the target server and try RCPT TO, which sounds thorough but produces a confident-looking number you cannot trust: most servers are catch-all, the big providers refuse to answer, and doing it in bulk gets the probing IP blacklisted. We report only what is provable — whether the domain has a mail exchanger, whether it is a known disposable service, whether the mailbox belongs to a role rather than a person, and whether the domain looks like a typo of a common one (gmial.com → gmail.com). Addresses are also normalised, so Gmail dots and +tags stop creating duplicate signups.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"email": {
"description": "E-mail address to check.",
"maxLength": 254,
"minLength": 3,
"type": "string"
},
"rejectFreeProviders": {
"default": false,
"type": "boolean"
},
"rejectRoleAccounts": {
"default": false,
"type": "boolean"
}
},
"required": [
"email"
],
"type": "object"
},
"name": "email_verify",
"outputSchema": null
},
{
"description": "Validates an IBAN from any of 70+ countries: checksum, country length and in-country account structure, and resolves the bank and branch codes.\n\nMost free libraries stop at the mod-97 checksum. That only says the digits are self-consistent — not that the number could exist in that country. This checks the country's BBAN structure too, so a wrong-length or wrong-shaped account is rejected before your payment file reaches the bank. When only the two check digits are wrong, the correct ones are computed and returned as a suggestion, because that is what people actually mistype. Turkish, Dutch and Belgian IBANs additionally resolve to a bank name when the national code is in our table; otherwise bankName is null. This is not a SWIFT directory.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"expectCountry": {
"description": "Expected country code (ISO 3166-1 alpha-2).",
"maxLength": 2,
"minLength": 2,
"type": "string"
},
"iban": {
"description": "IBAN, with or without spaces.",
"maxLength": 42,
"minLength": 5,
"type": "string"
}
},
"required": [
"iban"
],
"type": "object"
},
"name": "iban_validate",
"outputSchema": null
},
{
"description": "Notify an optional audio chunk / customer URI for a live or archived call (idle $0).\n\nPrefer customer storage URI. Temsor keeps a pointer; STT only while a call is active.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"bytes_b64": {
"description": "Optional small demo chunk; production prefers URI.",
"maxLength": 200000,
"type": "string"
},
"call_id": {
"maxLength": 64,
"minLength": 2,
"type": "string"
},
"pbx_id": {
"maxLength": 64,
"type": "string"
},
"t_ms": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"uri": {
"description": "Customer-side media URI (preferred).",
"format": "uri",
"type": "string"
}
},
"required": [
"call_id"
],
"type": "object"
},
"name": "pbx_audio_chunk",
"outputSchema": null
},
{
"description": "List recent calls with transfer path crumbs — site + customer archive browser.\n\nGET /v1/pbx/calls?limit=20. Scoped by x-temsor-pbx-key when set. Idle $0. No DID sales.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"default": 20,
"description": "Max recent calls to return (1–100).",
"maximum": 100,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "pbx_calls",
"outputSchema": null
},
{
"description": "Get one call by id with transfer graph — customer detail drawer.\n\nGET /v1/pbx/calls/get?call_id=…. Scoped by x-temsor-pbx-key. found=false if missing. Idle $0.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"call_id": {
"description": "Call id (e.g. call_msp_002).",
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"call_id"
],
"type": "object"
},
"name": "pbx_calls_get",
"outputSchema": null
},
{
"description": "Handoff graph + transfer edges — who→whom→where the promise stuck (moat). Idle $0.\n\nGET /v1/pbx/calls/graph?call_id=…&stuck_at=310. Returns path, path_tr (plain Turkish), edges, and raw transfers. Compounding asset for search/orchestration: handoff edges, not a bot transcript. Idle $0. No DID sales / no live PSTN.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"call_id": {
"description": "Call id whose transfer graph to return.",
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"stuck_at": {
"description": "Optional override for where the promise stuck (extension).",
"maxLength": 16,
"type": "string"
}
},
"required": [
"call_id"
],
"type": "object"
},
"name": "pbx_calls_graph",
"outputSchema": null
},
{
"description": "Managed SaaS domain dictionary (E4) — example packs thicken per pilot (tenant-scoped aliases). Boosts search + Fact extract. No invented premiums.\n\nGET /v1/pbx/dictionary?domain=otel|santral_firmasi|sigorta|finans|enerji|otomotiv|msp|all (msp = legacy alias for santral_firmasi). Idle $0, no LLM. Synonyms feed archive search (match crumbs) and transcript Fact extraction. Write path: POST /v1/pbx/dictionary/add.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"domain": {
"default": "all",
"description": "Domain slice: otel | santral_firmasi | sigorta | finans | enerji | otomotiv (legacy msp) | all",
"enum": [
"otel",
"santral_firmasi",
"msp",
"sigorta",
"finans",
"enerji",
"otomotiv",
"all"
],
"type": "string"
}
},
"type": "object"
},
"name": "pbx_dictionary",
"outputSchema": null
},
{
"description": "Add a synonym/alias (tenant-scoped or global demo) — E4 compounding thickens search boost + Fact extract. ≤60/hour/key → 429. Idle $0. No invented premiums.\n\nPOST /v1/pbx/dictionary/add {term, alias, domain:otel|santral_firmasi|sigorta|finans|enerji|otomotiv, scope?:pbx|global}. Managed SaaS compounding (E4): tenant-scoped aliases thicken search + fact extract. No invented premiums/prices. Idle $0, no LLM. Legacy msp → santral_firmasi.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"alias": {
"description": "Synonym / alias to add (e.g. cooling, line package).",
"maxLength": 64,
"minLength": 2,
"type": "string"
},
"boost": {
"description": "Search boost weight (default 2).",
"maximum": 5,
"minimum": 1,
"type": "number"
},
"domain": {
"default": "otel",
"description": "Domain: otel | santral_firmasi | sigorta | finans | enerji | otomotiv (legacy msp accepted).",
"enum": [
"otel",
"santral_firmasi",
"msp",
"sigorta",
"finans",
"enerji",
"otomotiv"
],
"type": "string"
},
"hint_en": {
"maxLength": 160,
"type": "string"
},
"hint_tr": {
"maxLength": 160,
"type": "string"
},
"kind": {
"description": "Fact kind; inferred from seed term when omitted.",
"enum": [
"imei",
"tarife",
"oda",
"oda_tipi",
"klima",
"check_out",
"iade",
"sku",
"police",
"hasar",
"yenileme",
"abone",
"kesinti",
"fatura",
"kart",
"iban",
"sube",
"other"
],
"type": "string"
},
"scope": {
"description": "pbx = scoped to x-temsor-pbx-key; global = demo-wide. Default: pbx if registered key, else global.",
"enum": [
"pbx",
"global"
],
"type": "string"
},
"term": {
"description": "Canonical term (e.g. AC, tariff). Plain Turkish preferred.",
"maxLength": 64,
"minLength": 2,
"type": "string"
}
},
"required": [
"term",
"alias"
],
"type": "object"
},
"name": "pbx_dictionary_add",
"outputSchema": null
},
{
"description": "Ingest call-ops events → open promises + transfer crumbs for search/orchestration. Optional HMAC. Idle $0 when no calls.\n\nDemo stores events in memory/file. Auth: omit, x-temsor-pbx-key, or x-temsor-signature = hex(HMAC-SHA256(api_key, body)); bad signature rejected when header present. BridgeEnter → transfer/handoff crumbs. Utterance/text → open Promise docs via heuristic (no LLM). Idle $0. Body ≤256 KiB → 429. Advanced: ARI/Stasis batch shape when customer runs own PBX — not Asterisk-first product copy.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"events": {
"description": "ARI / Stasis event batch. Utterance/text fields trigger heuristic promise extract.",
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"maxItems": 200,
"minItems": 1,
"type": "array"
},
"pbx_id": {
"description": "PBX id that emitted the ARI batch.",
"maxLength": 64,
"minLength": 2,
"type": "string"
}
},
"required": [
"events"
],
"type": "object"
},
"name": "pbx_events",
"outputSchema": null
},
{
"description": "List extracted facts (IMEI, room, tariff…) from the durable index — filter by call_id, kind, domain, q.\n\nGET /v1/pbx/facts?call_id=&kind=&domain=otel|santral_firmasi|all&q=&limit=50. Facts come from transcript extract + domain dictionary; persist in pbx-index. Scoped by x-temsor-pbx-key. Idle $0. No DID sales. KVKK forget ready. Advanced: own PBX/Asterisk stays on customer.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"call_id": {
"description": "Filter by call id (e.g. call_msp_001).",
"maxLength": 80,
"type": "string"
},
"domain": {
"description": "Domain slice: otel | santral_firmasi | sigorta | finans | enerji (legacy msp) | all.",
"enum": [
"otel",
"santral_firmasi",
"msp",
"sigorta",
"finans",
"enerji",
"otomotiv",
"all"
],
"type": "string"
},
"kind": {
"description": "Fact kind key (imei, oda, tarife, ...) or all.",
"maxLength": 32,
"type": "string"
},
"limit": {
"default": 50,
"description": "Max facts to return (1–200).",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"q": {
"description": "Free-text filter over kind + value + call_id.",
"maxLength": 200,
"type": "string"
}
},
"type": "object"
},
"name": "pbx_facts",
"outputSchema": null
},
{
"description": "Get one extracted fact by id — detail drawer for site + customer.\n\nGET /v1/pbx/facts/get?id=…. Scoped by x-temsor-pbx-key. found=false if missing. Idle $0. No DID sales.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"description": "Fact id (e.g. fact_001).",
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "pbx_facts_get",
"outputSchema": null
},
{
"description": "Upsert mid-call partial index (utterances → fact/promise hints). Path to ≤400ms whisper; ≤600/hour/key → 429; idle $0.\n\nPOST /v1/pbx/index/partial {call_id, text?, speaker?, t_ms?, is_final?, live?, end_call?, promote?}. Streams partial STT queue into accumulating Fact/Promise hints while the call is live. No Temsor STT/LLM — customer posts text. Managed SaaS in-call index; no DID sales. Own PBX optional footnote. Idle $0.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"call_id": {
"description": "Live call id to upsert partial index for.",
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"end_call": {
"description": "Mark live=false; idle $0 for this call.",
"type": "boolean"
},
"is_final": {
"description": "Finalized utterance span (vs interim).",
"type": "boolean"
},
"live": {
"description": "Default true while call is live.",
"type": "boolean"
},
"pbx_id": {
"maxLength": 64,
"type": "string"
},
"promote": {
"description": "Promote heuristic hints into durable Promise/Fact docs.",
"type": "boolean"
},
"speaker": {
"anyOf": [
{
"maxLength": 64,
"type": "string"
},
{
"type": "null"
}
]
},
"t_ms": {
"anyOf": [
{
"maximum": 86400000,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"text": {
"description": "Partial utterance / snippet (customer STT or demo). Empty = metadata-only.",
"maxLength": 2000,
"type": "string"
}
},
"required": [
"call_id"
],
"type": "object"
},
"name": "pbx_index_partial",
"outputSchema": null
},
{
"description": "GET mid-call partial index — accumulating facts/promises/snippets while live.\n\nGET /v1/pbx/index/partial/get?call_id=…. Returns live partial state for whisper ≤400ms path. Idle $0 when no live call. Managed SaaS in-call index; no DID sales. Own PBX optional footnote.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"call_id": {
"description": "Call id whose live partial index to read.",
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"call_id"
],
"type": "object"
},
"name": "pbx_index_partial_get",
"outputSchema": null
},
{
"description": "Heuristic TR promise extractor from transcript text — creates open Promise docs (idle $0, no LLM).\n\nDetects promise-like sentences (söz, vaat, edeceğiz, iade, iptal, yarın…). Optional persist_promises=false for extract without writing. Also wired via utterance text on POST /v1/pbx/events.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"call_id": {
"maxLength": 64,
"type": "string"
},
"ext": {
"maxLength": 16,
"type": "string"
},
"pbx_id": {
"maxLength": 64,
"type": "string"
},
"persist_promises": {
"default": true,
"description": "When false, extract only (dry-run, no write). When true, create Promise docs status=open.",
"type": "boolean"
},
"transcript": {
"description": "TR utterance / transcript text to scan for promises.",
"maxLength": 50000,
"minLength": 1,
"type": "string"
},
"who": {
"maxLength": 120,
"type": "string"
}
},
"required": [
"transcript"
],
"type": "object"
},
"name": "pbx_ingest_transcript",
"outputSchema": null
},
{
"description": "Light CRM from call graph / facts — caller phones+names and extension identities seen on transfers.\n\nGET /v1/pbx/persons?call_id=&kind=caller|extension|all&q=&limit=50. Durable Person rows from pbx-index plus derived extension identities (ext_NNN) from Transfer edges / promise.ext. Scoped by x-temsor-pbx-key. Idle $0. No DID sales. KVKK forget ready. Advanced: own PBX/Asterisk stays on customer.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"call_id": {
"description": "Filter persons seen on this call id.",
"maxLength": 80,
"type": "string"
},
"include_extensions": {
"description": "Include derived extension identities (default true).",
"type": "boolean"
},
"kind": {
"description": "caller = durable Person; extension = derived from call-graph hops; all = both.",
"enum": [
"caller",
"extension",
"all"
],
"type": "string"
},
"limit": {
"default": 50,
"description": "Max persons to return (1–200).",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"q": {
"description": "Free-text over names, phones, org, extensions, facts.",
"maxLength": 200,
"type": "string"
}
},
"type": "object"
},
"name": "pbx_persons",
"outputSchema": null
},
{
"description": "Get one light-CRM identity by id — caller Person or derived extension.\n\nGET /v1/pbx/persons/get?id=per_001|ext_101. Scoped by x-temsor-pbx-key. found=false if missing. Idle $0. No DID sales.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"description": "Person id (e.g. per_001) or extension id (e.g. ext_101).",
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "pbx_persons_get",
"outputSchema": null
},
{
"description": "List open/broken call promises for agent handoff tracking — hotel / MSP sales demo. Idle $0.\n\nGET /v1/pbx/promises?status=open returns open/unclosed promises with transfer/handoff path for orchestration. Scoped by x-temsor-pbx-key when set. Idle $0. No live PSTN.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"status": {
"default": "open",
"description": "Promise status filter; closed = kept|broken. Sales demo uses open.",
"enum": [
"open",
"kept",
"broken",
"unknown",
"all",
"closed"
],
"type": "string"
}
},
"type": "object"
},
"name": "pbx_promises",
"outputSchema": null
},
{
"description": "E1 moat: who→whom→promise → orchestra handoff intent (whisper/transfer/hold). Idle $0. No live PSTN. Own PBX = advanced footnote.\n\nPOST /v1/pbx/promises/act {promise_id, action?}. Loads the promise + call graph, suggests whisper/transfer/hold, records orchestra intent with source_type=promise for agent handoff. Managed SaaS runtime. ≤120/hour/key (shares orchestra bucket). Idle $0. carrier/pstn always false. No cross-tenant graph merge. Advanced: not Asterisk-first glue; own PBX optional footnote.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"action": {
"description": "Default whisper. transfer uses graph stuck_at / promise.ext.",
"enum": [
"whisper",
"hold",
"transfer",
"pci_stop",
"snoop"
],
"type": "string"
},
"agent_ext": {
"maxLength": 64,
"type": "string"
},
"pbx_id": {
"maxLength": 64,
"type": "string"
},
"promise_id": {
"description": "Open (or any) promise id — closed loop reads call graph then records orchestra intent.",
"maxLength": 64,
"minLength": 2,
"type": "string"
},
"skip_forward": {
"description": "Default true — record intent only.",
"type": "boolean"
},
"stasis_webhook_url": {
"maxLength": 500,
"type": "string"
}
},
"required": [
"promise_id"
],
"type": "object"
},
"name": "pbx_promises_act",
"outputSchema": null
},
{
"description": "Mark an open promise kept or broken with an optional KVKK-safe note — makes the sales demo writable, not read-only. ≤60/hour/key → 429.\n\nPOST /v1/pbx/promises/close {promise_id, status:kept|broken, note?}. Phones/emails in note are scrubbed. Scoped by x-temsor-pbx-key when set. Idle $0 — no LLM/PSTN.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"note": {
"description": "Optional short operator note. Phones/emails stripped (KVKK-safe).",
"maxLength": 200,
"type": "string"
},
"promise_id": {
"description": "Promise id (prm_*). Sales demo marks open promises kept|broken.",
"maxLength": 64,
"minLength": 2,
"type": "string"
},
"status": {
"description": "Close outcome: kept (honoured) or broken (not kept).",
"enum": [
"kept",
"broken"
],
"type": "string"
}
},
"required": [
"promise_id",
"status"
],
"type": "object"
},
"name": "pbx_promises_close",
"outputSchema": null
},
{
"description": "Export open/broken promises as CSV or JSON — hotel / PBX-provider unclosed-promise sales list.\n\nGET /v1/pbx/promises/export?status=open|closed&format=csv|json. CSV/JSON include closed_at, close_note, path crumbs. Scoped by x-temsor-pbx-key when set. Idle $0.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"format": {
"default": "csv",
"description": "Export format.",
"enum": [
"csv",
"json"
],
"type": "string"
},
"status": {
"default": "open",
"description": "Promise status filter; closed = kept|broken. Sales demo uses open.",
"enum": [
"open",
"kept",
"broken",
"unknown",
"all",
"closed"
],
"type": "string"
}
},
"type": "object"
},
"name": "pbx_promises_export",
"outputSchema": null
},
{
"description": "Undo a kept/broken close — restore an open promise so the sales demo can reverse a mis-click. ≤60/hour/key → 429.\n\nPOST /v1/pbx/promises/reopen {promise_id}. Only kept|broken → open; clears closed_at/close_note. Scoped by x-temsor-pbx-key when set. Idle $0.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"promise_id": {
"description": "Promise id (prm_*). Undo a kept|broken close — restore open.",
"maxLength": 64,
"minLength": 2,
"type": "string"
}
},
"required": [
"promise_id"
],
"type": "object"
},
"name": "pbx_promises_reopen",
"outputSchema": null
},
{
"description": "KVKK-first forget (default-on SaaS): clear derived index by id/phone; durable audit who/what/when + tenant scope. ≤30/hour/key → 429. Managed pointer only — not a legal deletion SLA.\n\nE.3 KVKK-first redaction for managed SaaS. mode=anonymize|delete. Lookup by target_id or phone. Clears Person/Promise/Fact/partial index + Temsor audio pointers in your tenant only (no cross-tenant). Durable audit. Raw media stays on your side. Not a legal deletion SLA. List: GET /v1/pbx/redact/audit.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"mode": {
"description": "anonymize (default) scrubs fields; delete removes docs.",
"enum": [
"anonymize",
"delete"
],
"type": "string"
},
"phone": {
"description": "Caller phone — finds Person phones (+ linked derived index).",
"maxLength": 32,
"minLength": 7,
"type": "string"
},
"reason": {
"description": "KVKK (personal-data) / forget reason.",
"maxLength": 200,
"type": "string"
},
"target_id": {
"description": "Document id (prm_*, per_*, call_*, fact_*).",
"maxLength": 64,
"minLength": 2,
"type": "string"
},
"target_type": {
"description": "Index document type. Optional when `phone` is set.",
"enum": [
"promise",
"call",
"person",
"fact",
"utterance"
],
"type": "string"
},
"who": {
"description": "Actor label for durable audit (defaults to pbx scope / demo-operator).",
"maxLength": 80,
"type": "string"
}
},
"type": "object"
},
"name": "pbx_redact",
"outputSchema": null
},
{
"description": "List recent KVKK forget actions — who/what/when + tenant scope. Managed SaaS derived-index audit; not a legal deletion SLA.\n\nGET /v1/pbx/redact/audit?limit=20. Durable audit from POST /v1/pbx/redact (E.3). Tenant-scoped. Derived index cleared; raw media not deleted by Temsor. Number→flow managed SaaS; own PBX optional. No DID sales.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"description": "Max recent forget actions to return (default 20).",
"maximum": 100,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "pbx_redact_audit",
"outputSchema": null
},
{
"description": "Register a pilot PBX; returns pbx_id + API key once (hashed at rest). ≤5/hour/IP → 429. Idle $0.\n\nControl-plane register. API key shown once; stored hashed at rest. Send x-temsor-pbx-key to scope GET /v1/pbx/promises to this pbx_id. No speech recognition while idle.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"ari_webhook_secret": {
"description": "ARI webhook signing secret (stored as hint only).",
"maxLength": 200,
"type": "string"
},
"email": {
"description": "Pilot contact email.",
"format": "email",
"maxLength": 254,
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"type": "string"
},
"label": {
"description": "Human label, e.g. hotel or PBX/IT provider site.",
"maxLength": 120,
"type": "string"
},
"name": {
"description": "Pilot contact name (waitlist / register).",
"maxLength": 120,
"type": "string"
},
"pbx_id": {
"description": "Pilot PBX id; auto-minted if omitted.",
"maxLength": 64,
"minLength": 2,
"type": "string"
},
"webhook_events": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "string"
}
],
"description": "Event list or comma string: promise.opened|closed, fact.extracted, orchestra.act, redact, or *."
},
"webhook_secret": {
"description": "Optional HMAC secret for outbound webhook signatures (x-temsor-signature).",
"maxLength": 200,
"type": "string"
},
"webhook_url": {
"description": "Optional outbound webhook URL — Temsor POSTs promise/fact/orchestra/redact events.",
"format": "uri",
"maxLength": 500,
"type": "string"
}
},
"type": "object"
},
"name": "pbx_register",
"outputSchema": null
},
{
"description": "Agent archive search over call promises and facts — voice-Google for call-ops, not a receptionist bot. Idle $0.\n\nDemo index + domain dictionary v0. Filters: status, date, ext, competitor, stuck_after (transfer/handoff hop). Returns call-graph path + transfer edges for orchestration. Idle $0. No live PSTN.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"competitor": {
"maxLength": 64,
"type": "string"
},
"date_from": {
"description": "ISO date/time lower bound (promise.when_iso / call.started_at).",
"maxLength": 40,
"type": "string"
},
"date_to": {
"description": "ISO date/time upper bound.",
"maxLength": 40,
"type": "string"
},
"ext": {
"maxLength": 16,
"type": "string"
},
"q": {
"default": "",
"description": "Full-text query over promises, facts, and call summaries.",
"maxLength": 200,
"type": "string"
},
"status": {
"enum": [
"open",
"kept",
"broken",
"unknown"
],
"type": "string"
},
"stuck_after": {
"description": "Filter: promise stuck after transfer to this extension (to_ext hop).",
"maxLength": 16,
"type": "string"
}
},
"type": "object"
},
"name": "pbx_search",
"outputSchema": null
},
{
"description": "Control-plane status — promise/orchestra/search counts + idle $0. No DID sales.\n\nGET /v1/pbx/status. Scoped by x-temsor-pbx-key when set. Derived index on Temsor for agent search/orchestration. Idle $0. Advanced: own PBX/Asterisk stays on customer.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "No input — scoped by x-temsor-pbx-key when set.",
"properties": {},
"type": "object"
},
"name": "pbx_status",
"outputSchema": null
},
{
"description": "Register or list outbound webhooks — customer URL receives promise/fact/orchestra/redact events (HMAC if secret). POST write ≤30/hour/key → 429.\n\nPOST /v1/pbx/webhooks {url, secret?, events?, ping?} registers. GET lists. ping:true sends a test delivery. Events: promise.opened, promise.closed, fact.extracted, orchestra.act, redact. Signed with x-temsor-signature when secret set. Idle $0. No DID sales. KVKK. Advanced: own PBX/Asterisk stays on customer.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"events": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "string"
}
],
"description": "Events: promise.opened|closed, fact.extracted, orchestra.act, redact, or *."
},
"limit": {
"description": "List limit (default 50).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"ping": {
"description": "If true with url → register then ping; if true without url → ping existing.",
"type": "boolean"
},
"secret": {
"description": "Optional HMAC-SHA256 secret → x-temsor-signature: sha256=<hex>.",
"maxLength": 200,
"type": "string"
},
"url": {
"description": "Outbound webhook URL (http/https). Present → register; omit on GET → list.",
"maxLength": 500,
"type": "string"
},
"webhook_id": {
"description": "For ping: target webhook id.",
"maxLength": 64,
"type": "string"
}
},
"type": "object"
},
"name": "pbx_webhooks",
"outputSchema": null
},
{
"description": "List last N outbound webhook deliveries (stub or live) — promise/fact/orchestra/redact/ping.\n\nGET /v1/pbx/webhooks/deliveries?limit=20&webhook_id=. Durable log of Temsor→customer POSTs. HMAC when secret set. Idle $0. No DID sales. KVKK. Advanced: own PBX/Asterisk stays on customer.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"description": "Max deliveries (default 20).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"webhook_id": {
"description": "Filter by webhook id.",
"maxLength": 64,
"type": "string"
}
},
"type": "object"
},
"name": "pbx_webhooks_deliveries",
"outputSchema": null
},
{
"description": "Capability: mode=stub|ready from TEMSOR_RTP_*. No live RTP on forge; idle $0.\n\nGET /v1/pbx/whisper/status. Reports MediaBridge config presence (TEMSOR_RTP_PATH). mode=ready means path env set — not that Asterisk RTP is flowing. live_rtp/listening always false on forge (R2–R3 IVR sidecar; R4 lab E2E harness). No ≤400ms production claim. TEMSOR_RTP_LAB=1 → optional lab_latency_ms on suggest. No DID sales.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "No input — TEMSOR_RTP_* from process env.",
"properties": {},
"type": "object"
},
"name": "pbx_whisper_status",
"outputSchema": null
},
{
"description": "Live agent handoff cards (≤3): open promises/facts from in-call index. Idle $0. Lab: TEMSOR_RTP_LAB=1 → lab_latency_ms.\n\nPOST /v1/pbx/whisper/suggest {call_id, partial_text}. Returns open promises and facts as whisper cards for agent handoff. Prefers in-call partial index when present. Mock latency_ms under 400ms (compat stub). Idle $0. No Telnyx/DID/live PSTN. Advanced: optional lab_latency_ms when TEMSOR_RTP_LAB=1 (measured; not prod SLA).",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"call_id": {
"description": "Active call id for agent UI context.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"partial_text": {
"default": "",
"description": "Partial transcript / utterance text (no live speech recognition).",
"maxLength": 2000,
"type": "string"
}
},
"required": [
"call_id"
],
"type": "object"
},
"name": "pbx_whisper_suggest",
"outputSchema": null
},
{
"description": "Validates and normalises a phone number to E.164, classifies the line type, and resolves the province for Turkish landlines.\n\nFor signup and checkout flows that need to store one canonical form and reject typos early. Turkish numbers are handled in depth: landline area codes resolve to a province, mobile and special ranges (toll-free 0800, fixed-rate 0850, premium 0900) are classified, and every accepted input comes back in both E.164 and national notation.\n\nOne thing this endpoint deliberately does not claim: the current mobile operator. Turkey has had number portability since 2008, so a 0532 number may well be on another network today. Competing APIs report the prefix owner as \"the operator\" and customers pick SMS routes on that basis. We return it as `originallyAllocatedTo` with the caveat attached, because a confident wrong answer costs more than an honest gap.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"defaultCountry": {
"description": "ISO 3166-1 alpha-2 country to assume when the number has no international prefix. Defaults to TR.",
"maxLength": 2,
"minLength": 2,
"type": "string"
},
"phone": {
"description": "Phone number in any common format.",
"maxLength": 30,
"minLength": 4,
"type": "string"
}
},
"required": [
"phone"
],
"type": "object"
},
"name": "phone_validate",
"outputSchema": null
},
{
"description": "Splits a free-form Turkish address into neighbourhood, street, building, floor, flat, district, province and postcode.\n\nHandles the abbreviation chaos (Mah./Mh., Cd./Cad., Sk./Sok., No:12/5, K:3 D:7), cross-checks the province against the postcode, repairs misspelled district names against a dictionary, and returns a confidence score. Anything it could not place is listed in `unparsed` — nothing is dropped silently. Built for shipping, checkout and CRM systems that receive Turkish addresses typed by humans.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"address": {
"description": "Free-text address.",
"maxLength": 500,
"minLength": 3,
"type": "string"
},
"defaultProvince": {
"description": "Province to assume when the address has none.",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"name": "tr_address_parse",
"outputSchema": null
},
{
"description": "Adds business days or counts them between two dates, accounting for Turkish public and religious holidays including half-day eves.\n\nRamadan and Sacrifice feasts follow the Hijri calendar and cannot be derived reliably by formula, so announced dates are read from a table; years without an official announcement are returned with `confirmed:false` rather than guessed silently. For delivery promises, SLA clocks, payment terms and shipping estimates.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"addDays": {
"description": "Add/subtract this many business days (not calendar days).",
"maximum": 3650,
"minimum": -3650,
"type": "integer"
},
"countHalfDaysAsWork": {
"default": true,
"description": "Count Arife half-days as working days?",
"type": "boolean"
},
"end": {
"description": "If set, count business days between start and this date.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"start": {
"description": "Start date (YYYY-MM-DD).",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
}
},
"required": [
"start"
],
"type": "object"
},
"name": "tr_business_days",
"outputSchema": null
},
{
"description": "Builds a Turkish IBAN from a 5-digit bank code and account number, computing ISO 7064 check digits.\n\nA Turkish IBAN is TR + 2 check digits + 5-digit bank code + 1 reserved digit + 16-character account. This pads the account on the left, defaults the reserved digit to 0, computes the mod-97 check digits, and resolves the bank name from the same national table used by IBAN validation when the code is known. Unknown bank codes still produce a structurally valid IBAN with bankName null — existence at the bank is not claimed.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"accountNumber": {
"description": "Account number, up to 16 alphanumeric characters (padded left with zeros).",
"type": "string"
},
"bankCode": {
"description": "5-digit Turkish national bank / EFT code (e.g. 00062).",
"type": "string"
},
"reserved": {
"description": "Reserved BBAN digit after the bank code. Defaults to 0.",
"type": "string"
}
},
"required": [
"bankCode",
"accountNumber"
],
"type": "object"
},
"name": "tr_iban_olustur",
"outputSchema": null
},
{
"description": "Builds a UBL-TR e-Invoice or e-Archive XML document from plain JSON, computing every total and validating the parties.\n\nSelling into Türkiye means issuing a UBL-TR document whose element order is fixed by schema and whose totals must agree to the kuruş, or the integrator rejects it. This endpoint takes the invoice as ordinary JSON and returns the XML. Totals you send are ignored on purpose — line amounts, per-rate VAT subtotals and the payable amount are all recomputed here, because a rounding difference of one kuruş is the most common rejection. VKN and TCKN checksums are verified, and the amount is written out in Turkish words as invoices require. It does not sign the document and does not transmit it: the financial seal and the submission to the tax authority belong to your certificate and your integrator. What comes back is a document ready to enter that step.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"amountInWords": {
"default": true,
"description": "Adds the payable amount written out in Turkish words as a note, the way invoices require.",
"type": "boolean"
},
"currency": {
"default": "TRY",
"description": "ISO 4217. Anything other than TRY requires `exchangeRate`.",
"maxLength": 3,
"minLength": 3,
"type": "string"
},
"customer": {
"properties": {
"buildingNumber": {
"maxLength": 30,
"type": "string"
},
"city": {
"description": "City.",
"maxLength": 100,
"type": "string"
},
"country": {
"default": "Türkiye",
"maxLength": 60,
"type": "string"
},
"district": {
"description": "District.",
"maxLength": 100,
"type": "string"
},
"email": {
"maxLength": 120,
"type": "string"
},
"name": {
"description": "Registered trade name, or the person’s full name.",
"maxLength": 300,
"minLength": 2,
"type": "string"
},
"phone": {
"maxLength": 40,
"type": "string"
},
"postalCode": {
"maxLength": 10,
"type": "string"
},
"street": {
"maxLength": 200,
"type": "string"
},
"taxNumber": {
"description": "VKN (10 digits) or, for an individual, TCKN (11 digits).",
"maxLength": 11,
"minLength": 10,
"type": "string"
},
"taxOffice": {
"description": "Tax office (\"vergi dairesi\"). Required for VKN holders.",
"maxLength": 100,
"type": "string"
}
},
"required": [
"name",
"taxNumber"
],
"type": "object"
},
"despatchDocumentId": {
"description": "Delivery note number, if the goods shipped separately.",
"maxLength": 50,
"type": "string"
},
"exchangeRate": {
"description": "Units of TRY per one unit of `currency`.",
"exclusiveMinimum": 0,
"type": "number"
},
"id": {
"description": "Invoice number. Omit and supply `series` to have it built from the series and sequence.",
"pattern": "^[A-Z]{3}[0-9]{13}$",
"type": "string"
},
"invoiceTypeCode": {
"default": "SATIS",
"enum": [
"SATIS",
"IADE"
],
"type": "string"
},
"issueDate": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"issueTime": {
"pattern": "^\\d{2}:\\d{2}:\\d{2}$",
"type": "string"
},
"lines": {
"items": {
"properties": {
"discountRate": {
"default": 0,
"description": "Line discount percentage applied to the net amount.",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"name": {
"description": "Item or service description as it must appear on the invoice.",
"maxLength": 300,
"minLength": 1,
"type": "string"
},
"note": {
"maxLength": 500,
"type": "string"
},
"quantity": {
"default": 1,
"exclusiveMinimum": 0,
"maximum": 1000000000,
"type": "number"
},
"sellerItemCode": {
"maxLength": 60,
"type": "string"
},
"unitCode": {
"default": "C62",
"description": "UN/ECE unit code. C62 = piece, KGM = kg, MTR = metre, HUR = hour.",
"maxLength": 10,
"minLength": 1,
"type": "string"
},
"unitPrice": {
"description": "Net unit price, before VAT and before the discount.",
"maximum": 1000000000000,
"minimum": 0,
"type": "number"
},
"vatExemptionReasonCode": {
"description": "Required by the tax authority when vatRate is 0.",
"maxLength": 10,
"type": "string"
},
"vatRate": {
"default": 20,
"description": "VAT percentage, e.g. 20, 10, 1 or 0.",
"maximum": 100,
"minimum": 0,
"type": "number"
}
},
"required": [
"name",
"unitPrice"
],
"type": "object"
},
"maxItems": 500,
"minItems": 1,
"type": "array"
},
"notes": {
"default": [],
"items": {
"maxLength": 1000,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"orderReferenceId": {
"maxLength": 50,
"type": "string"
},
"profile": {
"default": "TEMELFATURA",
"description": "TEMELFATURA: no formal objection flow. TICARIFATURA: buyer may accept/reject. EARSIVFATURA: buyer is not an e-Invoice user.",
"enum": [
"TEMELFATURA",
"TICARIFATURA",
"EARSIVFATURA"
],
"type": "string"
},
"sequence": {
"description": "Sequence number within the series and year.",
"maximum": 999999999,
"minimum": 1,
"type": "integer"
},
"series": {
"description": "Three-letter series code, used with `sequence`.",
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"supplier": {
"properties": {
"buildingNumber": {
"maxLength": 30,
"type": "string"
},
"city": {
"description": "City.",
"maxLength": 100,
"type": "string"
},
"country": {
"default": "Türkiye",
"maxLength": 60,
"type": "string"
},
"district": {
"description": "District.",
"maxLength": 100,
"type": "string"
},
"email": {
"maxLength": 120,
"type": "string"
},
"name": {
"description": "Registered trade name, or the person’s full name.",
"maxLength": 300,
"minLength": 2,
"type": "string"
},
"phone": {
"maxLength": 40,
"type": "string"
},
"postalCode": {
"maxLength": 10,
"type": "string"
},
"street": {
"maxLength": 200,
"type": "string"
},
"taxNumber": {
"description": "VKN (10 digits) or, for an individual, TCKN (11 digits).",
"maxLength": 11,
"minLength": 10,
"type": "string"
},
"taxOffice": {
"description": "Tax office (\"vergi dairesi\"). Required for VKN holders.",
"maxLength": 100,
"type": "string"
}
},
"required": [
"name",
"taxNumber"
],
"type": "object"
},
"uuid": {
"description": "Document UUID (ETTN). Generated when omitted.",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
}
},
"required": [
"issueDate",
"supplier",
"customer",
"lines"
],
"type": "object"
},
"name": "tr_invoice_build",
"outputSchema": null
},
{
"description": "Turns a UBL-TR e-Invoice or e-Archive XML document into clean JSON: parties, line items, taxes and totals.\n\nWorks regardless of the namespace prefix the sender used (cbc:, cac:, ns0:), normalises single-line documents into arrays, and reports amount mismatches in `warnings` instead of returning quietly wrong totals. The job that costs accounting and expense software the most engineering time.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"xml": {
"description": "UBL-TR e-Invoice / e-Archive (e-Arsiv) XML body.",
"maxLength": 4000000,
"minLength": 20,
"type": "string"
}
},
"required": [
"xml"
],
"type": "object"
},
"name": "tr_invoice_parse",
"outputSchema": null
},
{
"description": "Computes Turkish severance (kıdem), notice (ihbar) and annual-leave entitlement from service dates and the gross wage, using the official ceiling and minimum-wage tables for the given day.\n\nPayroll and HR tools in Turkey chase a parameter that changes every January and July: the severance ceiling, the SGK cap, the minimum wage. This endpoint applies the statutory formulae (Labour Law 4857 arts. 17 and 53, former 1475 art. 14) to those tables. The ceiling is applied to the monthly wage, not the total. Stamp tax (0.759%) is deducted from severance; income tax is not — kıdem is exempt. Notice pay IS taxable; we return the gross and say so, because the actual withholding depends on the employee's cumulative tax base. What this will not tell you: whether the employee is entitled to severance at all. That depends on the reason for termination (retirement, just cause, marriage, military service…). Treating the number as \"what is owed\" is how you lose at trial.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"age": {
"description": "Employee age at termination — affects annual-leave entitlement (under 18 or 50+).",
"maximum": 90,
"minimum": 15,
"type": "integer"
},
"asOf": {
"description": "Rate table date. Defaults to endDate.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"endDate": {
"description": "Termination date (YYYY-MM-DD). Inclusive of this day.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"monthlyGross": {
"description": "Gross monthly wage the severance is based on (giydirilmiş brüt).",
"exclusiveMinimum": 0,
"maximum": 10000000,
"type": "number"
},
"startDate": {
"description": "Employment start date (YYYY-MM-DD).",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"unusedLeaveDays": {
"description": "Unused annual-leave days, if you also want the unused-leave gross.",
"maximum": 400,
"minimum": 0,
"type": "number"
}
},
"required": [
"startDate",
"endDate",
"monthlyGross"
],
"type": "object"
},
"name": "tr_labor",
"outputSchema": null
},
{
"description": "Writes a monetary amount out in Turkish words, the way invoices, cheques and promissory notes require.\n\nApplies the rules that trip up generic libraries: Turkish says \"bin\", never \"bir bin\"; the kuruş part is read separately; and both \"1.234,56\" and \"1,234.56\" are accepted and told apart automatically. A mandatory field on Turkish e-invoices, cheques and notes — with no off-the-shelf API until now.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"amount": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
],
"description": "Amount. Accepts both \"1.234,56\" and 1234.56."
},
"currency": {
"default": "TRY",
"enum": [
"TRY",
"USD",
"EUR",
"GBP"
],
"type": "string"
},
"style": {
"default": "lower",
"description": "Output letter case.",
"enum": [
"lower",
"title",
"upper"
],
"type": "string"
},
"wrapHash": {
"default": false,
"type": "boolean"
}
},
"required": [
"amount"
],
"type": "object"
},
"name": "tr_money_to_words",
"outputSchema": null
},
{
"description": "Validates a 5-digit Turkish postal code and resolves the province from the first two digits (plate map).\n\nPTT postal codes are five digits; the leading pair matches the province plate code for the 81 provinces. This endpoint checks the shape, maps 01–81 to the province name, and returns null with confidence none when the prefix is outside that range — it does not invent a district. District-level resolution needs the full PTT directory and is out of scope here.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"postalCode": {
"description": "Turkish 5-digit postal code, with or without spaces.",
"maxLength": 10,
"minLength": 3,
"type": "string"
}
},
"required": [
"postalCode"
],
"type": "object"
},
"name": "tr_posta_kodu",
"outputSchema": null
},
{
"description": "Builds a person-to-person TR Karekod (FAST) payment payload from IBAN, name and optional TRY amount. Text only — no PNG.\n\nTurkish instant payments (FAST) can start from a TR Karekod that encodes the payee IBAN and name in EMV-style TLV. This builds the person-to-person organisation (payload format indicator 750210): application template with IBAN, payee name, optional 12-digit kuruş amount, optional free-text explanation, and a CRC-16/CCITT-FALSE trailer. The Turkish IBAN is normalised and checked with ISO 7064 mod-97; non-TR IBANs and non-TRY currencies are rejected. This does not send money and does not render a QR image.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"amount": {
"description": "TRY amount; omitted → static QR (payer enters amount).",
"type": "number"
},
"currency": {
"description": "Must be TRY if provided.",
"type": "string"
},
"explanation": {
"description": "Optional remittance note (application free field 10).",
"type": "string"
},
"generatorCode": {
"description": "QR generator / EFT code (4 digits). Defaults to last 4 of the IBAN bank code.",
"type": "string"
},
"iban": {
"description": "Beneficiary Turkish IBAN (with or without spaces).",
"type": "string"
},
"name": {
"description": "Payee name shown to the payer (2–26 chars after trim).",
"type": "string"
}
},
"required": [
"iban",
"name"
],
"type": "object"
},
"name": "tr_qr_odeme",
"outputSchema": null
},
{
"description": "Computes the deemed-received date and the HMK deadline (with holiday shifting) for a Turkish notification, from the date the underlying event actually happened.\n\nTurkish notification law (7201) ties the deadline clock to an event that is not \"the date on the letter\" — for electronic notification the UETS platform reports send, read AND reached dates, and only the reached date starts the clock (art. 7/a: deemed received 5 calendar days after reaching the address, whether or not it was opened). HMK adds two more rules on top: the day of notification itself does not count (art. 92 — the period starts the next day) and if the computed last day lands on a weekend or a full public/religious holiday, it moves to the next business day (art. 93); a half-day eve (arife) does not shift it. What this will not tell you: whether the notification was itself valid, or what a specific `periodType` (itiraz, temyiz, cevap…) is in days for your case — that number differs by statute and we do not guess it; supply `periodDays` yourself. Only the \"hmk\" law family is covered so far.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"basisDate": {
"description": "The date `basisLabel` describes for this type — for \"electronic\" this is the date UETS reports the message as reached, not sent or read.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"hasAttorney": {
"description": "Whether the addressee has a registered attorney of record. When true and `type` is not \"vekil\", a TK 11 warning is added noting that service should have gone to the attorney.",
"type": "boolean"
},
"ilanenDeemedDays": {
"description": "Only valid with type \"ilanen\": number of days the competent authority set for the notice to become deemed received (TK 31), 7-15, default 7. Not the number of days for the underlying period.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"lawFamily": {
"description": "Body of procedural law the period is computed under. Only \"hmk\" (Code of Civil Procedure) is supported so far.",
"enum": [
"hmk"
],
"type": "string"
},
"periodDays": {
"description": "Length of the statutory or judicial period, in days, counted from `periodStart`.",
"exclusiveMinimum": 0,
"maximum": 3650,
"type": "integer"
},
"periodType": {
"description": "Free-text label for the period (e.g. \"itiraz\", \"temyiz\"), echoed back only — not mapped to a day count.",
"maxLength": 120,
"type": "string"
},
"subjectToJudicialRecess": {
"description": "Whether this matter is subject to the judicial recess (adli tatil, HMK 104) instead of being exempt. Only affects the result when `lawFamily` is \"hmk\" and the computed last day falls in the 20 July - 31 August window.",
"type": "boolean"
},
"type": {
"description": "Notification method. Determines which event `basisDate` refers to and whether the deemed-received date is same-day or shifted.",
"enum": [
"electronic",
"physical",
"vekil",
"ilanen",
"last_known_address"
],
"type": "string"
}
},
"required": [
"type",
"lawFamily",
"basisDate",
"periodDays"
],
"type": "object"
},
"name": "tr_tebligat_clock",
"outputSchema": null
},
{
"description": "Validates Turkish national ID, tax number, IBAN, licence plate, IMEI, barcodes, KEP, MERSİS, postal code and ISBN from one endpoint, with type auto-detection.\n\nGoes past a yes/no: resolves the bank behind an IBAN, the province behind a licence plate and the GS1 country prefix behind a barcode. Pure local computation — no upstream service is called, so latency is microseconds and the answer never changes for the same input.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"type": {
"default": "auto",
"description": "Omitted → inferred from the format.",
"enum": [
"auto",
"tckn",
"vkn",
"iban",
"plate",
"imei",
"gtin",
"kep",
"mersis",
"postal",
"isbn"
],
"type": "string"
},
"value": {
"description": "Value to validate.",
"maxLength": 64,
"minLength": 1,
"type": "string"
}
},
"required": [
"value"
],
"type": "object"
},
"name": "tr_validate",
"outputSchema": null
},
{
"description": "Splits a Turkish amount into net, VAT and (optionally) withholding: who pays the seller, who remits the withheld VAT.\n\nFor invoice lines and checkout totals that have to show KDV dahil / hariç and, when the parties are in a withholding (tevkifat) situation, the split between what the buyer pays the seller and what the buyer remits to the tax office. Rates are 0, 1, 10 and 20 percent. Withholding is a fraction of the VAT (2/10 through 10/10), or a named code from the GİB partial-withholding list. The 2026 threshold (TRY 12,000 gross) is reported and compared with the amount, but `applies` is always null: whether withholding actually applies depends on the taxpayer status of both parties, which this endpoint does not know. Feeding it a fraction is not a legal opinion.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"amount": {
"description": "The amount to tax. See amountIncludesVat.",
"maximum": 1000000000000,
"minimum": 0,
"type": "number"
},
"amountIncludesVat": {
"default": false,
"description": "If true, `amount` is the gross (KDV dahil); if false, it is the net/matrah.",
"type": "boolean"
},
"rate": {
"anyOf": [
{
"const": 0,
"type": "number"
},
{
"const": 1,
"type": "number"
},
{
"const": 10,
"type": "number"
},
{
"const": 20,
"type": "number"
}
],
"default": 20,
"description": "VAT rate in percent. 0, 1, 10 or 20."
},
"withholding": {
"description": "Withholding fraction such as \"5/10\", or a code from the list (reklam, tasima, hurda, isgucu…).",
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
},
"name": "tr_vat",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:7fc97501e33a1a6ba206ed4bd042c105b5a9efb5597efd6827643a530f1d8656 | sha256sum