Toofi Dental Planning MCP
Agent-native dental planning MCP for plan drafts, presentations, and price estimates.
我該用這個嗎
品質與安全性
發現項目(9)
- LOW在 discover_capabilities 中
- LOW在 example_en 中
- LOW在 example_ru 中
- LOW在 example_uk 中
- LOW在 example_ua 中
- LOW在 example_pl 中
- LOW在 example_sk 中
- LOW在 generate_dental_treatment_plan_pdf 中
- LOW在 get_dental_plan_operation_status 中
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高,可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案:
{
"mcpServers": {
"dental-planning": {
"url": "https://toofi.app/mcp"
}
}
}遠端端點
https://toofi.app/mcpstreamable-http它能做什麼
工具清單
工具(32)
🟡generate_dental_treatment_plan_pdf(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Start the real Toofi headless treatment-plan pipeline from structured clinical findings: create a service-user runtime plan, invoke AI plan generation, and return an operation id for polling toward a patient-facing PDF output.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"runtime_session_token": {
"type": "string",
"description": "Toofi runtime actor token for service-user scoped execution. May also be supplied as x-toofi-session-token header."
},
"session_token": {
"type": "string",
"description": "Alias for runtime_session_token."
},
"agent_key": {
"type": "string",
"description": "Toofi agent API key. May also be supplied as X-Toofi-Agent-Key header."
},
"toofi_agent_key": {
"type": "string",
"description": "Alias for agent_key."
},
"patient": {
"type": "object",
"properties": {
"external_id": {
"type": "string",
"description": "Agent-side patient reference. Avoid PHI unless your mandate permits it."
},
"display_name": {
"type": "string",
"description": "Display name for generated artifacts."
},
"language": {
"type": "string",
"description": "Preferred output language."
}
},
"additionalProperties": true
},
"clinical_input": {
"type": "object",
"properties": {
"teeth": {
"type": "array",
"items": {
"type": "object",
"properties": {
"position": {
"type": "string",
"description": "FDI tooth id, e.g. 36 or tooth-36."
},
"state": {
"type": "string",
"description": "Tooth state such as missing, caries, healthy, crown."
},
"root": {
"type": "string",
"description": "Root state/type."
},
"implant": {
"type": "string",
"description": "Implant state/type."
},
"implant_planned": {
"type": "boolean"
},
"supra": {
"type": "string",
"description": "Suprastructure state/type."
},
"gum": {
"type": "string",
"description": "Gum state/type."
},
"mobility": {
"type": "string",
"description": "Mobility state/type."
},
"periapical": {
"type": "string",
"description": "Periapical state/type."
},
"problem": {
"type": "string",
"description": "Problem marker."
}
},
"additionalProperties": true
}
},
"objectives": {
"type": "array",
"items": {
"type": "string"
}
},
"constraints": {
"type": "object",
"additionalProperties": true
}
},
"additionalProperties": true
},
"presentation": {
"type": "object",
"properties": {
"language": {
"type": "string",
"description": "Presentation language."
},
"include_pdf": {
"type": "boolean",
"default": true
},
"include_ai_narrative": {
"type": "boolean",
"default": true,
"description": "Pass-through flag for the existing Toofi AI narrative pipeline. Defaults to true in the headless wrapper."
},
"build_options": {
"type": "object",
"properties": {
"priceAdjustmentPercent": {
"type": "number",
"description": "Existing Toofi presentation build option passed through to the runtime presentation pipeline."
},
"showDiscount": {
"type": "boolean",
"description": "Existing Toofi presentation build option passed through to the runtime presentation pipeline."
},
"installment": {
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"properties": {
"months": {
"type": "integer",
"minimum": 1
},
"paymentFrequency": {
"type": "string",
"enum": [
"biweekly",
"monthly",
"quarterly"
]
},
"commissionPercent": {
"type": "number"
},
"downPaymentPercent": {
"type": "number"
}
},
"additionalProperties": true
}
]
}
},
"additionalProperties": true
},
"pdf_options": {
"type": "object",
"description": "Pass-through PDF options for the existing Toofi PDF renderer.",
"additionalProperties": true
}
},
"additionalProperties": true
},
"ai_preset": {
"type": "object",
"properties": {
"preset": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"provider": {
"type": "string",
"description": "Optional provider hint."
}
},
"additionalProperties": true
}
},
"required": [
"clinical_input"
],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢get_dental_plan_operation_status(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Poll a Toofi headless treatment-plan operation until AI planning is completed and ready for presentation/PDF delivery.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"runtime_session_token": {
"type": "string",
"description": "Toofi runtime actor token for service-user scoped execution. May also be supplied as x-toofi-session-token header."
},
"session_token": {
"type": "string",
"description": "Alias for runtime_session_token."
},
"agent_key": {
"type": "string",
"description": "Toofi agent API key. May also be supplied as X-Toofi-Agent-Key header."
},
"toofi_agent_key": {
"type": "string",
"description": "Alias for agent_key."
},
"plan_id": {
"type": "string",
"description": "Toofi plan id returned by generate_dental_treatment_plan_pdf."
},
"operation_id": {
"type": "string",
"description": "Operation id returned by generate_dental_treatment_plan_pdf."
},
"patient_id": {
"type": "string",
"description": "Patient id returned by generate_dental_treatment_plan_pdf."
},
"include_pdf": {
"type": "boolean",
"default": true,
"description": "When true, completed operations return a signed presentation PDF URL."
},
"presentation": {
"type": "object",
"properties": {
"language": {
"type": "string",
"description": "Presentation language."
},
"include_pdf": {
"type": "boolean",
"default": true
},
"include_ai_narrative": {
"type": "boolean",
"default": true,
"description": "Pass-through flag for the existing Toofi AI narrative pipeline. Defaults to true in the headless wrapper."
},
"build_options": {
"type": "object",
"properties": {
"priceAdjustmentPercent": {
"type": "number",
"description": "Existing Toofi presentation build option passed through to the runtime presentation pipeline."
},
"showDiscount": {
"type": "boolean",
"description": "Existing Toofi presentation build option passed through to the runtime presentation pipeline."
},
"installment": {
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"properties": {
"months": {
"type": "integer",
"minimum": 1
},
"paymentFrequency": {
"type": "string",
"enum": [
"biweekly",
"monthly",
"quarterly"
]
},
"commissionPercent": {
"type": "number"
},
"downPaymentPercent": {
"type": "number"
}
},
"additionalProperties": true
}
]
}
},
"additionalProperties": true
},
"pdf_options": {
"type": "object",
"description": "Pass-through PDF options for the existing Toofi PDF renderer.",
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"required": [
"plan_id",
"operation_id"
],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢discover_capabilities(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Discover Toofi agent-native dental planning capabilities, links, safety boundary, and billing rails.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢lookup_dental_procedures(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Map a natural-language dental procedure query to structured Toofi procedure catalog entries and pricing anchors. No PHI.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"query": {
"type": "string",
"description": "Natural-language dental procedure query, for example \"implant and crown for lower molar\"."
},
"q": {
"type": "string",
"description": "Alias for query."
},
"text": {
"type": "string",
"description": "Alias for query."
},
"language": {
"type": "string",
"description": "Preferred language hint."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"description": "Maximum number of procedure matches."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢preview_plan_draft_schema(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Preview the structured Toofi treatment-plan draft response schema for agent-native clinical workflows.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"procedures": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}⚪generate_treatment_plan_draft(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Generate a structured no-memory Toofi treatment-plan draft with visits, estimate, presentation outline, billing metadata, audit receipt shape, and dentist approval boundary.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"query": {
"type": "string",
"description": "Natural-language clinical request for a treatment-plan draft."
},
"clinical_request": {
"type": "string",
"description": "Structured or natural-language clinical request."
},
"chief_complaint": {
"type": "string",
"description": "Patient chief complaint, no PHI required in public demo mode."
},
"patient_ref": {
"type": "string",
"description": "Agent-scoped patient reference."
},
"patient": {
"type": "object",
"properties": {
"patient_ref": {
"type": "string"
},
"display_name": {
"type": "string"
},
"age_band": {
"type": "string"
}
},
"additionalProperties": true
},
"clinical_findings": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"procedures": {
"type": "array",
"items": {
"type": "object",
"properties": {
"procedure_id": {
"type": "string"
},
"label": {
"type": "string"
},
"tooth": {
"type": "string"
},
"quantity": {
"type": "integer",
"minimum": 1
},
"notes": {
"type": "string"
}
},
"additionalProperties": true
}
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢list_demo_patients(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
List public no-PHI Toofi demo patients so agents can inspect patient response structure.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢get_demo_patient(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Get one public no-PHI Toofi demo patient.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"patient_id": {
"type": "string",
"description": "Toofi demo patient_id. Defaults to the primary demo record."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢list_demo_plans(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
List public no-PHI Toofi demo treatment plans.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢get_demo_plan(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Get one public no-PHI Toofi demo treatment plan with estimate and dentist approval boundary.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"plan_id": {
"type": "string",
"description": "Toofi demo plan_id. Defaults to the primary demo record."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢get_demo_presentation(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Get one public no-PHI Toofi demo patient presentation shape with provenance surface fields.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"plan_id": {
"type": "string",
"description": "Toofi demo plan_id. Defaults to the primary demo record."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢get_example_result(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Return a stable public PDF artifact that shows what Toofi produces: a patient-facing treatment-plan presentation for an example case where tooth 11 and root 11 are missing. No generation is run at call time.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"language": {
"type": "string",
"enum": [
"en",
"pl",
"ru",
"sk",
"uk",
"ua"
],
"description": "Example PDF language: en, pl, ru, sk, uk, or ua."
},
"locale": {
"type": "string",
"description": "Alias for language."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢example_en(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Return the cached English Toofi example PDF artifact. Same as example-en for human docs; MCP-safe tool name uses underscore.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢example_ru(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Return the cached Russian Toofi example PDF artifact. Same as example-ru for human docs; MCP-safe tool name uses underscore.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢example_uk(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Return the cached Ukrainian Toofi example PDF artifact.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢example_ua(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Return the cached Ukrainian Toofi example PDF artifact using the ua alias requested by agent integrators.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢example_pl(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Return the cached Polish Toofi example PDF artifact.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢example_sk(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Return the cached Slovak Toofi example PDF artifact.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}⚪generate_patient_presentation(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Generate a patient-facing Toofi presentation from a treatment plan with signed audit and C2PA-provenanced output surface.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"patient_ref": {
"type": "string",
"description": "Patient reference for patient presentation generation."
},
"plan_ref": {
"type": "string",
"description": "Plan reference for patient presentation generation."
},
"plan_id": {
"type": "string",
"description": "Plan id for patient presentation generation."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}⚪generate_price_estimate(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Generate a Toofi price estimate from treatment-plan and clinic pricing inputs.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"patient_ref": {
"type": "string",
"description": "Patient reference for price estimate generation."
},
"plan_ref": {
"type": "string",
"description": "Plan reference for price estimate generation."
},
"plan_id": {
"type": "string",
"description": "Plan id for price estimate generation."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}⚪start_pano_markup(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Start Toofi panoramic X-ray markup workflow under agent-native clinical planning rails.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"patient_ref": {
"type": "string",
"description": "Patient reference for panoramic X-ray markup."
},
"plan_ref": {
"type": "string",
"description": "Plan reference for panoramic X-ray markup."
},
"plan_id": {
"type": "string",
"description": "Plan id for panoramic X-ray markup."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}⚪import_price_csv(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Import and map a clinic price CSV into Toofi pricing configuration.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"csv_text": {
"type": "string",
"description": "CSV text payload."
},
"file_url": {
"type": "string",
"description": "URL to a CSV file."
},
"dry_run": {
"type": "boolean",
"default": true
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢get_agent_credit_balance(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Get Toofi internal credit balance for an agent or clinic mandate.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"runtime_session_token": {
"type": "string",
"description": "Toofi runtime actor token for service-user scoped execution. May also be supplied as x-toofi-session-token header."
},
"session_token": {
"type": "string",
"description": "Alias for runtime_session_token."
},
"agent_key": {
"type": "string",
"description": "Toofi agent API key. May also be supplied as X-Toofi-Agent-Key header."
},
"toofi_agent_key": {
"type": "string",
"description": "Alias for agent_key."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢list_audit_receipts(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
List signed Toofi agent invocation receipts and provenance records.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"patient_ref": {
"type": "string",
"description": "Patient reference for audit receipt listing."
},
"plan_ref": {
"type": "string",
"description": "Plan reference for audit receipt listing."
},
"plan_id": {
"type": "string",
"description": "Plan id for audit receipt listing."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢list_patients(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
List clinic patients through Toofi agent-native mandate rails.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"patient_ref": {
"type": "string",
"description": "Patient reference for patient listing."
},
"plan_ref": {
"type": "string",
"description": "Plan reference for patient listing."
},
"plan_id": {
"type": "string",
"description": "Plan id for patient listing."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢get_patient(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Get one clinic patient through Toofi agent-native mandate rails.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"patient_ref": {
"type": "string",
"description": "Patient reference for patient retrieval."
},
"plan_ref": {
"type": "string",
"description": "Plan reference for patient retrieval."
},
"plan_id": {
"type": "string",
"description": "Plan id for patient retrieval."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢list_plans(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
List Toofi treatment plans through agent-native mandate rails.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"patient_ref": {
"type": "string",
"description": "Patient reference for plan listing."
},
"plan_ref": {
"type": "string",
"description": "Plan reference for plan listing."
},
"plan_id": {
"type": "string",
"description": "Plan id for plan listing."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢get_plan(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Get one Toofi treatment plan through agent-native mandate rails.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"patient_ref": {
"type": "string",
"description": "Patient reference for plan retrieval."
},
"plan_ref": {
"type": "string",
"description": "Plan reference for plan retrieval."
},
"plan_id": {
"type": "string",
"description": "Plan id for plan retrieval."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢get_status(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Get Toofi agent workflow status.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"patient_ref": {
"type": "string",
"description": "Patient reference for workflow status."
},
"plan_ref": {
"type": "string",
"description": "Plan reference for workflow status."
},
"plan_id": {
"type": "string",
"description": "Plan id for workflow status."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢get_agent_billing_quote(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Get a deterministic Toofi internal-credit quote for an agent tool call, including TTL, payment rails, Stripe checkout command, and x402-ready contract fields.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"tool_name": {
"type": "string",
"description": "MCP tool or Toofi command being priced."
},
"units": {
"type": "integer",
"minimum": 1,
"default": 1
},
"currency": {
"type": "string",
"default": "TOOFI_CREDIT"
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢create_agent_checkout_session(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
Create a real Stripe Checkout session for buying Toofi internal credits. Returns a claim token so the agent can retrieve its key after payment.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"owner_email": {
"type": "string",
"description": "Email used for receipt and backup delivery after Stripe payment."
},
"email": {
"type": "string",
"description": "Alias for owner_email."
},
"product_id": {
"type": "string",
"description": "Optional Toofi credit-pack product id. Defaults to the public agent credit pack."
},
"quote_id": {
"type": "string",
"description": "Quote id from get_agent_billing_quote."
},
"tool_name": {
"type": "string",
"description": "Tool name if quote_id is not supplied."
},
"units": {
"type": "integer",
"minimum": 1,
"default": 1
},
"return_url": {
"type": "string",
"description": "Agent/client return URL after checkout."
}
},
"required": [],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}🟢claim_agent_checkout_key(request_id, intent_id, mandate_id, agent_id, principal_id, ...)
After Stripe Checkout is paid, exchange the purchase id and one-time claim token for the Toofi agent API key used as X-Toofi-Agent-Key or agent_key.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"description": "Idempotency and correlation id echoed in Toofi responses."
},
"intent_id": {
"type": "string",
"description": "Root agent intent id."
},
"mandate_id": {
"type": "string",
"description": "Clinic or agent mandate id. Optional in public demo mode."
},
"agent_id": {
"type": "string",
"description": "Calling agent identifier."
},
"principal_id": {
"type": "string",
"description": "Human or clinic principal on whose behalf the agent acts."
},
"clinic_id": {
"type": "string",
"description": "Clinic identifier for mandate-scoped production execution."
},
"purchase_id": {
"type": "string",
"description": "Purchase id returned by create_agent_checkout_session."
},
"claim_token": {
"type": "string",
"description": "One-time claim token returned by create_agent_checkout_session."
}
},
"required": [
"purchase_id",
"claim_token"
],
"additionalProperties": true
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"endpoint": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"additionalProperties": true
}建議的提示詞
list_demo_patientsget_dental_plan_operation_statusget_dental_plan_operation_statuslist_demo_patientslist_demo_patientsget_dental_plan_operation_status社群
證據