Fixando MCP

Start with a service and a location

1. Choose a market. Call get_markets for supported countries, languages, currencies and endpoints.
2. Find a price page. Use search_price_categories with a market and service name. For local prices, find district and municipality IDs with search_price_locations.
3. Read the published prices. Pass a returned page URL to get_prices, or use its category and location IDs. Keep the returned currency, unit and source scope together.

Four tools, one price source

get_markets

Discover supported markets and languages. Start here when the country is not yet known.

search_price_categories

Find root, parent and service price-page candidates. Filter by name, hierarchy level or location.

search_price_locations

Find valid district (dd) and municipality (cc) IDs for a market.

get_prices

Read current prices by canonical page URL or by market, category and location IDs.

Search results are candidates, not a guarantee of price availability. Exact arguments and schemas are available through tools/list and in the Markdown reference.

Understand the price you receive

Same values as the website

Web pages and MCP share price selection, publication thresholds, units and rounding.

Median or mean

central_statistic identifies the central value. Request-based calculations use the median; legacy data uses the mean.

Range and source

range_statistic distinguishes P10–P90 ranges from legacy ranges. source and fallback identify the category and geographic scope actually used.

Snapshot date

date identifies the published snapshot. It is not an individual quote date or a fixed observation window.

Missing data

A valid page with insufficient data returns status: no_data and an empty prices array. Invalid contexts return an error.

Published prices are estimates, not binding quotes. Raw quotes and admin-only statistics are not exposed.

Technical reference

curl --request POST https://www.fixando.pt/mcp \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json, text/event-stream' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-11-25",
      "capabilities": {},
      "clientInfo": {
        "name": "example-client",
        "version": "1.0"
      }
    }
  }'

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "search_price_categories",
    "arguments": {
      "site_code": "pt",
      "query": "limpeza",
      "limit": 5
    }
  }
}