// Agent access
Let agents find the right part in Kosovo.
pjespjes.com publishes a read-only product catalog for ChatGPT, Claude, Gemini, Perplexity, and other agent hosts. Search current Kosovo offers, compare products, and cite the canonical page.
// Natural-language search
> ryzen 5 7600 in Kosovo_
Ask for a model, a category, or the cheapest current in-stock offer. English and Albanian price intent are supported.
// Public surfaces
One catalog. Three ways to connect.
Use the interface your agent host supports. Anonymous access is available; optional operator-issued bearer keys provide higher limits.
REST API
Stable JSON for search, product detail, current offers, and comparison. The default market is Kosovo and the default currency is EUR.
https://pjespjes.com/agent-api/v1Open>OpenAPI
Import the documented read-only operations into GPT Actions or another OpenAPI-compatible agent host.
https://pjespjes.com/agent-api/v1/openapi.jsonOpen>Streamable HTTP MCP
Connect compatible research clients to read-only search, product, offers, comparison, and citation-fetch tools.
https://pjespjes.com/mcpOpen>AI catalog feed
Crawlable JSON index and shards with release IDs, prices, availability, retailer links, and timestamps. The feed is not the canonical product page.
https://pjespjes.com/ai/catalogOpen>Feed schema
Use the release metadata to identify the catalog snapshot. Treat entries as discovery records and cite the canonical product or offer URL rather than replacing it with a feed shard.
schemaVersion · generatedAt · releaseId · chunk · chunkCount · entries[].url · entries[].title · entries[].category · entries[].brand · entries[].model · entries[].price · entries[].currency · entries[].availability · entries[].retailerUrls · entries[].lastModified// WebMCP shared workspace
Search together. Build together.
Open the dedicated agent builder in a WebMCP-capable browser and work with the page agent in the same tab. Ask it to search, compare, inspect curated builds, show evidence, update your approved choices in the shared build, and check compatibility.
Open the agent builder>// Page tools
search · inspect · compare · curated builds · shared build · compatibility · add · remove · clear · navigate
> Find an in-stock Ryzen 5 7600, a 32 GB DDR5 kit, and a compatible AM5 motherboard. Show me the options first. After I approve, add my selected products to the shared build and check compatibility._
// Try the REST search
Try the REST search
This request returns matching products, current prices, store scope, freshness, and canonical Pjespjes URLs.
curl "https://pjespjes.com/agent-api/v1/search?q=ryzen%205%207600%20in%20Kosovo&sort=price_asc"// Response
{
"schemaVersion": 1,
"query": {
"originalQuery": "ryzen 5 7600 in Kosovo",
"normalizedQuery": "ryzen 5 7600",
"category": "CPU",
"sort": "relevance",
"inStockOnly": true
},
"catalog": {
"releaseId": "5079cbaf-6afd-4537-8399-84bb1be5377d",
"generatedAt": "2026-08-19T08:00:00.000Z",
"country": "XK",
"market": "Kosovo",
"currency": "EUR",
"participatingStoreCount": 14,
"participatingStores": [{ "id": "gjirafa50", "name": "Gjirafa50" }],
"coverageNote": "Prices are compared across participating Kosovo stores tracked by pjespjes.com; this is not a complete inventory of every retailer in Kosovo.",
"freshnessNote": "Prices and availability come from the latest published catalog release. Verify the retailer page before purchasing."
},
"results": [
{
"id": 12345,
"name": "AMD Ryzen 5 7600",
"category": "CPU",
"categorySlug": "cpu",
"brand": "AMD",
"model": "7600",
"price": 189.9,
"currency": "EUR",
"availability": "in_stock",
"inStock": true,
"dataConfidence": "confirmed",
"dataWarning": null,
"pjespjesUrl": "https://pjespjes.com/sq/parts/12345",
"englishUrl": "https://pjespjes.com/en/parts/12345",
"retailerUrl": "https://www.gjirafa50.com/...",
"offers": [
{
"id": 9001,
"store": "gjirafa50",
"storeName": "Gjirafa50",
"price": 189.9,
"currency": "EUR",
"availability": "in_stock",
"retailerUrl": "https://www.gjirafa50.com/...",
"pjespjesUrl": "https://pjespjes.com/sq/parts/offers/gjirafa50/9001",
"englishUrl": "https://pjespjes.com/en/parts/offers/gjirafa50/9001",
"lastUpdated": "2026-08-18T22:19:38.897Z"
}
],
"lastUpdated": "2026-08-18T22:19:38.897Z"
}
],
"totalMatches": 4,
"returned": 4,
"truncated": false,
"nextCursor": null,
"hasMore": false
}catalog.degraded: true (releaseId starting with "filesystem:") means the API is serving the container fallback — prices may be stale. A 503 with error.code "catalog_unavailable" means the published catalog is temporarily unavailable: retry after the Retry-After header. Every response echoes the query you sent (query.originalQuery) with a fresh generatedAt and X-Request-Id header — if the echo doesn't match your query or the identifier is stale, an intermediate cache replayed a previous response: retry once. Cheapest means cheapest among participating stores, not every Kosovo retailer.
OpenAPI / GPT Actions
Import the documented read-only operations into GPT Actions or another OpenAPI-compatible agent host.
https://pjespjes.com/agent-api/v1/openapi.jsonMCP configuration
Connect compatible research clients to read-only search, product, offers, comparison, and citation-fetch tools.
{
"mcpServers": {
"pjespjes": { "url": "https://pjespjes.com/mcp" }
}
}// Platform notes
Discovery depends on the host.
Consumer chat products may discover pjespjes.com through search. Direct REST or MCP use depends on the platform, connector, or user-configured agent capabilities.
ChatGPT
SearchBot/User crawling can discover public pages. For direct calls, import the OpenAPI document as a GPT Action or use a compatible MCP client.
Claude
Public pages can be discovered by SearchBot/User crawling. Use the remote MCP connector when your Claude environment supports it.
Gemini
Use URL Context for public pages, function calling with the OpenAPI document, or Streamable HTTP MCP in a compatible host.
Perplexity
SearchBot/User crawling can surface canonical pages. A configured agent can call the REST API for structured prices and offers.
DeepSeek
Use the REST API or MCP through an agent host that supports OpenAI-compatible tool calling.
Grok
Use the remote MCP endpoint over Streamable HTTP when your Grok environment or connector supports it.
Manus
Add the MCP endpoint as a custom connector, or call the REST/OpenAPI surface from a configured agent workflow.
Other agents
Use standard HTTPS REST/OpenAPI or stateless Streamable HTTP MCP. Always preserve and cite the returned canonical Pjespjes URL.
// Usage rules
Current data, honest scope.
Participating stores
Cheapest means cheapest among the stores covered by pjespjes.com in the latest published catalog release, not every Kosovo retailer.
Freshness
Prices and stock can change after a catalog release. Use the returned timestamp, then verify the retailer page before purchase.
Canonical citations
Use the product or offer URL returned by the API, MCP tool, or feed. Retailer URLs are included for the final store check.
Read-only by design
The REST, OpenAPI, MCP, and feed surfaces are read-only. WebMCP page tools only change the local shared build after the user asks.
// Machine-readable links
The public agent catalog helps assistants answer local hardware questions without pretending to cover every retailer or guarantee live stock.