Get Stats
Get an overview of the Velvoite regulatory corpus.
Returns document counts by source, regulation family, entity type,
urgency distribution, obligation summary, and date range.
Call this FIRST to orient yourself before running queries.
No parameters needed.
Search Regulations
Search the regulatory corpus using keyword / trigram matching.
Uses PostgreSQL trigram similarity on document titles and summaries.
Returns documents ranked by relevance with summaries and classification tags.
Prefer list_documents with filters (regulation, entity_type, source) first.
Only use this for free-text keyword search when structured filters aren't sufficient.
Args:
query: Search terms (e.g. 'strong customer authentication', 'ICT risk', 'AML reporting').
List Documents
Browse regulatory documents with filters and pagination.
Returns a paginated list of documents with summaries, tags, doc_purpose
(regulation_text, enforcement, reference, irrelevant), and doc_jurisdictions
(e.g. ['eu'], ['fi'], ['de']).
Use this for filtered browsing (e.g. all DORA documents from the last 30 days).
Use search_regulations instead when you have specific keywords to search for.
Args:
source: Filter by data source code: eur_lex, eba, esma, eiopa, fi
Get Document
Get full details of a specific regulatory document by its ID.
Returns the document metadata, AI summary, all classification tags,
inline obligations (up to 50 with total count), and a link to the original source.
Use the URL to access the full text on the official regulatory website (EUR-Lex, EBA, ESMA, FIN-FSA).
Get the document_id from search_regulations or list_documents results.
Args:
document_id: The Velvoite document ID (integer from search/list results).
Get Obligations
Get regulatory obligations - specific requirements extracted from regulations.
Each obligation includes the requirement text, applicable article reference,
deadline, which entity types it applies to, actor roles, and current status.
Results are paginated (max 50 per page).
Supports keyword search via the query parameter (trigram + ILIKE matching on obligation text).
Combine with regulation, entity_type, and actor_role filters for precise results.
Set canonical=True to
Get Canonical Obligations
Get deduplicated canonical obligations with enforcement intelligence.
Returns one obligation per unique legal requirement per actor role.
Each includes compliance difficulty, guidance, and enforcement metrics.
Use this instead of get_obligations when you want a clean, deduplicated
view of what a regulated entity must comply with, enriched with
enforcement risk data.
Args:
regulation: Filter by regulation code (e.g. 'dora', 'mica', 'aml').
actor_role: Co
Get Enforcement Intelligence
Get top enforced canonical obligations. Returns obligations ranked by
enforcement activity for risk prioritization.
This is a focused view of canonical obligations filtered to only those
with at least one enforcement action. Use this to identify which
obligations regulators are actively enforcing.
Args:
regulation: Filter by regulation code (e.g. 'dora', 'mica', 'aml').
actor_role: Comma-separated actor roles (e.g. 'credit_institution,significant_institution
Get Deadlines
Get upcoming regulatory deadlines for compliance calendar tracking.
Returns obligations with deadlines in chronological order, annotated
with days remaining or days overdue. Essential for compliance planning.
Args:
entity_type: Filter by entity type code (e.g. 'credit_institution').
regulation: Filter by regulation code (e.g. 'dora').
days_ahead: How many days ahead to look (default 90, max 730).
include_overdue: Include past-due obligations (default
Get Obligation Summary
Get obligation counts grouped by regulation_code.
Returns total count and per-regulation breakdown with status counts
(active, upcoming, overdue, expired) plus verified and with_deadline counts.
No full obligation text — just counts for a quick overview.
Args:
entity_type: Filter to obligations applying to this entity type (e.g. 'credit_institution', 'payment_institution').
actor_role: Comma-separated actor roles to filter by (e.g. 'financial_entity,credit_insti
Get Recent Changes
Get recently published or updated regulatory documents.
Shortcut for 'what is new this week' - returns documents from the last N days,
sorted by publication date (newest first). Useful for weekly regulatory briefings.
Args:
days: Look back N days (default 7).
entity_type: Filter by entity type code.
regulation: Filter by regulation family code.
urgency_max: Only include items at or above this urgency (1=critical, 2=high, etc.).
Get Verification Stats
Get verification progress for obligations across all regulations.
Returns total, verified, unverified counts overall and per regulation,
with percentage verified. Use this to track human review progress.
No parameters needed.
Get Actor Roles
Get available actor roles per regulation with obligation counts.
Actor roles define WHO an obligation applies to within a specific regulation
(e.g. 'credit_institution', 'significant_institution' for CRD/CRR, or
'ai_provider', 'high_risk_deployer' for AI Act).
Use this to discover which roles exist before filtering obligations with
get_obligations(actor_role=...).
Returns roles grouped by regulation, sorted by obligation count.
Each role includes a human-readable l
Get Company Profile
Get the calling company's regulatory posture — saved entity types,
actor roles per regulation, and active conditions.
The profile defines WHICH regulations and roles apply to this company.
Use the actor_roles to filter obligations with get_obligations(actor_role=...).
The profile is the baseline — you can extend beyond it using get_actor_roles()
to discover additional roles if your analysis suggests they may be relevant.
If the profile is empty (profile_complete=false)
Get Enforcement Decisions
Get enforcement decisions with structured penalty data.
Returns enforcement actions (fines, warnings, license withdrawals) imposed
by regulators. Each action includes penalty amount, sanctioned entity,
violation categories, and appeal status.
Use this to answer questions like:
- "What fines has FIN-FSA given to credit institutions?"
- "What are the largest penalties for AML violations?"
- "Has anyone been fined for ICT risk management failures?"
- "What's the to
Audit Taxonomy
Audit the actor role taxonomy: compare model-defined roles vs deployed roles in the database.
Returns per-regulation analysis showing:
- model_only: roles the enrichment model can produce but aren't in the DB yet (gap)
- deployed_only: roles in the DB but not in the model (unexpected — data quality issue)
- role_counts: each deployed role with obligation count
- known_issues: overlaps, naming issues, investigation items
Use this for QA validation of the actor role taxon
Get Feedback
Get user feedback for QA review. Requires admin API key.
Filters: status (new/reviewed/resolved/dismissed), feedback_type (data_quality/bug/feature_request/other),
context_type (document/obligation/general).
Get Finnish Statute
Return the canonical Finlex URL for a Finnish statute so Claude can fetch its text.
Finlex (finlex.fi) is the official Finnish statute database — no public JSON API exists,
but the URL can be fetched with WebFetch to retrieve the statute text.
Accepts a short law code (e.g. 'TSL', 'OYL', 'SRL', 'LLL') OR a direct year/number
reference (e.g. '2012/747', '2014/610') for statutes not in the known-code list.
Use search_finnish_statutes to find the year/number for an unknown stat
Search Finnish Statutes
Return Finlex search URL for Finnish statute keyword search.
Finlex has no public JSON search API — returns the search URL for Claude to fetch.
Args:
query: Search terms in Finnish or English (e.g. 'kilpailukielto', 'non-compete').
Get Finnish Company
Look up a Finnish company in the PRH Trade Register by business ID (Y-tunnus).
Returns company name, status, registered address, company form, registration date.
Args:
business_id: Finnish business ID / Y-tunnus in format '1234567-8'.
Search Finnish Companies
Search Finnish companies by name in the PRH Trade Register.
Use to find a business ID when you only know the company name,
or to check whether a company name is already taken.
Args:
name: Company name or partial name to search.
city: Optional municipality to narrow results (e.g. 'Helsinki', 'Tampere').
Get Eu Regulation Article
Return verbatim obligation text from the Velvoite corpus for an EU regulation
article, plus the canonical EUR-Lex URL for reference.
Queries the Velvoite corpus directly — no web fetching required.
EUR-Lex blocks direct web fetch; the corpus has the authoritative text.
Requires Velvoite Premium API key.
Supported regulation codes: gdpr, dora, mica, ai_act, mifid2, mifir,
crr, crr3, crd6, aml6, amld4, psd2, sfdr, csrd, emir, idd, solvency2,
eprivacy, bmr, priips.
Search Eu Regulation Text
Return EUR-Lex search URL for finding regulation provisions by keyword.
Use when you don't know the exact article number but need to find
relevant provisions. Requires Velvoite Premium API key.
Args:
query: Search terms (e.g. 'data processing agreement processor obligations').
regulation: Optional regulation code to scope the search (e.g. 'gdpr').
Search Cjeu Cases
Search CJEU case law via EUR-Lex CELLAR SPARQL (live — not limited to Velvoite corpus).
Returns cases matching keywords in the case title.
Use to find court decisions on a specific regulation, topic, or legal concept.
Fetch the returned url to read the full judgment text.
Requires Velvoite Premium API key.
Args:
query: Keywords to search in case titles (e.g. 'money laundering', 'crypto-assets',
'payment institution authorisation'). Phrase search — keep
Get Eurlex Document
Look up any EUR-Lex document by CELEX number via CELLAR SPARQL (live).
Returns title, date, and URLs for the full text.
For CJEU case law (CELEX starting with 61 or 62): queries CELLAR SPARQL and
returns title, date, and URL. For legislative acts (regulations, directives —
CELEX starting with 3): returns the EUR-Lex URL directly (CELLAR does not
reliably index final legislative acts via SPARQL).
Use get_eu_regulation_article for known regulation codes (gdpr, dora, mica…).
Get Kho Decision
Return access details for a Finnish Supreme Administrative Court (KHO) precedent decision.
Requires Velvoite Premium API key.
KHO decisions are cited as KHO:YYYY:N (e.g. KHO:2024:52).
Use search_kho_decisions(year) to browse all decisions for a given year.
ACCESS PATTERN — follow this order:
1. Use the returned search_query with web_search to find the kho.fi page
2. From search results, fetch the kho.fi URL directly
3. Do NOT fetch finlex_url directly — Finlex requi
