MCP Radar
MCP Server

Temsor API — Turkey & EU business data

com.temsor/api
Business & Operations Communication Payments & Fintech Public & reachable MCP 2026-07-28

What this MCP does

Provides business identity and payment-data validation, tax and FX information, sanctions-related lookups, and PBX call indexing and transfer records.

Capabilities

Tools

43 tools
email_verify
E-mail Verification
Checks an e-mail address: syntax, whether the domain can actually receive mail, disposable and role-account detection, and typo correction. No 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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['email'], 'properties': {'email': {'type': 'string', 'maxLength': 254, 'minLength': 3, 'description': 'E-mail address to check.'}, 'rejectRoleAccounts': {'type': 'boolean', 'default': False}, 'rejectFreeProviders': {'type': 'boolean', 'default': False}}}
iban_validate
IBAN Validation
Validates an IBAN from any of 70+ countries: checksum, country length and in-country account structure, and resolves the bank and branch codes. Most 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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['iban'], 'properties': {'iban': {'type': 'string', 'maxLength': 42, 'minLength': 5, 'description': 'IBAN, with or without spaces.'}, 'expectCountry': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'Expected country code (ISO 3166-1 alpha-2).'}}}
pbx_audio_chunk
PBX Audio Chunk
Notify an optional audio chunk / customer URI for a live or archived call (idle $0). Prefer customer storage URI. Temsor keeps a pointer; STT only while a call is active.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['call_id'], 'properties': {'uri': {'type': 'string', 'format': 'uri', 'description': 'Customer-side media URI (preferred).'}, 't_ms': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'pbx_id': {'type': 'string', 'maxLength': 64}, 'call_id': {'type': 'string', 'maxLength': 64, 'minLength': 2}, 'bytes_b64': {'type': 'string', 'maxLength': 200000, 'description': 'Optional small demo chunk; production prefers URI.'}}}
pbx_calls
PBX Recent Calls
List recent calls with transfer path crumbs — site + customer archive browser. GET /v1/pbx/calls?limit=20. Scoped by x-temsor-pbx-key when set. Idle $0. No DID sales.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Max recent calls to return (1–100).'}}}
pbx_calls_get
PBX Get Call
Get one call by id with transfer graph — customer detail drawer. GET /v1/pbx/calls/get?call_id=…. Scoped by x-temsor-pbx-key. found=false if missing. Idle $0.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['call_id'], 'properties': {'call_id': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': 'Call id (e.g. call_msp_002).'}}}
pbx_calls_graph
Call Handoff Graph
Handoff graph + transfer edges — who→whom→where the promise stuck (moat). Idle $0. GET /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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['call_id'], 'properties': {'call_id': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': 'Call id whose transfer graph to return.'}, 'stuck_at': {'type': 'string', 'maxLength': 16, 'description': 'Optional override for where the promise stuck (extension).'}}}
pbx_dictionary
PBX Domain Dictionary
Managed SaaS domain dictionary (E4) — example packs thicken per pilot (tenant-scoped aliases). Boosts search + Fact extract. No invented premiums. GET /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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'domain': {'enum': ['otel', 'santral_firmasi', 'msp', 'sigorta', 'finans', 'enerji', 'otomotiv', 'all'], 'type': 'string', 'default': 'all', 'description': 'Domain slice: otel | santral_firmasi | sigorta | finans | enerji | otomotiv (legacy msp) | all'}}}
pbx_dictionary_add
PBX Dictionary Add Alias
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. POST /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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['term', 'alias'], 'properties': {'kind': {'enum': ['imei', 'tarife', 'oda', 'oda_tipi', 'klima', 'check_out', 'iade', 'sku', 'police', 'hasar', 'yenileme', 'abone', 'kesinti', 'fatura', 'kart', 'iban', 'sube', 'other'], 'type': 'string', 'description': 'Fact kind; inferred from seed term when omitted.'}, 'term': {'type': 'string', 'maxLength': 64, 'minLength': 2, 'description': 'Canonical term (e.g. AC, tariff). Plain Turkish preferred.'}, 'alias': {'type': 'string', 'maxLength': 64, 'minLength': 2, 'description': 'Synonym / alias to add (e.g. cooling, line package).'}, 'boost': {'type': 'number', 'maximum': 5, 'minimum': 1, 'description': 'Search boost weight (default 2).'}, 'scope': {'enum': ['pbx', 'global'], 'type': 'string', 'description': 'pbx = scoped to x-temsor-pbx-key; global = demo-wide. Default: pbx if registered key, else global.'}, 'domain': {'enum': ['otel', 'santral_firmasi', 'msp', 'sigorta', 'finans', 'enerji', 'otomotiv'], 'type': 'string', 'default': 'otel', 'description': 'Domain: otel | santral_firmasi | sigorta | finans | enerji | otomotiv (legacy msp accepted).'}, 'hint_en': {'type': 'string', 'maxLength': 160}, 'hint_tr': {'type': 'string', 'maxLength': 160}}}
pbx_events
Call Events Ingest
Ingest call-ops events → open promises + transfer crumbs for search/orchestration. Optional HMAC. Idle $0 when no calls. Demo 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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['events'], 'properties': {'events': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'maxItems': 200, 'minItems': 1, 'description': 'ARI / Stasis event batch. Utterance/text fields trigger heuristic promise extract.'}, 'pbx_id': {'type': 'string', 'maxLength': 64, 'minLength': 2, 'description': 'PBX id that emitted the ARI batch.'}}}
pbx_facts
PBX Facts List
List extracted facts (IMEI, room, tariff…) from the durable index — filter by call_id, kind, domain, q. GET /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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'q': {'type': 'string', 'maxLength': 200, 'description': 'Free-text filter over kind + value + call_id.'}, 'kind': {'type': 'string', 'maxLength': 32, 'description': 'Fact kind key (imei, oda, tarife, ...) or all.'}, 'limit': {'type': 'integer', 'default': 50, 'maximum': 200, 'minimum': 1, 'description': 'Max facts to return (1–200).'}, 'domain': {'enum': ['otel', 'santral_firmasi', 'msp', 'sigorta', 'finans', 'enerji', 'otomotiv', 'all'], 'type': 'string', 'description': 'Domain slice: otel | santral_firmasi | sigorta | finans | enerji (legacy msp) | all.'}, 'call_id': {'type': 'string', 'maxLength': 80, 'description': 'Filter by call id (e.g. call_msp_001).'}}}
pbx_facts_get
PBX Get Fact
Get one extracted fact by id — detail drawer for site + customer. GET /v1/pbx/facts/get?id=…. Scoped by x-temsor-pbx-key. found=false if missing. Idle $0. No DID sales.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': 'Fact id (e.g. fact_001).'}}}
pbx_index_partial
PBX In-Call Partial Index Upsert
Upsert mid-call partial index (utterances → fact/promise hints). Path to ≤400ms whisper; ≤600/hour/key → 429; idle $0. POST /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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['call_id'], 'properties': {'live': {'type': 'boolean', 'description': 'Default true while call is live.'}, 't_ms': {'anyOf': [{'type': 'integer', 'maximum': 86400000, 'minimum': 0}, {'type': 'null'}]}, 'text': {'type': 'string', 'maxLength': 2000, 'description': 'Partial utterance / snippet (customer STT or demo). Empty = metadata-only.'}, 'pbx_id': {'type': 'string', 'maxLength': 64}, 'call_id': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': 'Live call id to upsert partial index for.'}, 'promote': {'type': 'boolean', 'description': 'Promote heuristic hints into durable Promise/Fact docs.'}, 'speaker': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'end_call': {'type': 'boolean', 'description': 'Mark live=false; idle $0 for this call.'}, 'is_final': {'type': 'boolean', 'description': 'Finalized utterance span (vs interim).'}}}
pbx_index_partial_get
PBX In-Call Partial Index Read
GET mid-call partial index — accumulating facts/promises/snippets while live. GET /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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['call_id'], 'properties': {'call_id': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': 'Call id whose live partial index to read.'}}}
pbx_ingest_transcript
PBX Ingest Transcript
Heuristic TR promise extractor from transcript text — creates open Promise docs (idle $0, no LLM). Detects 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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['transcript'], 'properties': {'ext': {'type': 'string', 'maxLength': 16}, 'who': {'type': 'string', 'maxLength': 120}, 'pbx_id': {'type': 'string', 'maxLength': 64}, 'call_id': {'type': 'string', 'maxLength': 64}, 'transcript': {'type': 'string', 'maxLength': 50000, 'minLength': 1, 'description': 'TR utterance / transcript text to scan for promises.'}, 'persist_promises': {'type': 'boolean', 'default': True, 'description': 'When false, extract only (dry-run, no write). When true, create Promise docs status=open.'}}}
pbx_persons
PBX Persons List
Light CRM from call graph / facts — caller phones+names and extension identities seen on transfers. GET /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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'q': {'type': 'string', 'maxLength': 200, 'description': 'Free-text over names, phones, org, extensions, facts.'}, 'kind': {'enum': ['caller', 'extension', 'all'], 'type': 'string', 'description': 'caller = durable Person; extension = derived from call-graph hops; all = both.'}, 'limit': {'type': 'integer', 'default': 50, 'maximum': 200, 'minimum': 1, 'description': 'Max persons to return (1–200).'}, 'call_id': {'type': 'string', 'maxLength': 80, 'description': 'Filter persons seen on this call id.'}, 'include_extensions': {'type': 'boolean', 'description': 'Include derived extension identities (default true).'}}}
pbx_persons_get
PBX Get Person
Get one light-CRM identity by id — caller Person or derived extension. GET /v1/pbx/persons/get?id=per_001|ext_101. Scoped by x-temsor-pbx-key. found=false if missing. Idle $0. No DID sales.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': 'Person id (e.g. per_001) or extension id (e.g. ext_101).'}}}
pbx_promises
Open Call Promises
List open/broken call promises for agent handoff tracking — hotel / MSP sales demo. Idle $0. GET /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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'status': {'enum': ['open', 'kept', 'broken', 'unknown', 'all', 'closed'], 'type': 'string', 'default': 'open', 'description': 'Promise status filter; closed = kept|broken. Sales demo uses open.'}}}
pbx_promises_act
Promise → Orchestra Closed Loop
E1 moat: who→whom→promise → orchestra handoff intent (whisper/transfer/hold). Idle $0. No live PSTN. Own PBX = advanced footnote. POST /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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['promise_id'], 'properties': {'action': {'enum': ['whisper', 'hold', 'transfer', 'pci_stop', 'snoop'], 'type': 'string', 'description': 'Default whisper. transfer uses graph stuck_at / promise.ext.'}, 'pbx_id': {'type': 'string', 'maxLength': 64}, 'agent_ext': {'type': 'string', 'maxLength': 64}, 'promise_id': {'type': 'string', 'maxLength': 64, 'minLength': 2, 'description': 'Open (or any) promise id — closed loop reads call graph then records orchestra intent.'}, 'skip_forward': {'type': 'boolean', 'description': 'Default true — record intent only.'}, 'stasis_webhook_url': {'type': 'string', 'maxLength': 500}}}
pbx_promises_close
PBX Close Promise
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. POST /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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['promise_id', 'status'], 'properties': {'note': {'type': 'string', 'maxLength': 200, 'description': 'Optional short operator note. Phones/emails stripped (KVKK-safe).'}, 'status': {'enum': ['kept', 'broken'], 'type': 'string', 'description': 'Close outcome: kept (honoured) or broken (not kept).'}, 'promise_id': {'type': 'string', 'maxLength': 64, 'minLength': 2, 'description': 'Promise id (prm_*). Sales demo marks open promises kept|broken.'}}}
pbx_promises_export
PBX Promises Export
Export open/broken promises as CSV or JSON — hotel / PBX-provider unclosed-promise sales list. GET /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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'format': {'enum': ['csv', 'json'], 'type': 'string', 'default': 'csv', 'description': 'Export format.'}, 'status': {'enum': ['open', 'kept', 'broken', 'unknown', 'all', 'closed'], 'type': 'string', 'default': 'open', 'description': 'Promise status filter; closed = kept|broken. Sales demo uses open.'}}}
pbx_promises_reopen
PBX Reopen Promise
Undo a kept/broken close — restore an open promise so the sales demo can reverse a mis-click. ≤60/hour/key → 429. POST /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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['promise_id'], 'properties': {'promise_id': {'type': 'string', 'maxLength': 64, 'minLength': 2, 'description': 'Promise id (prm_*). Undo a kept|broken close — restore open.'}}}
pbx_redact
PBX Redact
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. E.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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'who': {'type': 'string', 'maxLength': 80, 'description': 'Actor label for durable audit (defaults to pbx scope / demo-operator).'}, 'mode': {'enum': ['anonymize', 'delete'], 'type': 'string', 'description': 'anonymize (default) scrubs fields; delete removes docs.'}, 'phone': {'type': 'string', 'maxLength': 32, 'minLength': 7, 'description': 'Caller phone — finds Person phones (+ linked derived index).'}, 'reason': {'type': 'string', 'maxLength': 200, 'description': 'KVKK (personal-data) / forget reason.'}, 'target_id': {'type': 'string', 'maxLength': 64, 'minLength': 2, 'description': 'Document id (prm_*, per_*, call_*, fact_*).'}, 'target_type': {'enum': ['promise', 'call', 'person', 'fact', 'utterance'], 'type': 'string', 'description': 'Index document type. Optional when `phone` is set.'}}}
pbx_redact_audit
PBX Redact Audit
List recent KVKK forget actions — who/what/when + tenant scope. Managed SaaS derived-index audit; not a legal deletion SLA. GET /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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max recent forget actions to return (default 20).'}}}
pbx_register
PBX Register
Register a pilot PBX; returns pbx_id + API key once (hashed at rest). ≤5/hour/IP → 429. Idle $0. Control-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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'name': {'type': 'string', 'maxLength': 120, 'description': 'Pilot contact name (waitlist / register).'}, 'email': {'type': 'string', 'format': 'email', 'pattern': "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", 'maxLength': 254, 'description': 'Pilot contact email.'}, 'label': {'type': 'string', 'maxLength': 120, 'description': 'Human label, e.g. hotel or PBX/IT provider site.'}, 'pbx_id': {'type': 'string', 'maxLength': 64, 'minLength': 2, 'description': 'Pilot PBX id; auto-minted if omitted.'}, 'webhook_url': {'type': 'string', 'format': 'uri', 'maxLength': 500, 'description': 'Optional outbound webhook URL — Temsor POSTs promise/fact/orchestra/redact events.'}, 'webhook_events': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'string'}], 'description': 'Event list or comma string: promise.opened|closed, fact.extracted, orchestra.act, redact, or *.'}, 'webhook_secret': {'type': 'string', 'maxLength': 200, 'description': 'Optional HMAC secret for outbound webhook signatures (x-temsor-signature).'}, 'ari_webhook_secret': {'type': 'string', 'maxLength': 200, 'description': 'ARI webhook signing secret (stored as hint only).'}}}
pbx_search
Voice Archive Search
Agent archive search over call promises and facts — voice-Google for call-ops, not a receptionist bot. Idle $0. Demo 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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'q': {'type': 'string', 'default': '', 'maxLength': 200, 'description': 'Full-text query over promises, facts, and call summaries.'}, 'ext': {'type': 'string', 'maxLength': 16}, 'status': {'enum': ['open', 'kept', 'broken', 'unknown'], 'type': 'string'}, 'date_to': {'type': 'string', 'maxLength': 40, 'description': 'ISO date/time upper bound.'}, 'date_from': {'type': 'string', 'maxLength': 40, 'description': 'ISO date/time lower bound (promise.when_iso / call.started_at).'}, 'competitor': {'type': 'string', 'maxLength': 64}, 'stuck_after': {'type': 'string', 'maxLength': 16, 'description': 'Filter: promise stuck after transfer to this extension (to_ext hop).'}}}
pbx_status
PBX Status
Control-plane status — promise/orchestra/search counts + idle $0. No DID sales. GET /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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'description': 'No input — scoped by x-temsor-pbx-key when set.'}
pbx_webhooks
PBX Outbound Webhooks
Register or list outbound webhooks — customer URL receives promise/fact/orchestra/redact events (HMAC if secret). POST write ≤30/hour/key → 429. POST /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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'url': {'type': 'string', 'maxLength': 500, 'description': 'Outbound webhook URL (http/https). Present → register; omit on GET → list.'}, 'ping': {'type': 'boolean', 'description': 'If true with url → register then ping; if true without url → ping existing.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'List limit (default 50).'}, 'events': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'string'}], 'description': 'Events: promise.opened|closed, fact.extracted, orchestra.act, redact, or *.'}, 'secret': {'type': 'string', 'maxLength': 200, 'description': 'Optional HMAC-SHA256 secret → x-temsor-signature: sha256=<hex>.'}, 'webhook_id': {'type': 'string', 'maxLength': 64, 'description': 'For ping: target webhook id.'}}}
pbx_webhooks_deliveries
PBX Webhook Deliveries
List last N outbound webhook deliveries (stub or live) — promise/fact/orchestra/redact/ping. GET /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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max deliveries (default 20).'}, 'webhook_id': {'type': 'string', 'maxLength': 64, 'description': 'Filter by webhook id.'}}}
pbx_whisper_status
PBX Whisper RTP Status
Capability: mode=stub|ready from TEMSOR_RTP_*. No live RTP on forge; idle $0. GET /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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'description': 'No input — TEMSOR_RTP_* from process env.'}
pbx_whisper_suggest
PBX Live Whisper Suggest
Live agent handoff cards (≤3): open promises/facts from in-call index. Idle $0. Lab: TEMSOR_RTP_LAB=1 → lab_latency_ms. POST /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).
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['call_id'], 'properties': {'call_id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Active call id for agent UI context.'}, 'partial_text': {'type': 'string', 'default': '', 'maxLength': 2000, 'description': 'Partial transcript / utterance text (no live speech recognition).'}}}
phone_validate
Phone Number Validation
Validates and normalises a phone number to E.164, classifies the line type, and resolves the province for Turkish landlines. For 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. One 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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['phone'], 'properties': {'phone': {'type': 'string', 'maxLength': 30, 'minLength': 4, 'description': 'Phone number in any common format.'}, 'defaultCountry': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 3166-1 alpha-2 country to assume when the number has no international prefix. Defaults to TR.'}}}
tr_address_parse
Turkish Address Parser
Splits a free-form Turkish address into neighbourhood, street, building, floor, flat, district, province and postcode. Handles 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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['address'], 'properties': {'address': {'type': 'string', 'maxLength': 500, 'minLength': 3, 'description': 'Free-text address.'}, 'defaultProvince': {'type': 'string', 'description': 'Province to assume when the address has none.'}}}
tr_business_days
Turkish Business Days
Adds business days or counts them between two dates, accounting for Turkish public and religious holidays including half-day eves. Ramadan 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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['start'], 'properties': {'end': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'If set, count business days between start and this date.'}, 'start': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Start date (YYYY-MM-DD).'}, 'addDays': {'type': 'integer', 'maximum': 3650, 'minimum': -3650, 'description': 'Add/subtract this many business days (not calendar days).'}, 'countHalfDaysAsWork': {'type': 'boolean', 'default': True, 'description': 'Count Arife half-days as working days?'}}}
tr_iban_olustur
Build Turkish IBAN
Builds a Turkish IBAN from a 5-digit bank code and account number, computing ISO 7064 check digits. A 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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['bankCode', 'accountNumber'], 'properties': {'bankCode': {'type': 'string', 'description': '5-digit Turkish national bank / EFT code (e.g. 00062).'}, 'reserved': {'type': 'string', 'description': 'Reserved BBAN digit after the bank code. Defaults to 0.'}, 'accountNumber': {'type': 'string', 'description': 'Account number, up to 16 alphanumeric characters (padded left with zeros).'}}}
tr_invoice_build
Turkish e-Invoice Builder
Builds a UBL-TR e-Invoice or e-Archive XML document from plain JSON, computing every total and validating the parties. Selling 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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['issueDate', 'supplier', 'customer', 'lines'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Z]{3}[0-9]{13}$', 'description': 'Invoice number. Omit and supply `series` to have it built from the series and sequence.'}, 'uuid': {'type': 'string', '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)$', 'description': 'Document UUID (ETTN). Generated when omitted.'}, 'lines': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'unitPrice'], 'properties': {'name': {'type': 'string', 'maxLength': 300, 'minLength': 1, 'description': 'Item or service description as it must appear on the invoice.'}, 'note': {'type': 'string', 'maxLength': 500}, 'vatRate': {'type': 'number', 'default': 20, 'maximum': 100, 'minimum': 0, 'description': 'VAT percentage, e.g. 20, 10, 1 or 0.'}, 'quantity': {'type': 'number', 'default': 1, 'maximum': 1000000000, 'exclusiveMinimum': 0}, 'unitCode': {'type': 'string', 'default': 'C62', 'maxLength': 10, 'minLength': 1, 'description': 'UN/ECE unit code. C62 = piece, KGM = kg, MTR = metre, HUR = hour.'}, 'unitPrice': {'type': 'number', 'maximum': 1000000000000, 'minimum': 0, 'description': 'Net unit price, before VAT and before the discount.'}, 'discountRate': {'type': 'number', 'default': 0, 'maximum': 100, 'minimum': 0, 'description': 'Line discount percentage applied to the net amount.'}, 'sellerItemCode': {'type': 'string', 'maxLength': 60}, 'vatExemptionReasonCode': {'type': 'string', 'maxLength': 10, 'description': 'Required by the tax authority when vatRate is 0.'}}}, 'maxItems': 500, 'minItems': 1}, 'notes': {'type': 'array', 'items': {'type': 'string', 'maxLength': 1000}, 'default': [], 'maxItems': 20}, 'series': {'type': 'string', 'pattern': '^[A-Z]{3}$', 'description': 'Three-letter series code, used with `sequence`.'}, 'profile': {'enum': ['TEMELFATURA', 'TICARIFATURA', 'EARSIVFATURA'], 'type': 'string', 'default': 'TEMELFATURA', 'description': 'TEMELFATURA: no formal objection flow. TICARIFATURA: buyer may accept/reject. EARSIVFATURA: buyer is not an e-Invoice user.'}, 'currency': {'type': 'string', 'default': 'TRY', 'maxLength': 3, 'minLength': 3, 'description': 'ISO 4217. Anything other than TRY requires `exchangeRate`.'}, 'customer': {'type': 'object', 'required': ['name', 'taxNumber'], 'properties': {'city': {'type': 'string', 'maxLength': 100, 'description': 'City.'}, 'name': {'type': 'string', 'maxLength': 300, 'minLength': 2, 'description': 'Registered trade name, or the person’s full name.'}, 'email': {'type': 'string', 'maxLength': 120}, 'phone': {'type': 'string', 'maxLength': 40}, 'street': {'type': 'string', 'maxLength': 200}, 'country': {'type': 'string', 'default': 'Türkiye', 'maxLength': 60}, 'district': {'type': 'string', 'maxLength': 100, 'description': 'District.'}, 'taxNumber': {'type': 'string', 'maxLength': 11, 'minLength': 10, 'description': 'VKN (10 digits) or, for an individual, TCKN (11 digits).'}, 'taxOffice': {'type': 'string', 'maxLength': 100, 'description': 'Tax office ("vergi dairesi"). Required for VKN holders.'}, 'postalCode': {'type': 'string', 'maxLength': 10}, 'buildingNumber': {'type': 'string', 'maxLength': 30}}}, 'sequence': {'type': 'integer', 'maximum': 999999999, 'minimum': 1, 'description': 'Sequence number within the series and year.'}, 'supplier': {'type': 'object', 'required': ['name', 'taxNumber'], 'properties': {'city': {'type': 'string', 'maxLength': 100, 'description': 'City.'}, 'name': {'type': 'string', 'maxLength': 300, 'minLength': 2, 'description': 'Registered trade name, or the person’s full name.'}, 'email': {'type': 'string', 'maxLength': 120}, 'phone': {'type': 'string', 'maxLength': 40}, 'street': {'type': 'string', 'maxLength': 200}, 'country': {'type': 'string', 'default': 'Türkiye', 'maxLength': 60}, 'district': {'type': 'string', 'maxLength': 100, 'description': 'District.'}, 'taxNumber': {'type': 'string', 'maxLength': 11, 'minLength': 10, 'description': 'VKN (10 digits) or, for an individual, TCKN (11 digits).'}, 'taxOffice': {'type': 'string', 'maxLength': 100, 'description': 'Tax office ("vergi dairesi"). Required for VKN holders.'}, 'postalCode': {'type': 'string', 'maxLength': 10}, 'buildingNumber': {'type': 'string', 'maxLength': 30}}}, 'issueDate': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'issueTime': {'type': 'string', 'pattern': '^\\d{2}:\\d{2}:\\d{2}$'}, 'exchangeRate': {'type': 'number', 'description': 'Units of TRY per one unit of `currency`.', 'exclusiveMinimum': 0}, 'amountInWords': {'type': 'boolean', 'default': True, 'description': 'Adds the payable amount written out in Turkish words as a note, the way invoices require.'}, 'invoiceTypeCode': {'enum': ['SATIS', 'IADE'], 'type': 'string', 'default': 'SATIS'}, 'orderReferenceId': {'type': 'string', 'maxLength': 50}, 'despatchDocumentId': {'type': 'string', 'maxLength': 50, 'description': 'Delivery note number, if the goods shipped separately.'}}}
tr_invoice_parse
Turkish e-Invoice (UBL-TR) Parser
Turns a UBL-TR e-Invoice or e-Archive XML document into clean JSON: parties, line items, taxes and totals. Works 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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['xml'], 'properties': {'xml': {'type': 'string', 'maxLength': 4000000, 'minLength': 20, 'description': 'UBL-TR e-Invoice / e-Archive (e-Arsiv) XML body.'}}}
tr_labor
Turkish Severance, Notice & Leave
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. Payroll 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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['startDate', 'endDate', 'monthlyGross'], 'properties': {'age': {'type': 'integer', 'maximum': 90, 'minimum': 15, 'description': 'Employee age at termination — affects annual-leave entitlement (under 18 or 50+).'}, 'asOf': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Rate table date. Defaults to endDate.'}, 'endDate': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Termination date (YYYY-MM-DD). Inclusive of this day.'}, 'startDate': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Employment start date (YYYY-MM-DD).'}, 'monthlyGross': {'type': 'number', 'maximum': 10000000, 'description': 'Gross monthly wage the severance is based on (giydirilmiş brüt).', 'exclusiveMinimum': 0}, 'unusedLeaveDays': {'type': 'number', 'maximum': 400, 'minimum': 0, 'description': 'Unused annual-leave days, if you also want the unused-leave gross.'}}}
tr_money_to_words
Amount to Turkish Words
Writes a monetary amount out in Turkish words, the way invoices, cheques and promissory notes require. Applies 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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['amount'], 'properties': {'style': {'enum': ['lower', 'title', 'upper'], 'type': 'string', 'default': 'lower', 'description': 'Output letter case.'}, 'amount': {'anyOf': [{'type': 'string'}, {'type': 'number'}], 'description': 'Amount. Accepts both "1.234,56" and 1234.56.'}, 'currency': {'enum': ['TRY', 'USD', 'EUR', 'GBP'], 'type': 'string', 'default': 'TRY'}, 'wrapHash': {'type': 'boolean', 'default': False}}}
tr_posta_kodu
Turkish Postal Code
Validates a 5-digit Turkish postal code and resolves the province from the first two digits (plate map). PTT 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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['postalCode'], 'properties': {'postalCode': {'type': 'string', 'maxLength': 10, 'minLength': 3, 'description': 'Turkish 5-digit postal code, with or without spaces.'}}}
tr_qr_odeme
Turkish FAST / TR Karekod Payload
Builds a person-to-person TR Karekod (FAST) payment payload from IBAN, name and optional TRY amount. Text only — no PNG. Turkish 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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['iban', 'name'], 'properties': {'iban': {'type': 'string', 'description': 'Beneficiary Turkish IBAN (with or without spaces).'}, 'name': {'type': 'string', 'description': 'Payee name shown to the payer (2–26 chars after trim).'}, 'amount': {'type': 'number', 'description': 'TRY amount; omitted → static QR (payer enters amount).'}, 'currency': {'type': 'string', 'description': 'Must be TRY if provided.'}, 'explanation': {'type': 'string', 'description': 'Optional remittance note (application free field 10).'}, 'generatorCode': {'type': 'string', 'description': 'QR generator / EFT code (4 digits). Defaults to last 4 of the IBAN bank code.'}}}
tr_tebligat_clock
Turkish Service-of-Process Clock
Computes the deemed-received date and the HMK deadline (with holiday shifting) for a Turkish notification, from the date the underlying event actually happened. Turkish 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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['type', 'lawFamily', 'basisDate', 'periodDays'], 'properties': {'type': {'enum': ['electronic', 'physical', 'vekil', 'ilanen', 'last_known_address'], 'type': 'string', 'description': 'Notification method. Determines which event `basisDate` refers to and whether the deemed-received date is same-day or shifted.'}, 'basisDate': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'The date `basisLabel` describes for this type — for "electronic" this is the date UETS reports the message as reached, not sent or read.'}, 'lawFamily': {'enum': ['hmk'], 'type': 'string', 'description': 'Body of procedural law the period is computed under. Only "hmk" (Code of Civil Procedure) is supported so far.'}, 'periodDays': {'type': 'integer', 'maximum': 3650, 'description': 'Length of the statutory or judicial period, in days, counted from `periodStart`.', 'exclusiveMinimum': 0}, 'periodType': {'type': 'string', 'maxLength': 120, 'description': 'Free-text label for the period (e.g. "itiraz", "temyiz"), echoed back only — not mapped to a day count.'}, 'hasAttorney': {'type': 'boolean', '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.'}, 'ilanenDeemedDays': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, '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.'}, 'subjectToJudicialRecess': {'type': 'boolean', '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.'}}}
tr_validate
Turkish ID & Number Validation
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. Goes 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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['value'], 'properties': {'type': {'enum': ['auto', 'tckn', 'vkn', 'iban', 'plate', 'imei', 'gtin', 'kep', 'mersis', 'postal', 'isbn'], 'type': 'string', 'default': 'auto', 'description': 'Omitted → inferred from the format.'}, 'value': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Value to validate.'}}}
tr_vat
Turkish VAT & Withholding
Splits a Turkish amount into net, VAT and (optionally) withholding: who pays the seller, who remits the withheld VAT. For 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.
Input schema 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['amount'], 'properties': {'rate': {'anyOf': [{'type': 'number', 'const': 0}, {'type': 'number', 'const': 1}, {'type': 'number', 'const': 10}, {'type': 'number', 'const': 20}], 'default': 20, 'description': 'VAT rate in percent. 0, 1, 10 or 20.'}, 'amount': {'type': 'number', 'maximum': 1000000000000, 'minimum': 0, 'description': 'The amount to tax. See amountIncludesVat.'}, 'withholding': {'type': 'string', 'description': 'Withholding fraction such as "5/10", or a code from the list (reklam, tasima, hurda, isgucu…).'}, 'amountIncludesVat': {'type': 'boolean', 'default': False, 'description': 'If true, `amount` is the gross (KDV dahil); if false, it is the net/matrah.'}}}
History

Recent tool changes

Removed
vin_validate
Sept. 29, 2026, 3:03 a.m.
Removed
uuid_validate
Sept. 29, 2026, 3:03 a.m.
Removed
tr_fuel_prices
Sept. 29, 2026, 3:03 a.m.
Removed
tin_validate
Sept. 29, 2026, 3:03 a.m.
Removed
shipping_identify
Sept. 29, 2026, 3:03 a.m.
Removed
series_history
Sept. 29, 2026, 3:03 a.m.
Removed
sanctions_screen
Sept. 29, 2026, 3:03 a.m.
Removed
pbx_synthetic_run
Sept. 29, 2026, 3:03 a.m.
Removed
pbx_orchestra_acts
Sept. 29, 2026, 3:03 a.m.
Removed
pbx_orchestra_act
Sept. 29, 2026, 3:03 a.m.
Removed
pbx_night_twin_run
Sept. 29, 2026, 3:03 a.m.
Removed
pbx_night_twin_last
Sept. 29, 2026, 3:03 a.m.
Removed
pbx_bridge_multi_agent
Sept. 29, 2026, 3:03 a.m.
Removed
pay_epc_qr
Sept. 29, 2026, 3:03 a.m.
Removed
model_drift
Sept. 29, 2026, 3:03 a.m.
Removed
model_archive
Sept. 29, 2026, 3:03 a.m.
Removed
mcp_index
Sept. 29, 2026, 3:03 a.m.
Removed
lei_validate
Sept. 29, 2026, 3:03 a.m.
Removed
lei_lookup
Sept. 29, 2026, 3:03 a.m.
Removed
isin_validate
Sept. 29, 2026, 3:03 a.m.
Removed
isbn_validate
Sept. 29, 2026, 3:03 a.m.
Removed
id_mrz
Sept. 29, 2026, 3:03 a.m.
Removed
eu_vat_validate
Sept. 29, 2026, 3:03 a.m.
Removed
eu_vat_rates
Sept. 29, 2026, 3:03 a.m.
Removed
ean_gtin
Sept. 29, 2026, 3:03 a.m.
Removed
creditor_ref
Sept. 29, 2026, 3:03 a.m.
Removed
container_validate
Sept. 29, 2026, 3:03 a.m.
Removed
bic_validate
Sept. 29, 2026, 3:03 a.m.
Removed
ai_messages
Sept. 29, 2026, 3:03 a.m.
Changed
pbx_whisper_suggest
Sept. 23, 2026, 2:54 a.m.
Discover

Similar MCP servers

Lovie Company Formation

co.lovie/company-formation

Supports company formation and business administration with bank accounts, cards, invoicing, bookkeeping, accounting periods, and…

独行录 / opcmenu

io.github.yzlee/opcmenu

Supports founder and company discovery, collaboration goals and tasks, events and signups, networking, messaging, profiles, produ…

AgentLot Marketplace

io.agentlot/marketplace

Enables agents and users to discover, bid on, purchase, deliver, and settle paid digital services and compute work.

Odichat

io.github.odichat/mcp-odichat

Manages WhatsApp, Instagram, and Facebook inboxes with contacts, conversations, agents, automation rules, labels, canned response…

BeeL

es.beel/mcp

Provides Spanish company administration and VeriFactu-compliant invoicing, including customers, products, invoice issuance, corre…

corply

io.github.corply-dev/corply

Supports company formation and corporate administration including incorporation documents, signatures, cap tables, corporate acti…

Speedbot Autonomous Work Network

io.github.ulasarslan6262-ui/speedbot

Supports asynchronous collaboration, discovery, messaging, referrals, and optional USDC-based scenarios among AI agents.

KaiCalls

com.kaicalls/kaicalls

Provides AI phone reception, outbound calling campaigns, call transcripts and recordings, lead management, routing, staff alerts,…