eu.ansvar/costa-rican-law-mcp

平台与服务

by ansvar-systems

通过 MCP 访问哥斯达黎加法律法规,支持对 statutes 与 provisions 进行全文检索。

什么是 eu.ansvar/costa-rican-law-mcp

通过 MCP 访问哥斯达黎加法律法规,支持对 statutes 与 provisions 进行全文检索。

README

Costa Rican Law MCP Server

The SCIJ alternative for the AI age.

npm version MCP Registry License GitHub stars CI Provisions

Query 16,724 Costa Rican laws -- from the Penal Code and Data Protection Law to the Telecommunications Law, Digital Signatures Act, and more -- directly from Claude, Cursor, or any MCP-compatible client.

If you're building legal tech, compliance tools, or doing Costa Rican legal research, this is your verified reference database.

Built by Ansvar Systems -- Stockholm, Sweden


Why This Exists

Costa Rican legal research means navigating SCIJ (Sistema Costarricense de Informacion Juridica), downloading HTML pages from an ASP.NET portal, and manually cross-referencing between laws and articles. Whether you're:

  • A lawyer validating citations in a brief or contract
  • A compliance officer checking data protection obligations under Ley 8968
  • A legal tech developer building tools on Costa Rican law
  • A researcher tracing legislative provisions across 16,724 laws

...you shouldn't need dozens of browser tabs and manual cross-referencing. Ask Claude. Get the exact provision. With context.

This MCP server makes Costa Rican law searchable, cross-referenceable, and AI-readable.


Quick Start

Use Remotely (No Install Needed)

Connect directly to the hosted version -- zero dependencies, nothing to install.

Endpoint: https://mcp.ansvar.eu/law-cr/mcp

ClientHow to Connect
Claude.aiSettings > Connectors > Add Integration > paste URL
Claude Codeclaude mcp add costa-rican-law --transport http https://mcp.ansvar.eu/law-cr/mcp
Claude DesktopAdd to config (see below)
GitHub CopilotAdd to VS Code settings (see below)

Claude Desktop -- add to claude_desktop_config.json:

json
{
  "mcpServers": {
    "costa-rican-law": {
      "type": "url",
      "url": "https://mcp.ansvar.eu/law-cr/mcp"
    }
  }
}

GitHub Copilot -- add to VS Code settings.json:

json
{
  "github.copilot.chat.mcp.servers": {
    "costa-rican-law": {
      "type": "http",
      "url": "https://mcp.ansvar.eu/law-cr/mcp"
    }
  }
}

Use Locally (npm)

bash
npx @ansvar/costa-rican-law-mcp

Claude Desktop -- add to claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

json
{
  "mcpServers": {
    "costa-rican-law": {
      "command": "npx",
      "args": ["-y", "@ansvar/costa-rican-law-mcp"]
    }
  }
}

Cursor / VS Code:

json
{
  "mcp.servers": {
    "costa-rican-law": {
      "command": "npx",
      "args": ["-y", "@ansvar/costa-rican-law-mcp"]
    }
  }
}

Example Queries

Once connected, just ask naturally:

  • "What does Ley 8968 say about data protection consent?"
  • "Find provisions about delitos informaticos in Costa Rican law"
  • "Is the Telecommunications Law (Ley 8642) still in force?"
  • "What does Article 196 bis of the Penal Code say about computer crimes?"
  • "Search for firma digital requirements across Costa Rican statutes"
  • "Validate the citation 'Articulo 5 Ley 8968'"
  • "Build a legal stance on personal data protection in Costa Rica"

What's Included

CategoryCountDetails
Laws16,724 statutesCensus-first from SCIJ (18,761 discovered, 15,997 accessible)
Provisions120,455 articlesFull-text searchable with FTS5
Legal Definitions3,620 definitionsExtracted from definition articles
Database Size~276 MBOptimized SQLite, portable
Weekly Freshness ChecksAutomatedDrift detection against SCIJ

Key Laws

LawDescriptionProvisions
Ley 8968Data Protection LawPersonal data, consent, data subject rights
Ley 9048Computer Crime ReformCybercrime provisions in the Penal Code
Ley 8642General Telecommunications LawTelecom regulation and oversight
Ley 8454Digital Signatures and CertificatesElectronic documents and PKI
Ley 4573Penal CodeCriminal law including cyber offenses
Ley 8220Administrative SimplificationAnti-red-tape obligations
Ley 10500Communications Interception ModernizationJudicial authorization rules

Verified data only -- every provision is ingested from official SCIJ sources (Procuraduria General de la Republica). Zero LLM-generated content.


Why This Works

Verbatim Source Text (No LLM Processing):

  • All statute text is ingested from SCIJ (Procuraduria General de la Republica)
  • Provisions are returned unchanged from SQLite FTS5 database rows
  • Zero LLM summarization or paraphrasing -- the database contains statute text, not AI interpretations

Smart Context Management:

  • Search returns ranked provisions with BM25 scoring (safe for context)
  • Provision retrieval gives exact text by law identifier + article number
  • Cross-references help navigate without loading everything at once

Technical Architecture:

code
SCIJ HTML --> Parse --> SQLite --> FTS5 snippet() --> MCP response
               ^                        ^
        Provision parser         Verbatim database query

Traditional Research vs. This MCP

Traditional ApproachThis MCP Server
Search SCIJ by law numberSearch by plain language: "proteccion datos personales"
Navigate multi-article statutes manuallyGet the exact provision with context
Manual cross-referencing between lawsbuild_legal_stance aggregates across sources
"Is this statute still in force?" --> check manuallycheck_currency tool --> answer in seconds
No API, no integrationMCP protocol --> AI-native

Traditional: Search SCIJ --> Navigate ASP.NET portal --> Ctrl+F --> Cross-reference between laws --> Repeat

This MCP: "What are the consent requirements under Ley 8968 and how do they compare to GDPR?" --> Done.


Available Tools (13)

Core Legal Research Tools (8)

ToolDescription
search_legislationFTS5 full-text search across 75,042 provisions with BM25 ranking. Supports quoted phrases, boolean operators, prefix wildcards
get_provisionRetrieve specific provision by law identifier + article number (e.g., "cr-ley8968" + "1")
check_currencyCheck if a statute is in force, amended, or repealed
validate_citationValidate citation against database -- zero-hallucination check
build_legal_stanceAggregate citations from multiple statutes for a legal topic
format_citationFormat citations per Costa Rican conventions
list_sourcesList all available statutes with metadata, coverage scope, and data provenance
aboutServer info, capabilities, dataset statistics, and coverage summary

EU/International Law Integration Tools (5)

ToolDescription
get_eu_basisGet EU directives/regulations that a Costa Rican statute references
get_costa_rican_implementationsFind Costa Rican laws referencing a specific EU act
search_eu_implementationsSearch EU documents with Costa Rican reference counts
get_provision_eu_basisGet EU law references for a specific provision
validate_eu_complianceCheck alignment status of Costa Rican statutes against EU directives

EU Law Integration

Costa Rica is not an EU member state, but certain Costa Rican laws share principles with EU frameworks:

  • Ley 8968 (Data Protection) shares significant overlap with GDPR principles on consent, data subject rights, and data controller obligations
  • Ley 8454 (Digital Signatures) aligns with eIDAS concepts for electronic signatures and certificates
  • Costa Rica participates in multilateral frameworks that share principles with EU data protection

The EU bridge tools allow you to explore these alignment relationships -- checking which Costa Rican provisions correspond to EU requirements, and vice versa.

Note: EU cross-references reflect alignment relationships, not transposition. Costa Rica adopts its own legislative approach.


Data Sources & Freshness

All content is sourced from authoritative Costa Rican legal databases:

  • SCIJ -- Sistema Costarricense de Informacion Juridica, operated by the Procuraduria General de la Republica (PGR)

Data Provenance

FieldValue
AuthorityProcuraduria General de la Republica (PGR)
Retrieval methodHTML scrape from SCIJ date-range selective search
LanguageSpanish
LicenseGovernment open access
Coverage16,724 laws (64.6% of 18,761 discovered)
Last ingested2026-02-26

Automated Freshness Checks (Weekly)

A weekly GitHub Actions workflow monitors SCIJ for changes:

CheckMethod
Portal availabilityHEAD request to SCIJ
Document countDatabase vs. census comparison
Database ageBuild date threshold check

Security

This project uses multiple layers of automated security scanning:

ScannerWhat It DoesSchedule
CodeQLStatic analysis for security vulnerabilitiesWeekly + PRs
SemgrepSAST scanning (OWASP top 10, secrets, TypeScript)Every push
GitleaksSecret detection across git historyEvery push
TrivyCVE scanning on filesystem and npm dependenciesDaily
Socket.devSupply chain attack detectionPRs
DependabotAutomated dependency updatesWeekly

See SECURITY.md for the full policy and vulnerability reporting.


Important Disclaimers

Legal Advice

THIS TOOL IS NOT LEGAL ADVICE

Statute text is sourced from official SCIJ publications. However:

  • This is a research tool, not a substitute for professional legal counsel
  • Court case coverage is not included -- do not rely solely on this for case law research
  • Verify critical citations against primary sources for court filings
  • EU cross-references reflect alignment relationships, not transposition
  • Coverage is 100% of accessible content -- 16,724 of 18,761 discovered laws are ingested (2,764 entries have no digitized text on the SCIJ portal)

Before using professionally, read: DISCLAIMER.md | SECURITY.md

Client Confidentiality

Queries go through the Claude API. For privileged or confidential matters, use on-premise deployment.


Development

Setup

bash
git clone https://github.com/Ansvar-Systems/Costa-Rican-law-mcp
cd Costa-Rican-law-mcp
npm install
npm run build
npm test

Running Locally

bash
npm run dev                                       # Start MCP server
npx @anthropic/mcp-inspector node dist/index.js   # Test with MCP Inspector

Data Management

bash
npm run census                           # Enumerate all laws from SCIJ
npm run ingest                           # Ingest curated laws from SCIJ
npm run ingest -- --full-corpus          # Full corpus ingestion
npm run ingest -- --full-corpus --resume # Resume interrupted ingestion
npm run build:db                         # Rebuild SQLite database
npm run check-updates                    # Check for source updates
npm run drift:detect                     # Run drift detection

Performance

  • Search Speed: <100ms for most FTS5 queries
  • Database Size: ~147 MB (efficient, portable)
  • Reliability: 64.6% ingestion success rate (SCIJ portal limitations)

Related Projects: Complete Compliance Suite

This server is part of Ansvar's Compliance Suite -- MCP servers that work together for end-to-end compliance coverage:

@ansvar/eu-regulations-mcp

Query 49 EU regulations directly from Claude -- GDPR, AI Act, DORA, NIS2, MiFID II, eIDAS, and more. Full regulatory text with article-level search. npx @ansvar/eu-regulations-mcp

@ansvar/us-regulations-mcp

Query US federal and state compliance laws -- HIPAA, CCPA, SOX, GLBA, FERPA, and more. npx @ansvar/us-regulations-mcp

@ansvar/security-controls-mcp

Query 261 security frameworks -- ISO 27001, NIST CSF, SOC 2, CIS Controls, SCF, and more. npx @ansvar/security-controls-mcp

@ansvar/automotive-cybersecurity-mcp

Query UNECE R155/R156 and ISO 21434 -- Automotive cybersecurity compliance. npx @ansvar/automotive-cybersecurity-mcp

70+ national law MCPs covering Australia, Brazil, Canada, China, Denmark, Finland, France, Germany, Ghana, Iceland, India, Ireland, Israel, Italy, Japan, Kenya, Netherlands, Nigeria, Norway, Singapore, Slovenia, South Korea, Sweden, Switzerland, Thailand, UAE, UK, and more.


Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

Priority areas:

  • Remaining law ingestion (6,684 of 18,761 IDs pending SCIJ availability)
  • EU cross-reference expansion
  • Court case law coverage
  • Historical statute versions and amendment tracking
  • Decreto Ejecutivo and Reglamento coverage

Roadmap

  • Core statute database with FTS5 search
  • Census-first full corpus discovery (18,761 laws)
  • Full corpus ingestion (16,724 laws, 75,042 provisions, 809 definitions)
  • EU/international law alignment tools
  • Vercel Streamable HTTP deployment
  • npm package publication
  • Drift detection and weekly freshness checks
  • Remaining law ingestion (SCIJ portal recovery)
  • Decreto Ejecutivo and Reglamento coverage
  • Court case law expansion
  • Historical statute versions (amendment tracking)

Citation

If you use this MCP server in academic research:

bibtex
@software{costa_rican_law_mcp_2026,
  author = {Ansvar Systems AB},
  title = {Costa Rican Law MCP Server: AI-Powered Legal Research Tool},
  year = {2026},
  url = {https://github.com/Ansvar-Systems/Costa-Rican-law-mcp},
  note = {16,724 Costa Rican laws with 120,455 provisions and 3,620 definitions}
}

License

Apache License 2.0. See LICENSE for details.

Data Licenses

  • Legislation: Procuraduria General de la Republica (government open access via SCIJ)
  • EU Metadata: EUR-Lex (EU public domain)

About Ansvar Systems

We build AI-accelerated compliance and legal research tools for the global market. This MCP server started as our internal reference tool -- turns out everyone building compliance tools has the same research frustrations.

So we're open-sourcing it. Navigating 16,724 laws shouldn't require a law degree.

ansvar.eu -- Stockholm, Sweden


<p align="center"> <sub>Built with care in Stockholm, Sweden</sub> </p>

常见问题

eu.ansvar/costa-rican-law-mcp 是什么?

通过 MCP 访问哥斯达黎加法律法规,支持对 statutes 与 provisions 进行全文检索。

相关 Skills

MCP构建

by anthropics

Universal
热门

聚焦高质量 MCP Server 开发,覆盖协议研究、工具设计、错误处理与传输选型,适合用 FastMCP 或 MCP SDK 对接外部 API、封装服务能力。

想让 LLM 稳定调用外部 API,就用 MCP构建:从 Python 到 Node 都有成熟指引,帮你更快做出高质量 MCP 服务器。

平台与服务
未扫描121.2k

Slack动图

by anthropics

Universal
热门

面向Slack的动图制作Skill,内置emoji/消息GIF的尺寸、帧率和色彩约束、校验与优化流程,适合把创意或上传图片快速做成可直接发送的Slack动画。

帮你快速做出适配 Slack 的动图,内置约束规则和校验工具,少踩上传与播放坑,做表情包和演示都更省心。

平台与服务
未扫描121.2k

邮件模板

by alirezarezvani

Universal
热门

快速搭建生产可用的事务邮件系统:生成 React Email/MJML 模板,接入 Resend、Postmark、SendGrid 或 AWS SES,并支持本地预览、i18n、暗色模式、反垃圾优化与追踪埋点。

面向营销与服务场景,快速搭建高质量邮件模板,省去反复设计与切图成本,成熟度和社区认可都很高。

平台与服务
未扫描12.1k

相关 MCP Server

Slack 消息

编辑精选

by Anthropic

热门

Slack 是让 AI 助手直接读写你的 Slack 频道和消息的 MCP 服务器。

这个服务器解决了团队协作中需要 AI 实时获取 Slack 信息的痛点,特别适合开发团队让 Claude 帮忙汇总频道讨论或发送通知。不过,它目前只是参考实现,文档有限,不建议在生产环境直接使用——更适合开发者学习 MCP 如何集成第三方服务。

平台与服务
84.2k

by netdata

热门

io.github.netdata/mcp-server 是让 AI 助手实时监控服务器指标和日志的 MCP 服务器。

这个工具解决了运维人员需要手动检查系统状态的痛点,最适合 DevOps 团队让 Claude 自动分析性能数据。不过,它依赖 NetData 的现有部署,如果你没用过这个监控平台,得先花时间配置。

平台与服务
78.5k

by d4vinci

热门

Scrapling MCP Server 是专为现代网页设计的智能爬虫工具,支持绕过 Cloudflare 等反爬机制。

这个工具解决了爬取动态网页和反爬网站时的头疼问题,特别适合需要批量采集电商价格或新闻数据的开发者。不过,它依赖外部浏览器引擎,资源消耗较大,不适合轻量级任务。

平台与服务
38.1k

评论