Prompts and worked examples

Choose a prompt for a specific examination task, and check the expected tool call and result.

These recipes help you direct an MCP-connected agent. They do not change the engine’s rules or open disabled sourcing gates. The arithmetic examples are synthetic and describe no real property.

Before you use a prompt

Complete Connect your agent.
Replace angle-bracket placeholders with exact returned values or operator-confirmed details.
Obtain permission for the case scope and model spend before a start_title_exam call.
For an existing job, supply its saved UUID. Reconnecting does not require a new job.

Connect and discover, without starting OCR

Use this prompt to check a new connection:

Use AI Title Examiner to discover its tools and call list_surveys.
Show each exact survey name, county, and abstract. Do not start an examination.

Expected result: list_surveys returns registered cases. No examination job or title-model call starts.

Try the arithmetic without running OCR

This synthetic chain grants the whole mineral interest to Example Owner, who then conveys half of the tract to Example Buyer.

Ask your agent to call compute_mineral_ownership with these arguments:

{
  "conveyances": [
    {
      "vol_pg": "1/1",
      "kind": "PATENT",
      "grantor": "State of Texas",
      "grantee": "Example Owner"
    },
    {
      "vol_pg": "2/2",
      "kind": "DEED",
      "grantor": "Example Owner",
      "grantee": "Example Buyer",
      "fraction": "1/2",
      "fraction_of": "TRACT"
    }
  ]
}

Check mineral_interests: both owners should hold 1/2. mineral_fee_sum should be 1, with no integrity flags and verified: true.

Call mineral_buying_summary with the same chain and 160 gross acres:

{
  "conveyances": [
    {
      "vol_pg": "1/1",
      "kind": "PATENT",
      "grantor": "State of Texas",
      "grantee": "Example Owner"
    },
    {
      "vol_pg": "2/2",
      "kind": "DEED",
      "grantor": "Example Owner",
      "grantee": "Example Buyer",
      "fraction": "1/2",
      "fraction_of": "TRACT"
    }
  ],
  "gross_acres": 160
}

Check acquirable: each owner should have 80 net mineral acres (NMA), for a total of 160. Ask the agent to explain verification_scope and closeable_scope alongside those numbers.

Both tools use deterministic arithmetic, with no OCR or title-model calls. verified describes consistency of the supplied chain. closeable describes the fold’s status. Neither establishes complete or legally verified title.

Add a royalty burden

Use a fresh synthetic chain. Example Owner conveys the whole mineral interest and reserves a one-eighth nonparticipating royalty interest (NPRI).

Call compute_mineral_ownership with:

{
  "conveyances": [
    {
      "vol_pg": "1/1",
      "kind": "PATENT",
      "grantor": "State of Texas",
      "grantee": "Example Owner"
    },
    {
      "vol_pg": "3/3",
      "kind": "DEED",
      "grantor": "Example Owner",
      "grantee": "Example Buyer",
      "reservations": [
        {"fraction": "1/8", "type": "NPRI", "of": "TRACT"}
      ]
    }
  ]
}

Expected result: Example Buyer holds the whole mineral fee. Example Owner’s 1/8 appears in npri_burdens, separately from mineral fee interests. The mineral fee sum remains 1.

Ask your agent to explain the separate ledgers using The title-examination model. A real reservation requires the instrument text and examiner review; this example only tests the structured arithmetic supplied here.

Start a prepared folder case

Use this only after agreeing the case and model spend with the operator:

Start one examination for <exact survey returned by list_surveys>.
Use provider fixture, driver bfs, max_docs 50, validate false,
allow_browser false, and allow_purchase false. Leave seed_ref empty to use
all prepared folder PDFs as starting documents, subject to limits.
Save the job_id. If this job takes time or I reconnect, check that ID.

Expected result: start_title_exam returns one queued job and its UUID. Fixture sourcing avoids courthouse purchases, but models still consume credits. A document limit is not a total-dollar cap. Follow Your first examination to poll and review it.

Trace from one instrument

Confirm the server’s seed filename and spend with the operator before using:

Start one fixture examination for <exact registered survey> with driver bfs,
seed_ref <operator-confirmed PDF filename>, and max_docs 50.
Keep allow_browser false, allow_purchase false, and validate false.
Save its job_id. Explain that this traces backward from one instrument,
rather than using every folder PDF as an initial seed.

Expected result: one job starts from the specified seed. A fixture seed_ref is a filename such as the synthetic 0001_0001.pdf, not a laptop path. Confirm the actual server filename instead of copying this example.

Reconnect to a running job

My existing job ID is <saved UUID>. Call get_title_exam_status for it.
Report its exact state and the available coverage and analysis fields.
If queued or running, check again in 30-60 seconds. Do not infer a percentage,
phase, or spend from docs_read. Do not start another examination.

Expected result: status for the existing job, with no new start_title_exam call. Use Troubleshooting if the ID cannot be read.

Review partial results

For job <saved UUID>, call get_title_exam_results with artifact summary first.
If reports_ready is true, retrieve lrs, lor, buying, and review_sheet.
List unresolved citations, uncertain ownership, and curative actions with
source references. Separate sourcing gaps from analysis or QA failure.
Keep incomplete labels and identify truncated responses.

Expected result: a review package that preserves the returned coverage and analysis status. ROOT_OF_RECORD, verified, and closeable do not provide independent legal approval. Interpret each signal with Read and review the results.

Explain the buying result

Read buying for job <saved UUID>, after checking the summary and reports_ready.
Identify whether ownership comes from a deterministic fold, an incomplete
fold, or an LLM estimate. Show mineral fee interests separately from NPRI
burdens and life estates. Flag unknown acreage, overlapping totals, and
disputed interests. Preserve null NMA values and estimate labels.

Expected result: proposed interests and acreage retain their provenance and warnings. The deterministic tool returns null NMA for inconsistent input or nonpositive gross acreage. A pipeline report may instead contain an LLM estimate. See Accuracy and known limits before using either for a buying decision.

Review OCR grounding

Read faithfulness for job <saved UUID>, after checking reports_ready.
Explain OCR coverage and abstentions before quoting a grounding rate.
List ungrounded values and source document references for human review.
Separate OCR grounding from the accuracy of the scan transcription and
from title completeness.

Expected result: an evidence review that includes the report’s scope, rather than treating a grounding rate as an overall accuracy score.

Record feedback

Draft private feedback for job <saved UUID>. For each issue include the
artifact, row or Vol/Pg, reported value, corrected value, scan evidence,
and impact on the chain or ownership. Group missing sources separately
from wrong extracted fields. State that this draft has not saved corrections
to the examiner or sent feedback to anyone.

Expected result: a private draft you can review and send to the operator. The MCP service has no correction-saving or upload tool. Use Pilot testing and feedback for the feedback format.

Sourcing outside the folder

Before using a web provider, agree retrieval scope and costs with the operator. Every web provider requires positive budget and cost_per_doc. Browser work requires both a host setting and request opt-in; paid retrieval has separate host and request gates.

The budget tracks estimated acquisition cost. It excludes some model, browser, search, and provider charges, and can cross its threshold by one document estimate. Use Documents, citations, and sourcing for the workflow and MCP tool reference for exact arguments. A prompt cannot enable a disabled host gate or guarantee a total-dollar cap.

Keyboard shortcuts

AI Title Examiner