Model Context Protocol

Connect CenuFiltrs to your AI agent

The CenuFiltrs MCP server exposes 22 tools over the Model Context Protocol. Add it to an MCP-compatible client to search Latvian retailer prices, compare offers and use supported account features.

Fastest way

Let the agent set everything up

If you already have an AI agent, skip the manual setup. Send it the link to this page and ask it to connect the MCP server — it will read the instructions below and do the work for you.

Copy the text below — the link to this page is already in it.
Paste it into a chat with your agent (Claude, Cursor, VS Code and others).
The agent opens the page, adds the server to your config and confirms the connection.

Prompt for your agent

Set up the CenuFiltrs MCP server for me.
All connection instructions are on this page: https://cenufiltrs.lv/en/mcp
Read it, add the server to my MCP configuration and verify that the cf_* tools are available.

What your agent can do

The MCP server wraps the same public API that powers cenufiltrs.lv — no scraping, no stale data.

Search and compare in chat

Offer-first search with filters by category, brand and price range, plus price summaries, history and deal analysis across every connected retailer.

Your personal data, with your consent

After you sign in with your CenuFiltrs account, the agent can read and update your wishlist, price alerts and search history on your behalf.

Links back to the real pages

Every result carries a canonical CenuFiltrs deep link and a tracked outbound URL, so you can open the offer in the browser and the retailer still gets a correct referral.

Three ways to connect

If you prefer to configure it yourself, or your agent cannot open links, pick the option that matches your client. The remote connector is the simplest route for Claude.ai and Claude Desktop.

Recommended

Claude.ai and Claude Desktop

Add the server as a remote connector and sign in through the CenuFiltrs login form — OAuth handles the rest.

Open Settings → Connectors → Add custom connector.
Paste the server URL below and confirm.
Sign in with your CenuFiltrs email and password when Claude redirects you.
The connector is now available in every conversation.

Server URL

https://mcp.cenufiltrs.lv/mcp

JSON config

Claude Code, Cursor, VS Code

Clients that read an mcpServers config block connect over the same Streamable HTTP endpoint.

Open your client's MCP configuration file.
Add the cenufiltrs entry shown below.
Restart the client and confirm the cf_* tools are listed.

MCP configuration

{
  "mcpServers": {
    "cenufiltrs": {
      "url": "https://mcp.cenufiltrs.lv/mcp"
    }
  }
}

Local / stdio

Local run with an API key

For local development the server also runs over stdio and authenticates with a base64-encoded CenuFiltrs login.

Encode your CenuFiltrs email and password as base64.
Pass the result as CENUFILTRS_API_KEY when starting the server.
Anonymous tools work without a key; personal tools require one.

Terminal

echo -n "you@example.com:your-password" | base64

export CENUFILTRS_API_KEY="<base64-result>"

Available tools

22 tools in total. Public tools work without signing in; personal tools require an authorized account.

Public tools

Available without signing in.

Tool	What it does
`cf_search_offers`	Offer-first search with query, category, brand, price and sort filters
`cf_search_facets`	Available filters for a given search query
`cf_render_search_results`	Render a canonical search response for MCP clients that support components
`cf_list_products`	Paginated product list
`cf_get_product`	Product details and a comparison of available offers
`cf_list_offers`	Filtered list of offers
`cf_price_summary`	Min, max and average price across retailers
`cf_price_history`	Price history for up to 365 days, when records are available
`cf_deal_analysis`	Deal score, price trend and a buy recommendation
`cf_list_categories`	Category list
`cf_search_categories`	Category search by name
`cf_category_hierarchy`	Full category tree
`cf_list_retailers`	Retailer list
`cf_get_retailer`	Retailer details
`cf_list_reviews`	Retailer reviews
`cf_list_comments`	Comments on a product, offer or retailer

Personal tools

Require an authorized session (OAuth or API key).

Tool	What it does
`cf_list_wishes`	List your wishlist
`cf_add_wish`	Add an item to the wishlist
`cf_remove_wish`	Remove an item from the wishlist
`cf_search_history`	Your search history
`cf_popular_searches`	Popular search queries
`cf_create_comment`	Post a comment

Access and privacy

The MCP server never stores your credentials. Authorization goes through the same login as the website.

Without signing in the agent only sees public catalogue data — prices, products, categories and retailers.
Personal tools need an authorized session — either OAuth, which you approve in the CenuFiltrs login form, or an API key you set up yourself.
The agent acts strictly within your own account: it cannot see other users' wishlists, alerts or history.

Don't have an account yet?

Create one to unlock wishlist, price alerts and search history in your agent.