Solutions And Use Cases

Esheria is useful when a product needs regulatory data that can become a workflow: obligations, applicability results, filing-calendar items, evidence requirements, forms, citations, relationship context, and claim verification. Use this page to choose the right API, CLI, or MCP path for a legal, compliance, or technical workflow.

Esheria returns source-backed regulatory workflow data, not legal advice. Keep legal review in the loop for client-facing advice.

What Works Today

Job to be done	API endpoint	CLI	MCP
Discover published packs	`GET /api/v1/domain-packs`	`esheria packs list`	`esheria_list_packs`
Inspect readiness and limits	`GET /api/v1/domain-packs/{pack_id}`	`esheria packs inspect`	`esheria_get_pack`
Build an obligation register	`GET /api/v1/domain-packs/{pack_id}/obligations`	`esheria obligations list`	`esheria_list_obligations`
Match duties to an entity profile	`POST /api/v1/domain-packs/{pack_id}/applicability-check`	`esheria applicability check`	`esheria_check_applicability`
Build a filing calendar	`GET /api/v1/domain-packs/{pack_id}/filing-calendar`	`esheria calendar list`	`esheria_get_filing_calendar`
Build an evidence register	`GET /api/v1/domain-packs/{pack_id}/evidence-register`	`esheria evidence list`	`esheria_get_evidence_register`
Verify a generated answer	`POST /api/v1/legal-status/verify-claim`	`esheria claims verify`	`esheria_verify_claim`
Query relationship context	`POST /api/v1/regulatory-graph/query`	`esheria graph query`	`esheria_query_regulatory_graph`
Export a pack	`GET /api/v1/domain-packs/{pack_id}/export`	`esheria packs export`	`esheria_export_pack`

Fastest Useful Flow

List packs.
Inspect the pack readiness label and limitations.
Run applicability for the user’s entity profile.
Pull obligations, calendar items, and evidence requirements.
Verify any generated answer before displaying it.
Store citation IDs, quote spans, and trace_id with the downstream workflow.

curl

curl --compressed -sS -X POST \
  "$ESHERIA_API_BASE_URL/api/v1/domain-packs/KE-DATA-PROTECTION/applicability-check" \
  -H "content-type: application/json" \
  -H "x-api-key: $ESHERIA_API_KEY" \
  -H "idempotency-key: $(python3 -c 'import uuid; print(uuid.uuid4())')" \
  -d '{
    "entity_roles": ["data_controller"],
    "activities": ["personal_data_processing"],
    "sector_tags": ["financial_services"],
    "limit": 5
  }' | jq

CLI

esheria applicability check KE-DATA-PROTECTION \
  --role data_controller \
  --activity personal_data_processing \
  --sector financial_services \
  --format json

MCP

{
  "tool": "esheria_check_applicability",
  "arguments": {
    "pack_id": "KE-DATA-PROTECTION",
    "entity_roles": ["data_controller"],
    "activities": ["personal_data_processing"],
    "sector_tags": ["financial_services"],
    "limit": 5
  }
}

Expected output includes applicable obligations, match reasons, citations, quote spans, readiness labels, limitations, and trace_id.

Vertical Plays

Law firms

Use obligations, provisions through pack export, citations, and claim verification to prepare research-backed client notes and review generated legal answers before associates rely on them.

Fintech and digital lending

Build data protection obligation registers, regulator-facing task lists, evidence checklists, and answer verification for product and compliance teams.

Corporate secretarial

Use corporate registry packs, filing-calendar items, forms, provisions, and relationship context to build entity-maintenance checklists.

GRC and internal audit

Convert obligations into controls, evidence requirements, audit tasks, and traceable source-backed registers.

HR, payroll, and employment

Use employment and payroll packs as they are published to build workplace obligations, filing dates, and evidence checklists.

Tax and finance operations

Use tax and VAT packs as they are published to create filing calendars, recordkeeping checklists, and entity-profile workflows.

Financial crime and AML

Use AML/CFT packs as they are published to map obligations to controls, evidence, customer-risk workflows, and reporting calendars.

AI and legal-tech builders

Use claim verification, citation context, and MCP tools to keep generated answers grounded in published regulatory facts.

Example Plays

Fintech Privacy Register

Business question:

We are a Kenyan fintech acting as a data controller and processing personal data. What obligations should product, legal, and compliance review first?

Call applicability, then turn returned obligations into tasks.

CLI

esheria applicability check KE-DATA-PROTECTION \
  --role data_controller \
  --activity personal_data_processing \
  --sector financial_services \
  --format json

Then fetch the evidence register:

CLI

esheria evidence list KE-DATA-PROTECTION --format json

Corporate Registry Checklist

Business question:

Which corporate registry duties, forms, and filings should a company secretary monitor?

Start with the BRS pack and calendar-facing workflow:

CLI

esheria packs inspect KE-CORPORATE-REGISTRY-BRS
esheria calendar list KE-CORPORATE-REGISTRY-BRS --format json
esheria packs export KE-CORPORATE-REGISTRY-BRS --include-all-forms --out brs-pack.json

AI Answer Guardrail

Business question:

Can we show this generated regulatory answer to a user?

Verify the claim before display:

CLI

esheria claims verify \
  --pack KE-DATA-PROTECTION \
  "A data controller must publish DPO contact details." \
  --format json

If the response returns unsupported_capability, not_found, or supported_with_corrections, show the limitations and corrections instead of presenting the answer as settled.

Best Next Endpoint Additions

These additions would expose data already present in Esheria packs and make integrations more useful.

Priority	Endpoint or tool	Why it matters
P0	`GET /api/v1/domain-packs/{pack_id}/citations/{citation_id}`	Retrieve quote/source context without exporting the full pack
P0	`POST /api/v1/domain-packs/{pack_id}/citations:batch-get`	Resolve all citations from an obligation register or answer verification run
P0	`GET /api/v1/domain-packs/{pack_id}/obligations/{obligation_id}`	Fetch one obligation for task, audit, or UI drill-down views
P0	`GET /api/v1/domain-packs/{pack_id}/provisions/{provision_id}`	Let legal users inspect the underlying source provision
P0	`GET /api/v1/domain-packs/{pack_id}/forms/{form_id}`	Let registry and compliance workflows inspect regulator forms directly
P1	`GET /api/v1/domain-packs/{pack_id}/search`	Search across obligations, provisions, citations, forms, and relationships
P1	`GET /api/v1/domain-packs/{pack_id}/facets`	Power UI filters and CLI autocomplete with duty holders, workflow targets, evidence types, instruments, and forms
P1	`POST /api/v1/workflows/obligation-register`	Return a complete profile-specific obligation register in one call
P1	`POST /api/v1/workflows/evidence-dossier`	Return obligations, evidence, forms, and citation context for audit workflows
P2	`POST /api/v1/legal-status/verify-claims`	Batch claim verification for AI and legal-tech products
P2	Calendar, CSV, Markdown exports	Create files legal teams can use directly

CLI And MCP Additions

Recommended CLI commands:

esheria search KE-DATA-PROTECTION "data protection officer"
esheria obligations get KE-DATA-PROTECTION --id <obligation-id>
esheria citations resolve KE-DATA-PROTECTION --in citation_ids.txt
esheria provisions get KE-DATA-PROTECTION --id <provision-id>
esheria forms list KE-CORPORATE-REGISTRY-BRS
esheria workflow obligation-register --profile-file fintech.json --out obligations.csv
esheria workflow evidence-dossier --profile-file fintech.json --out evidence.md
esheria claims verify-batch --pack KE-DATA-PROTECTION --in claims.jsonl

Recommended MCP tools:

esheria_search_facts
esheria_get_obligation
esheria_resolve_citations
esheria_list_forms
esheria_get_form
esheria_build_obligation_register
esheria_build_evidence_dossier
esheria_build_filing_calendar
esheria_verify_answer
esheria_list_use_cases

The public MCP server should remain read-only and should always return citations, limitations, and trace_id.

Documentation Index

​What Works Today

​Fastest Useful Flow

​Vertical Plays

Law firms

Fintech and digital lending

Corporate secretarial

GRC and internal audit

HR, payroll, and employment

Tax and finance operations

Financial crime and AML

AI and legal-tech builders

​Example Plays

​Fintech Privacy Register

​Corporate Registry Checklist

​AI Answer Guardrail

​Best Next Endpoint Additions

​CLI And MCP Additions

What Works Today

Fastest Useful Flow

Vertical Plays

Example Plays

Fintech Privacy Register

Corporate Registry Checklist

AI Answer Guardrail

Best Next Endpoint Additions

CLI And MCP Additions