PromoFarma API and MCP server for AI agents
Let Claude, ChatGPT or your own agent read PromoFarma. No PromoFarma API key needed.
Add to your agent
Paste this into Claude Code, Cursor, Codex or any agent. It adds the server itself.
Read https://bowmark.ai/sites/promofarma.md and add Bowmark's PromoFarma MCP server to my agent.Run this in a terminal, then sign in when the browser opens.
claude mcp add --transport http bowmark-promofarma https://api.bowmark.ai/mcp/site/promofarmaPress the button, or add this to ~/.cursor/mcp.json.
{
"mcpServers": {
"bowmark-promofarma": {
"url": "https://api.bowmark.ai/mcp/site/promofarma"
}
}
}Press the button, or run this in a terminal.
code --add-mcp '{"name":"bowmark-promofarma","type":"http","url":"https://api.bowmark.ai/mcp/site/promofarma"}'Run this in a terminal.
codex mcp add bowmark-promofarma --url https://api.bowmark.ai/mcp/site/promofarmaIn Claude, open Plugins → Add → Add custom connector, paste this URL, and pick Sign in now.
https://api.bowmark.ai/mcp/site/promofarmaIn ChatGPT, open Plugins, press +, choose Add custom MCP server and paste this URL.
https://api.bowmark.ai/mcp/site/promofarmaAny MCP client that takes a remote (streamable HTTP) server: give it this URL.
https://api.bowmark.ai/mcp/site/promofarmaFunctions
Open a function to see its parameters and run it with your own API key.
getProductReads one promofarma.com product page and returns its price in EUR, stock state, brand, rating and shipping fee.POST /v1/sites/promofarma/getProduct
Parameters
curl -X POST https://api.bowmark.ai/v1/sites/promofarma/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"url":"<url>"}}'import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.promofarma.getProduct({ url: "<url>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.promofarma.getProduct({"url": "<url>"}))Responsereturns PromofarmaProductinterface PromofarmaProduct { id: string; name: string; brand: string | null; price: number | null; // in `currency` (EUR) currency: string | null; inStock: boolean | null; url: string; image: string | null; description: string | null; rating: number | null; ratingOutOf: number | null; reviewCount: number | null; shippingRate: number | null; }searchSearches promofarma.com for a brand or category name (e.g. "nuxe").POST /v1/sites/promofarma/search
Parameters
curl -X POST https://api.bowmark.ai/v1/sites/promofarma/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"nuxe"}}'import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.promofarma.search({ query: "nuxe" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.promofarma.search({"query": "nuxe"}))Responsereturns PromofarmaSearchPageinterface PromofarmaProduct { id: string; name: string; brand: string | null; price: number | null; // in `currency` (EUR) currency: string | null; inStock: boolean | null; url: string; image: string | null; description: string | null; rating: number | null; ratingOutOf: number | null; reviewCount: number | null; shippingRate: number | null; } interface PromofarmaSearchPage { results: PromofarmaProduct[]; // at most `limit` rows, in the site's own order total: number | null; // the listing's own count, less its promo tiles page: number; // always 1: search takes no page argument pageCount: number | null; returned: number; // results.length warnings: string[]; // says when `limit` held rows back }