Skip to main content
Glama
Ansvar-Systems

Portuguese Competition MCP

Portuguese Competition MCP

▶ Try this MCP instantly via Ansvar Gateway

50 free queries/day · no card required · OAuth signup at ansvar.eu/gateway

One endpoint, one OAuth signup, access from any MCP-compatible client.

Connect

Claude Code (one line):

claude mcp add ansvar --transport http https://gateway.ansvar.eu/mcp

Claude Desktop / Cursor — add to claude_desktop_config.json (or mcp.json):

{
  "mcpServers": {
    "ansvar": {
      "type": "url",
      "url": "https://gateway.ansvar.eu/mcp"
    }
  }
}

Claude.ai — Settings → Connectors → Add custom connector → paste https://gateway.ansvar.eu/mcp

First request opens an OAuth flow at ansvar.eu/gateway. After signup, your client is bound to your account; tier (free / premium / team / company) determines fan-out, quota, and which downstream MCPs are reachable.


Self-host this MCP

You can also clone this repo and build the corpus yourself. The schema, fetcher, and tool implementations all live here. What is not in the repo is the pre-built database — TDM and standards-licensing constraints on the upstream sources mean we host the corpus on Ansvar infrastructure rather than redistribute it as a public artifact.

Build your own: run this repo's ingestion script (entry-point varies per repo — typically scripts/ingest.sh, npm run ingest, or make ingest; check the repo root).

Portuguese competition data for AI compliance tools.

License CI

Query Portuguese competition data -- regulations, decisions, and requirements from AdC (Autoridade da Concorrencia) -- directly from Claude, Cursor, or any MCP-compatible client.

Built by Ansvar Systems -- Stockholm, Sweden


Related MCP server: Portuguese Cybersecurity MCP

Available Tools (6)

Tool

Description

pt_comp_search_decisions

Full-text search across AdC (Autoridade da Concorrencia) enforcement decisions (abuse of dominance, cartel, sector in...

pt_comp_get_decision

Get a specific AdC decision by case number (e.g.,

pt_comp_search_mergers

Search AdC merger control decisions (concentracoes de empresas). Returns merger cases with acquiring party, target, s...

pt_comp_get_merger

Get a specific AdC merger control decision by case number.

pt_comp_list_sectors

List all sectors with AdC enforcement activity, including decision counts and merger counts per sector.

pt_comp_about

Return metadata about this MCP server: version, data source, coverage, and tool list.

All tools return structured data with source references and timestamps.


Data Sources and Freshness

All content is sourced from official Portuguese regulatory publications:

  • AdC (Autoridade da Concorrencia) -- Official regulatory authority

Data Currency

  • Database updates are periodic and may lag official publications

  • Freshness checks run via GitHub Actions workflows

  • Last-updated timestamps in tool responses indicate data age

See sources.yml for full provenance metadata.


Security

This project uses multiple layers of automated security scanning:

Scanner

What It Does

Schedule

CodeQL

Static analysis for security vulnerabilities

Weekly + PRs

Semgrep

SAST scanning (OWASP top 10, secrets, TypeScript)

Every push

Gitleaks

Secret detection across git history

Every push

Trivy

CVE scanning on filesystem and npm dependencies

Daily

Docker Security

Container image scanning + SBOM generation

Daily

Socket.dev

Supply chain attack detection

PRs

Dependabot

Automated dependency updates

Weekly

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


Important Disclaimers

Not Regulatory Advice

THIS TOOL IS NOT REGULATORY OR LEGAL ADVICE

Regulatory data is sourced from official publications by AdC (Autoridade da Concorrencia). However:

  • This is a research tool, not a substitute for professional regulatory counsel

  • Verify all references against primary sources before making compliance decisions

  • Coverage may be incomplete -- do not rely solely on this for regulatory research

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

Confidentiality

Queries go through the Claude API. For privileged or confidential matters, use on-premise deployment. See PRIVACY.md for details.


Development

Setup

git clone https://github.com/Ansvar-Systems/portuguese-competition-mcp
cd portuguese-competition-mcp
npm install
npm run build
npm test

Running Locally

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

Data Management

npm run build:db       # Rebuild SQLite database from seed data
npm run check-updates  # Check for new regulatory data

More Ansvar MCPs

Full fleet at ansvar.eu/gateway.

Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.


License

Apache License 2.0. See LICENSE for details.

Data Licenses

Regulatory data sourced from official government publications. See sources.yml for per-source licensing details.


About Ansvar Systems

We build AI-powered compliance and legal research tools for the European market. Our MCP fleet provides structured, verified regulatory data to AI assistants -- so compliance professionals can work with accurate sources instead of guessing.

ansvar.eu -- Stockholm, Sweden


Available Tools

6 tools
pt_comp_aboutA

Return metadata about this MCP server: version, data source, coverage, and tool list.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden. It clearly indicates a read-only operation by stating 'Return metadata,' which implies no side effects. It also discloses what specific metadata will be returned. There are no apparent behavioral surprises, making the transparency adequate for a simple metadata tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, concise sentence that immediately states the purpose and enumerates the metadata fields. Every word earns its place, and the structure is perfectly front-loaded with the action verb and resource.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the trivial complexity (no parameters, no output schema), the description fully covers what the tool does and what it returns. It is complete for its intended purpose and clearly differentiates from sibling tools that access specific data domains.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters, and the input schema is empty with 100% coverage (trivially). The baseline for 0 parameters is 4, and the description does not need to add parameter detail since there are none. It adds no param semantics because none are required.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Return metadata about this MCP server.' It explicitly lists the metadata components (version, data source, coverage, tool list), using a specific verb ('Return') and resource ('MCP server'). This uniquely distinguishes it from sibling tools that search/get specific records.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies when to use the tool (when server metadata is needed) but does not explicitly state usage context or mention alternatives. No exclusions are provided, but the intended use is fairly obvious. A more explicit statement like 'Use this to understand server capabilities or data coverage' would strengthen it.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

pt_comp_get_decisionA

Get a specific AdC decision by case number (e.g., 'PRC/2023/1', 'Ccent/2022/5').

ParametersJSON Schema
NameRequiredDescriptionDefault
case_numberYesAdC case number

TDQS

A4.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the behavioral burden. It conveys a read-only operation ('Get') and adds context about the case number format (e.g., 'PRC/2023/1'). However, it does not disclose possible error behavior, return format, or any limitations, which is a minor gap for a lookup tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence that immediately states the action and resource. It includes useful examples without superfluous words. Every part earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple getter with one parameter and no output schema, the description provides the essential information: what the tool does, how to specify the case number, and realistic examples. No additional context is necessary given the tool's low complexity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema already describes case_number as 'AdC case number' (100% coverage), but the description adds meaningful examples of the expected format ('PRC/2023/1', 'Ccent/2022/5'). This goes beyond the schema's generic description, helping the agent understand exact input syntax.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Get a specific AdC decision by case number' clearly states the verb (Get), resource (AdC decision), and identifier (case number). It distinguishes itself from sibling tools like pt_comp_search_decisions (searching) and pt_comp_get_merger (mergers) by focusing on fetching a specific decision.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage when the user already has a case number, and provides examples of valid formats. It does not explicitly state exclusions or name alternatives, but the context is clear for a simple getter tool. The sibling names (search_decisions) suggest when to use search instead, though this is not explicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

pt_comp_get_mergerA

Get a specific AdC merger control decision by case number.

ParametersJSON Schema
NameRequiredDescriptionDefault
case_numberYesAdC merger case number

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It only states 'Get', implying a read operation, but does not disclose return format, error behavior, or any permissions. For a simple getter this is sparse, and the agent lacks behavioral context beyond the action itself.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence that is entirely on-topic. Every word contributes to the purpose, with no fluff or repetition.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the low complexity (one parameter, no nested objects) and the absence of an output schema, the description is minimally adequate. However, it does not mention what the response contains or any caveats, which would be helpful for a getter without structured output metadata.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with the parameter already described as 'AdC merger case number'. The description does not add any additional meaning beyond the schema, so it meets the baseline without enhancement.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool gets a specific AdC merger control decision by case number. The verb 'Get' and resource 'merger control decision' are specific, and it distinguishes itself from siblings like pt_comp_get_decision and search tools by focusing on merger decisions and case numbers.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied by the phrase 'by case number' but no explicit alternatives or exclusions are mentioned. It does not say when to prefer this over pt_comp_get_decision or pt_comp_search_mergers, so guidance is minimal.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

pt_comp_list_sectorsA

List all sectors with AdC enforcement activity, including decision counts and merger counts per sector.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden. It discloses that the list is filtered to sectors with enforcement activity and includes counts, but does not explicitly state that the operation is read-only or describe any side effects, authentication requirements, or limitations. The description adds some behavioral context but is not exhaustive.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence that states the primary action and the essential output components (sectors, decision counts, merger counts). Every word contributes meaning, with no redundancy or filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple list tool with no parameters and no output schema, the description adequately conveys the purpose and the expected result. It could potentially mention pagination or sorting, but these are not critical for a sector list. The addition of 'with AdC enforcement activity' clarifies the filter, making it complete enough for typical use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters, so the schema coverage is 100%. Per the rubric, 0 params yields a baseline of 4. The description adds no parameter details because there are none, which is appropriate and does not need to compensate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb 'List' and resource 'sectors', and clearly distinguishes itself from sibling tools by focusing on sector-level aggregation with decision and merger counts. It is not a tautology and immediately conveys what the tool does.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for sector-level overview, as it lists sectors with activity and counts. However, it does not explicitly state when to use this tool over the search/get sibling tools, nor does it mention alternatives or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

pt_comp_search_decisionsA

Full-text search across AdC (Autoridade da Concorrencia) enforcement decisions (abuse of dominance, cartel, sector inquiries). Returns matching decisions with case number, parties, outcome, fine amount, and Lei da Concorrencia articles cited.

ParametersJSON Schema
NameRequiredDescriptionDefault
typeNoFilter by decision type. Optional.
limitNoMaximum number of results to return. Defaults to 20.
queryYesSearch query in Portuguese or English (e.g., 'posicao dominante', 'cartel preco', 'concentracao empresarial', 'abuse of dominance')
sectorNoFilter by sector ID (e.g., 'energy', 'banking', 'telecommunications'). Optional.
outcomeNoFilter by outcome. Optional.

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full transparency burden. It discloses the return fields (case number, parties, outcome, fine amount, Lei da Concorrencia articles) and clearly indicates a search (read) operation, but does not address pagination, rate limits, or data coverage boundaries.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences: one for purpose and one for return content. It is front-loaded, specific, and contains no redundant information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description covers the core function and return fields, which is sufficient given the schema handles parameter documentation. It could be more explicit about limitations (e.g., not covering mergers) but overall is complete for a search tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, with all five parameters described in the input schema. The description adds no additional parameter-specific meaning beyond what the schema already provides, so the baseline of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool performs full-text search across AdC enforcement decisions, with specific examples of decision types (abuse of dominance, cartel, sector inquiries). This distinguishes it from sibling tool pt_comp_search_mergers, which focuses on mergers.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for searching enforcement decisions but does not explicitly mention when to use this tool instead of pt_comp_search_mergers or other siblings. No exclusions or alternative tools are named.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

pt_comp_search_mergersA

Search AdC merger control decisions (concentracoes de empresas). Returns merger cases with acquiring party, target, sector, and outcome.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMaximum number of results to return. Defaults to 20.
queryYesSearch query in Portuguese or English (e.g., 'concentracao', 'aquisicao', 'fusao', 'energia renovavel')
sectorNoFilter by sector ID. Optional.
outcomeNoFilter by merger outcome. Optional.

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It does disclose that the tool returns merger cases and names the fields included, which is a useful behavioral trait. However, it does not mention any additional behaviors such as query semantics, ordering, or potential limitations like pagination.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence that front-loads the main action and resource, then adds relevant return information. It contains zero wasted words and is highly concise.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is relatively simple with four parameters fully described in the schema. The description provides enough context about the tool's purpose and return value, though it does not explain how the search works or how it relates to sibling tools. Overall it is adequate for a basic search tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100%, so parameters are already fully documented in structured data. The description does not add any additional meaning to the parameters beyond what the schema provides, so the baseline score of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose with a specific verb ('Search') and resource ('AdC merger control decisions'), and clarifies the scope ('concentracoes de empresas'). It also lists the key return fields (acquiring party, target, sector, outcome), which distinguishes it from the sibling search tool pt_comp_search_decisions.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description clearly indicates that this tool is for searching merger control decisions, which gives a clear context for use. It does not explicitly mention when to prefer this over pt_comp_search_decisions, but the specialized focus on mergers makes the intended usage obvious.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 6 tool updatesv0.1.0
    • First observedpt_comp_about
    • First observedpt_comp_get_decision
    • First observedpt_comp_get_merger
    • First observedpt_comp_list_sectors
    • First observedpt_comp_search_decisions
    • First observedpt_comp_search_mergers

TDQS

A4.1/5.0

Scored across 6 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: search vs. get, decisions vs. mergers, plus aggregate sector info and metadata. No two tools overlap in functionality or intended use.

Naming Consistency4/5

The consistent pt_comp_ prefix and verb_noun pattern (search_decisions, get_decision, search_mergers, get_merger, list_sectors) make naming predictable. The 'about' tool breaks the verb_noun pattern slightly, and there's a minor singular/plural mismatch between search and get, but these are trivial.

Tool Count5/5

Six tools is an appropriate scope for a focused competition law database: two resource types each with search and get, plus a sector overview and server metadata. Nothing feels redundant or missing.

Completeness5/5

For a read-only legal information server, the surface is complete: it offers both search and retrieval for the two core entity types (decisions and mergers), and list_sectors provides useful aggregate context. No dead ends or essential missing operations.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers