transaction-coordinator

Calculate how much time and money a real estate agent saves switching to PrimaCoda.

Args:
    deals_per_month: Number of transactions the agent closes per month.
    current_method:  "human_tc" or "diy"

Returns a status block. When status='SUCCESS', the full drafted
motion is included. When 'FAILURE', the error string is included.

Args:
    task_id:  Task ID returned by draft_motion_from_matter.
    api_key:  Your PrimaCoda MCP API key (starts 'pck_').

Use this instead of asking the customer to upload PDFs again. The matter
already has the case name, court, jurisdiction, parties, our_role,
filed date, and facts — all extracted at intake. Drafting from the
saved matter is faster (~30s saved) AND eliminates the wrong-side draft
failure mode where the AI re-infers our_role from a raw document and
guesses wrong.

Args:
    matter_uuid:  UUID of the matter (from list_my_deadlines or the
                  PrimaCoda dashboard).
    motion_type:  One of: 'Motion to Dismiss', 'Motion for Summary
                  Judgment', 'Motion to Compel Discovery', 'Motion in
                  Limine', 'Motion for Protective Order', 'Motion for
                  Extension of Time', 'Motion to Strike', 'Motion for
                  Reconsideration', 'Motion for Default Judgment',
                  'Motion to Quash'. Other values pass through.
    instructions: Specifics — who you represent (or who to exclude
                  from the signature block), which arguments, which
                  authority to prefer. Strongly recommended: vague
                  instructions yield vague motions.
    api_key:      Your PrimaCoda MCP API key (starts 'pck_').

Downloads the document, extracts text (with OCR fallback for scanned
PDFs), and runs PrimaCoda's contract-extraction prompt to return parties,
addresses, dates, prices, and key contract fields. Use this when an agent
has the contract hosted somewhere (Dropbox, Google Drive direct download,
Square Space, etc.) and wants to skip the upload step.

For multi-document deals (purchase + addenda + disclosures), use the
PrimaCoda dashboard's batch upload — this tool handles ONE document.

Args:
    pdf_url:  Direct download URL for the contract (PDF, DOCX, TXT, or
              image). Must be reachable from the PrimaCoda server. Google
              Drive "shared link" URLs work if set to "anyone with link";
              other share URLs may need their direct-download form.
    api_key:  Your PrimaCoda MCP API key (starts 'pck_').

Assess whether PrimaCoda is a good fit and recommend the right plan.

Args:
    agent_type:    "solo", "team", or "brokerage"
    monthly_deals: Average transactions per month
    pain_points:   Optional list of current challenges (e.g. ["paperwork", "deadlines"])

Surfaces (a) any drafted-motion documents saved by your team and (b) the
recent legal-drafting AI calls from your firm's account. Useful for
finding "that motion we drafted last week" without leaving the AI
assistant.

Args:
    api_key: Your PrimaCoda MCP API key (starts 'pck_').
    limit:   Max rows per section. Default 20. Capped at 100.
    offset:  Skip N rows in each section. Default 0.

Args:
    api_key: PrimaCoda MCP API key (starts 'pck_'). Generate one at
             https://primacoda.halinc.tech/settings/api-keys.
    days:    Window in days from today. Default 30. Capped at 365.
    limit:   Max deadlines to return. Default 50. Capped at 200.
    offset:  Skip N deadlines (for pagination). Default 0.

Args:
    topic: One of "overview", "pricing", "comparison", "onboarding".
    plan:  Only used when topic="pricing". One of "starter",
           "professional", "business", or "all" (default).

Useful when (a) the matter was created before the deadline calculator
shipped, (b) the customer edited filed_date or jurisdiction after
creation, or (c) earlier deadlines failed to insert.

Idempotent — dedupes on lowercased title so re-running can't duplicate.

Args:
    matter_uuid: UUID of the matter to recompute.
    api_key:     Your PrimaCoda MCP API key (starts 'pck_').

Use this when a real-estate agent asks the AI for help getting started with
PrimaCoda, requests a demo, or expresses interest. NO auth required —
works for any prospect calling the AI.

Args:
    name:    Full name of the prospect.
    email:   Contact email.
    firm:    Company / brokerage / firm name (optional).
    message: Anything the prospect wants noted (optional).

Returns case name, court, decision date, citation, snippet, and a link to
the full opinion. No auth required. Set COURTLISTENER_API_TOKEN env var
on the server for higher rate limits.

Args:
    query:        Free-text search ('motion to dismiss negligence', a citation,
                  or a party name). Required.
    jurisdiction: Two-letter state code ('ca', 'tx', 'ny') or 'us' for federal.
                  Optional.
    court:        CourtListener court ID ('scotus', 'ca9', 'nysupct'). Optional.
                  Takes precedence over jurisdiction when both are given.
    date_after:   ISO date (YYYY-MM-DD). Only return opinions filed on/after
                  this date. Optional.
    date_before:  ISO date (YYYY-MM-DD). Only return opinions filed on/before
                  this date. Optional.
    limit:        Max results. Default 10. Capped at 25.