---
title: "pjespjes.com Developer Portal — API, OpenAPI, MCP & CLI"
description: "Use the same Kosovo PC catalog that powers the site through stable JSON, OpenAPI, MCP, Markdown, and CLI interfaces. Start with the free read-only sandbox, t…"
canonical: "https://pjespjes.com/en/developers"
image: "https://pjespjes.com/opengraph-image"
---

# pjespjes.com Developer Portal — API, OpenAPI, MCP & CLI

// Developer portal

Use the same Kosovo PC catalog that powers the site through stable JSON, OpenAPI, MCP, Markdown, and CLI interfaces. Start with the free read-only sandbox, then request higher limits when your integration is ready.

> Sandbox

GET /agent-api/v1/search_

The anonymous search endpoint is the production-safe sandbox: it never changes catalog data, builds, or retailer accounts. It returns structured errors and RateLimit headers so an integration can exercise retry behavior before requesting credentials.

// Credentials

## Start without a key.

The public agent API and sandbox support anonymous read-only calls. For higher limits, request an operator-issued bearer key or an OAuth 2.0 client-credentials pair through the contact page. Credentials are never returned in a URL or page.

Request credentials

// Quickstart

## One request to a cited result.

Search with a natural-language query, sort by price when needed, and use the returned canonical URL for citations. Prices and stock are snapshots; verify the retailer before purchase.

```
curl "https://pjespjes.com/agent-api/v1/search?q=ryzen%205%207600%20in%20Kosovo&sort=price_asc"
```

// OAuth 2.0

## Machine-to-machine authentication.

The authorization server supports the client-credentials grant for the catalog.read scope. Discover the metadata first, then exchange a provisioned client id and secret for a short-lived Bearer token.

OAuth authorization-server metadata

```
curl -u "$OAUTH_CLIENT_ID:$OAUTH_CLIENT_SECRET" \
  -X POST "https://pjespjes.com/oauth/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data "grant_type=client_credentials&scope=catalog.read"
```

// Sandbox

## Test against a read-only surface.

The anonymous search endpoint is the production-safe sandbox: it never changes catalog data, builds, or retailer accounts. It returns structured errors and RateLimit headers so an integration can exercise retry behavior before requesting credentials.

Run the sandbox search

// Install the CLI

npm install -g @pjespjes/cli

The public API is read-only. It does not place orders, process payments, or guarantee retailer stock.

// Machine-readable resources

## Everything an agent needs to connect.

API directoryOpenAPI contractAuthentication guideOAuth authorization-server metadataStreamable HTTP MCPMCP server cardOfficial npm CLIJavaScript SDK sourcePython SDK sourceAgent SkillsARD catalogAPI catalogSandboxBatch APIAgent plugin manifestAgent rulesRepositoryllms.txtVersioning and deprecation policyContact the operatorEverything an agent needs to connect. — /agents

```json
[{"@context":"https://schema.org","@type":"Organization","@id":"https://tatbloxe.com/#organization","name":"TAT & BLOXE SH.P.K","legalName":"TAT & BLOXE SH.P.K","alternateName":["TAT & BLOXE","pjespjes.com","pjespjes"],"url":"https://tatbloxe.com","sameAs":["https://tatbloxe.com","https://pjespjes.com","https://github.com/AltinKukaj/HARDWAREEXPERT"],"areaServed":{"@type":"Country","name":"Kosovo"}},{"@context":"https://schema.org","@type":["Organization","LocalBusiness"],"@id":"https://pjespjes.com/#organization","name":"pjespjes.com","alternateName":"pjespjes","url":"https://pjespjes.com","logo":"https://pjespjes.com/brand/pj-mark.png","sameAs":["https://github.com/AltinKukaj/HARDWAREEXPERT","https://tatbloxe.com"],"description":"Kosovo PC builder with local store prices, grouped parts, and compatibility checks.","parentOrganization":{"@id":"https://tatbloxe.com/#organization"},"publisher":{"@id":"https://tatbloxe.com/#organization"},"areaServed":{"@type":"Country","name":"Kosovo"},"knowsAbout":["PC components","PC building","hardware compatibility","PC parts price comparison","Kosovo computer stores"],"telephone":"+38349808030","email":"contact@pjespjes.com","address":{"@type":"PostalAddress","streetAddress":"De Rada","addressLocality":"Prizren","addressCountry":"XK"},"contactPoint":{"@type":"ContactPoint","telephone":"+38349808030","email":"contact@pjespjes.com","contactType":"customer support","areaServed":"Kosovo","availableLanguage":["sq","en"]}},{"@context":"https://schema.org","@type":"WebSite","name":"pjespjes.com","alternateName":"pjespjes","url":"https://pjespjes.com/en","sameAs":["https://github.com/AltinKukaj/HARDWAREEXPERT","https://tatbloxe.com"],"description":"Compare PC part prices across Kosovo stores, check compatibility, and build. The local PCPartPicker alternative — grouped specs, history, and alerts.","inLanguage":"en-US","publisher":{"@id":"https://tatbloxe.com/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://pjespjes.com/en/parts/cpu?q={search_term_string}"},"query-input":"required name=search_term_string"}},{"@context":"https://schema.org","@type":"Service","@id":"https://pjespjes.com/#service","name":"pjespjes.com PC parts comparison and build planning","serviceType":"PC parts price comparison and compatibility planning","url":"https://pjespjes.com/en","description":"Compare PC part prices across Kosovo stores, check compatibility, and build. The local PCPartPicker alternative — grouped specs, history, and alerts.","provider":{"@id":"https://pjespjes.com/#organization"},"areaServed":{"@type":"Country","name":"Kosovo"},"audience":{"@type":"Audience","audienceType":"PC builders and hardware shoppers in Kosovo"},"availableChannel":{"@type":"ServiceChannel","serviceUrl":"https://pjespjes.com/agent-api/v1","serviceType":"Read-only catalog API"}}]
{"@context":"https://schema.org","@type":"TechArticle","headline":"pjespjes.com Developer Portal — API, OpenAPI, MCP & CLI","description":"Use the same Kosovo PC catalog that powers the site through stable JSON, OpenAPI, MCP, Markdown, and CLI interfaces. Start with the free read-only sandbox, then request higher limits when your integration is ready.","url":"https://pjespjes.com/en/developers","inLanguage":"en-US","isPartOf":{"@type":"WebSite","name":"pjespjes.com","url":"https://pjespjes.com"},"about":["pjespjes.com API","OpenAPI","OAuth 2.0","MCP","CLI"]}
```