mcp-pt
[!중요] 이 프로젝트는 비공식 커뮤니티 프로젝트입니다. 데이터 제공자(DGEG, IPMA, INE, GeoAPI.pt, AMA/dados.gov.pt)와 제휴 관계가 아닙니다. 각 제공자의 이용 약관을 준수하십시오. 특히 DGEG 연료 데이터는 비상업적 용도로만 사용 가능합니다.
기능
AI 어시스턴트에게 다음과 같은 질문을 할 수 있습니다:
"리스보아 구에서 가장 저렴한 디젤 주유소는 어디인가요?"
"내일 포르투에 비가 올까요? 활성 기상 경보가 있나요?"
"우편번호 1990-096은 어떤 지역인가요?"
"2021년 인구조사에서 포르투갈 인구는 얼마였나요?"
"dados.gov.pt에서 환경 관련 데이터셋을 검색해 주세요."
…그러면 적절한 도구를 호출하여 공개 API에 접근하고 실제 데이터로 답변합니다.
Related MCP server: IPMA MCP Server
설치
npx를 사용하여 실행합니다 (설치 불필요) — MCP 호스트에서 이를 가리키기만 하면 됩니다.
Claude Desktop
claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\)에 추가:
{
"mcpServers": {
"pt": {
"command": "npx",
"args": ["-y", "mcp-pt"]
}
}
}Cursor
~/.cursor/mcp.json (또는 프로젝트의 .cursor/mcp.json)에 추가:
{
"mcpServers": {
"pt": { "command": "npx", "args": ["-y", "mcp-pt"] }
}
}모든 MCP 호스트
서버는 stdio를 통해 MCP와 통신합니다. 서버 명령으로 npx -y mcp-pt (또는 클론에서 node dist/index.js)를 실행하세요.
도구
도구 | 기능 | 출처 |
| 특정 구에서 가장 저렴한 주유소 (휘발유/경유/LPG) | DGEG |
| 특정 위치의 5일 예보 | IPMA |
| 활성 기상 경보 | IPMA |
| 우편번호 조회 | GeoAPI.pt |
| 좌표 → 구/시/구역 | GeoAPI.pt |
| 시 (concelho) 상세 정보 | GeoAPI.pt |
|
| INE |
| dados.gov.pt에서 데이터셋 검색 | dados.gov.pt |
모든 도구는 무료 공개 API를 호출하며 API 키가 필요하지 않습니다.
예시 (원시 MCP)
# List the tools over stdio
printf '%s\n' \
'{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"x","version":"0"}}}' \
'{"jsonrpc":"2.0","method":"notifications/initialized"}' \
'{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | npx -y mcp-ptSDK와의 관계
mcp-pt는 동일한 데이터를 위한 독립형 다국어 SDK 패밀리 — precos-combustiveis-pt,
ipma-api,
geoapi-pt-sdk,
ine-pt 및
dados-gov-pt — 의 AI 인터페이스 계층입니다.
서버는 자체적으로 완전하며 (API를 직접 호출) 따라서 해당 패키지에 대한 의존성이 없습니다.
개발
npm install
npm test # vitest
npm run build # tsup → dist/index.js (executable)
node dist/index.jsFAQ
아니요. 모든 도구는 무료 공개 포르투갈 API를 사용합니다.
아니요 — 독립적인 커뮤니티 프로젝트입니다. 각 제공자의 이용 약관을 준수해 주십시오 (DGEG 연료 데이터는 비상업적 용도입니다).
stdio를 통해 MCP와 통신하는 모든 호스트 — Claude Desktop, Cursor, Continue 및 MCP SDK를 사용하는 사용자 정의 클라이언트.
라이선스
MIT © Marcelo Domingues
Available Tools
8 toolsfuel_pricesB
Find the cheapest fuel stations in a Portuguese district (data: DGEG). Use for questions about gasolina/gasóleo/GPL prices near a place.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many stations to return (default 10). | |
| district | Yes | District name, e.g. 'Lisboa', 'Porto', 'Faro' | |
| fuelType | No | One of: gasolina 95, gasolina 98, gasoleo, gpl. Default gasolina 95. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden for behavioral disclosure. It does not mention read-only vs. write behavior, data freshness (DGEG data likely has update schedules), rate limits, or pagination (though no output schema is given). The description is too brief to adequately cover behavioral traits for a tool interacting with an external data source.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, concise sentence that front-loads purpose and context (data source, use case). Every word adds value; there is no fluff. However, it could slightly improve by mentioning the optional parameters limit and fuelType, but overall it is well-structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's moderate complexity (3 parameters, no output schema), the description covers the basic purpose and data source. However, it misses completeness regarding return format (list of stations with prices? just names?) and any limits on results other than what is in the schema. Without output schema, the description should hint at what the agent will receive. It is adequate but not exhaustive.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has full coverage (100%) with descriptions for all three parameters, including defaults and the list of fuel types. The description adds context by connecting the 'fuelType' parameter to Portuguese terms (gasolina, gasóleo) mentioned in the use case, which semantically clarifies the parameter. The description and schema together provide strong parameter semantics.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: finding the cheapest fuel stations in a Portuguese district. It specifies the data source (DGEG) and the use case (questions about gasolina, gasóleo, GPL prices near a place). However, it could more directly differentiate from siblings like reverse_geocode or municipality, though the domain is distinct enough.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for fuel price queries in Portugal, but does not explicitly state when not to use it or mention alternatives among siblings. The mention of 'data: DGEG' provides context, but there is no guidance on when other tools like open_data_search might be more appropriate.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ine_indicatorA
Fetch an INE (Instituto Nacional de Estatística) statistics indicator by its 7-digit code (varcd). Pass dimension selectors (Dim1 is the period; use 'T' for a dimension's total). Example: varcd '0011609', dims { Dim1: 'S7A2021', Dim2: 'PT', Dim3: 'T', Dim4: 'T' }.
| Name | Required | Description | Default |
|---|---|---|---|
| dims | No | Dimension selectors, e.g. { Dim1: 'S7A2021', Dim2: 'PT' } | |
| lang | No | Response language (default PT) | |
| varcd | Yes | 7-digit INE indicator code |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description must fully disclose behavioral traits, but it only says 'fetch' (suggesting read-only) and explains the 'T' placeholder for totals. It does not cover error handling, response format, required permissions, rate limits, or any side effects, leaving significant gaps for an agent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two sentences plus an example, with no redundant text. It is front-loaded with the core action and code format. The example could be slightly cleaner (nested braces), but overall it is efficient.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the lack of an output schema and the tool's complexity (nested dims object, multiple parameters), the description is incomplete. It does not explain what the response contains (e.g., a single value, a series, metadata) or how errors are indicated. This forces the agent to guess the return structure.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so baseline is 3. The description adds meaningful context beyond the schema: it clarifies that varcd is exactly 7 digits, explains that Dim1 is the period, and introduces the 'T' convention for dimension totals. This helps the agent correctly construct the dims object.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool fetches an INE statistics indicator using a 7-digit code (varcd) with dimension selectors. It specifies the exact resource and action, and the sibling tools (e.g., fuel_prices, weather_forecast) are in different domains, so no confusion arises.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives an example of how to call the tool but does not explicitly state when to use it versus alternatives or when not to use it. The usage is implied by the domain, but there is no direct guidance on context or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
municipalityC
Details of a Portuguese municipality (concelho): NIF, area, contacts, postal code (data: GeoAPI.pt).
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Municipality name, e.g. 'Lisboa', 'Sintra' |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, so the description must disclose behavioral traits. It mentions the data source (GeoAPI.pt) but omits side effects, authentication needs, error behavior, or whether the operation is read-only. With such minimal disclosure, the agent lacks critical context for safe invocation.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single efficient sentence that conveys purpose and data source without extraneous words. It could be slightly more structured (e.g., listing fields explicitly), but overall it is concise and front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Without an output schema, the description should provide sufficient context about return values and behavior. It lists a few fields but is vague ('details') and does not cover error cases, completeness of fields, or format. The sibling context helps but does not compensate for the lack of explicit completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema already provides a description for the sole parameter 'name' with examples. The description adds no additional meaning about format, constraints, or behavior, so it meets the baseline of 3 given 100% schema coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly identifies the resource (Portuguese municipality details) and lists specific data fields (NIF, area, contacts, postal code). While it doesn't explicitly differentiate from siblings, the resource and data points are distinct enough among the listed siblings to imply its purpose.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives like postal_code or open_data_search. The description only states what it does, leaving the agent to infer usage context without any criteria for selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
open_data_searchA
Search the Portuguese open-data portal dados.gov.pt for datasets by keyword (data: dados.gov.pt / uData).
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search terms, e.g. 'população', 'covid', 'ambiente' | |
| pageSize | No | How many datasets to return (default 5). |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden for behavioral disclosure. It discloses the tool searches a specific portal and mentions the keyword parameter, but does not detail return format, pagination, or rate limits. However, the clarity on resource and action is sufficient for a simple search tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, concise sentence that packs significant information—resource, action, location, and keyword examples. It is front-loaded and earns its place with no filler. A slight improvement could include a brief note on return format.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the low complexity (2 simple parameters, no output schema or nested objects), the description is largely adequate. It covers the main search behavior and parameter usage. It lacks details on expected output structure or pagination, but for a simple keyword search, this is acceptable.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so baseline is 3. The description adds value by giving example query terms ('população', 'covid', 'ambiente') and explaining pageSize's purpose and default, going beyond the schema's basic description. This additional guidance helps the agent craft effective queries.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool searches a specific open-data portal (dados.gov.pt) for datasets by keyword, with the key resource and action explicit. It distinguishes itself from sibling tools (e.g., fuel_prices, weather_forecast) which target different data sources and domains.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives a clear search context and example keywords, implying usage for dataset discovery on the Portuguese portal. It does not explicitly state when not to use it or name alternatives, but the sibling tools (e.g., fuel_prices, ine_indicator) serve distinct purposes, making the context clear.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
postal_codeB
Look up a Portuguese postal code (código postal) — locality, municipality, district and streets (data: GeoAPI.pt).
| Name | Required | Description | Default |
|---|---|---|---|
| postalCode | Yes | Postal code, e.g. '1990-096' or '1990' |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the full burden. It only states the lookup nature and data source. It does not disclose whether the lookup is read-only, what happens if the postal code is invalid, rate limits, authentication needs, or the structure of the return value. The description is too minimal for a tool with no annotation safety net.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence that is front-loaded with the action and resource. Every word adds value, and there is no unnecessary repetition or fluff.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool has low complexity (one parameter, no nested objects) and no output schema. The description mentions the fields returned (locality, municipality, district, streets) but does not specify the output format, structure, or how to interpret the result. This is adequate but incomplete for an agent to reliably use the tool without further assumptions.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% coverage with a description for the parameter. The tool description does not add any new semantic information about the parameter beyond what the schema already provides (e.g., example format). Following the rubric, baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('Look up'), the resource ('Portuguese postal code'), and the specific data returned ('locality, municipality, district and streets'). It also identifies the data source (GeoAPI.pt). This clearly distinguishes it from sibling tools like fuel_prices or weather_forecast.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It does not mention prerequisites (e.g., valid postal code format), when not to use it, or how it compares to related tools like reverse_geocode or municipality.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
reverse_geocodeA
Reverse geocode a coordinate in Portugal → district, municipality and parish (freguesia) (data: GeoAPI.pt).
| Name | Required | Description | Default |
|---|---|---|---|
| lat | Yes | Latitude | |
| lon | Yes | Longitude |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, so the description must disclose behavioral traits. It reveals the data source (GeoAPI.pt) and output structure, but omits operational details like rate limits, cost, error handling (e.g., for coordinates outside Portugal), or idempotency. The core behavior is communicated, but safety and performance cues are absent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single focused sentence of 16 words. It packs the action, input scope, output types, and data source with no redundancy. Every word earns its place, meeting the highest standard of conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple two-parameter tool with no output schema, the description adequately explains what the tool does and returns. It references the data source and geographic scope. It could mention coordinate system (WGS84), but given the tool's simplicity and the sibling context of Portugal-specific tools, it is sufficiently complete for selection.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with basic descriptions ('Latitude', 'Longitude'), so baseline is 3. The description adds value by clarifying that the coordinate must be within Portugal and that the result yields specific administrative areas (district, municipality, parish), which is not evident from the schema alone.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's action ('reverse geocode'), the input (coordinate), and the output (district, municipality, parish) with geographic scoping ('in Portugal'). This is specific and distinguishes it from most siblings (e.g., weather tools), though it does not explicitly contrast with the 'municipality' sibling which could retrieve similar area names by different means.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is given on when to use this tool versus alternatives like 'municipality' or 'postal_code'. The description implies use when you have lat/lon and need administrative divisions, but it does not state prerequisites, coordinate system assumptions, or when not to use it (e.g., for addresses or full postal codes).
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
weather_forecastC
5-day weather forecast for a Portuguese location (data: IPMA). Give a city/locality name.
| Name | Required | Description | Default |
|---|---|---|---|
| location | Yes | Location name, e.g. 'Lisboa', 'Porto', 'Faro', 'Funchal' |
TDQS
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 discloses the time range (5-day) and data source (IPMA), but omits critical behavioral traits such as whether the forecast is read-only, what happens on invalid locations, data freshness, rate limits, or response format. The description is too minimal to ensure safe invocation.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, front-loaded sentence of 16 words. It conveys the essential information without superfluous text. Every word earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity (one parameter, no output schema, no annotations), the description is too sparse. It does not explain the return value structure, error handling, or any constraints. An agent would lack enough context to interpret the forecast output or handle edge cases adequately.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% for the single parameter 'location', so the baseline is 3. The description adds the phrase 'city/locality name', which slightly reinforces the schema's examples ('Lisboa', 'Porto'). This adds minimal extra meaning beyond the schema's existing description.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool provides a '5-day weather forecast for a Portuguese location' and specifies the data source (IPMA). It is a specific verb+resource combination. However, it does not explicitly differentiate from the sibling tool 'weather_warnings', leaving the agent to infer the distinction from the tool names alone.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives a basic instruction ('Give a city/locality name') but provides no guidance on when to use this tool versus alternatives (e.g., weather_warnings for alerts, fuel_prices for unrelated data). It lacks explicit context about when to use or not use this tool.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
weather_warningsA
Active meteorological warnings for Portugal (data: IPMA). Returns only non-green (active) warnings.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It reveals the data source (IPMA) and filtering (only non-green warnings), but omits behavioral traits like update frequency, rate limits, or whether the operation is read-only.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence with no unnecessary words. It is concise and front-loaded with the core purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no parameters, no output schema, and no annotations, the description is fairly complete but lacks details on the return format (e.g., fields, structure). It hints at filtering but leaves the response shape ambiguous.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has zero parameters, so the baseline is 4. The description does not need to explain parameters, and it adds value by clarifying the output focus (active warnings).
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool returns active meteorological warnings for Portugal, sourced from IPMA. It distinguishes itself from the sibling 'weather_forecast' by focusing on warnings, not forecasts.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies the tool is for current active warnings (non-green) but does not explicitly state when to use it over alternatives like 'weather_forecast' or when not to use it. No mention of context or prerequisites.
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.
8 tool updates
v0.1.0- First observed
fuel_prices - First observed
ine_indicator - First observed
municipality - First observed
open_data_search - First observed
postal_code - First observed
reverse_geocode - First observed
weather_forecast - First observed
weather_warnings
TDQS
Scored across 8 tools
Each tool addresses a distinct domain (fuel prices, weather, postal codes, geocoding, municipalities, statistics, open data search) with no overlapping purposes, making it easy for an agent to select the correct tool.
All tool names follow a consistent snake_case pattern with descriptive noun_phrase or verb_noun structures (e.g., postal_code, reverse_geocode, open_data_search), ensuring predictability.
With 8 tools, the server provides a focused yet comprehensive coverage of Portuguese public data services, avoiding bloat or insufficiency for its intended scope.
The tool set covers major data categories for Portugal (energy, weather, geography, government, statistics, open data) with no critical gaps; common queries are well-served.
Maintenance
Related MCP Connectors
- geoOAuthco.thinair
Geocoding, routing, isochrones, traffic, weather, and place search for AI agents. 19 MCP tools.
Real-world data for agents: air quality, geocoding, quakes, holidays, web search
Public Data Ukraine Mcp connects AI agents to real public APIs via MCP. Tools include
15 media & data tools for AI agents: search, transcribe, subtitles, voiceover, translate & more.
Related MCP Servers
- AlicenseBqualityCmaintenanceProvides access to Portuguese meteorological data from IPMA (Instituto Português do Mar e da Atmosfera), including weather forecasts, warnings, UV index, seismic data, and weather station observations for cities in Portugal.6MIT
- FlicenseAqualityDmaintenanceProvides access to Portuguese weather data from IPMA (Instituto Português do Mar e da Atmosfera), including weather forecasts, meteorological warnings, seismic data, UV index, and real-time observations from weather stations across Portugal.6-
- AlicenseAqualityDmaintenanceProvides comprehensive access to Portuguese weather data from IPMA, including forecasts, warnings, sea state, fire risk, UV index, seismic activity, and weather station observations for all Portuguese cities and islands.10MIT
- AlicenseAqualityCmaintenanceEnables lookup of Brazilian public data including companies (CNPJ), postal codes (CEP), banking, economy, geography, and more through 15 tools and 2 guided prompts, powered by BrasilAPI with no API key required.15MIT