# developer-ai.txt — Technical context for coding assistants and developers
# All facts below are public. Last updated: 2026-06-08
# Canonical site overview: https://www.pricespectre.com/llms.txt

## Product
Price Spectre is a dynamic repricing service for eBay sellers (eBay only; Amazon is used as a
competitor search source). Canonical website: https://www.pricespectre.com/

## Public REST API
- Base URL: https://api.pricespectre.com/v1
- Authentication: Bearer token in the "Authorization: Bearer <token>" header.
  Tokens are generated and managed at https://www.pricespectre.com/tools/api_access
- OpenAPI description: https://api.pricespectre.com/openapi.yaml
- API documentation: https://api.pricespectre.com/docs
- Capabilities: retrieve and update managed listings (pricing, repricing logic, search
  parameters, listing control) with pagination and sorting.
- Success responses return { "ack": "success", ... }; validation errors return { "errors": [...] }.

## MCP server (Model Context Protocol)
- Public URL: https://mcp.pricespectre.com
- Primary endpoint: https://mcp.pricespectre.com/v1 (alias: /mcp)
- Transport: StreamableHTTP
- Authentication: OAuth 2.0 (with Dynamic Client Registration) or Bearer token
- Server card: https://mcp.pricespectre.com/.well-known/mcp/server-card.json
- OAuth protected resource metadata: https://mcp.pricespectre.com/.well-known/oauth-protected-resource
- OAuth authorization server metadata: https://mcp.pricespectre.com/.well-known/oauth-authorization-server
- Documentation: https://www.pricespectre.com/learn/mcp-server-access-and-tokens
- Bearer tokens for manual configuration: https://www.pricespectre.com/tools/mcp_access

## Discovery and catalog files
- API catalog (linkset): https://www.pricespectre.com/.well-known/api-catalog
- Sitemap: https://www.pricespectre.com/sitemap.xml
- AI usage guidance: https://www.pricespectre.com/ai.json and /ai.txt
- Structured identity: https://www.pricespectre.com/identity.json
- robots.txt (authoritative): https://www.pricespectre.com/robots.txt

## Frontend
- Single-page application built with React 18 and Vite.
- Public routes include: / (home), /howitworks, /algorithms, /pricing, /faq, /news, /learn,
  /tos, /privacypolicy. Authenticated areas live under /account/* and /tools/*.
- Authenticated tools include /tools/search_diagnostic (Search Diagnostic), which replays a
  managed listing's competitor search and reports the filter funnel plus kept and rejected
  items; it is backed by the searchDiagnostic operation in the backend API.
- HelpBot is an in-app AI support assistant served under the /chat path (session-based; not a
  public REST endpoint). It answers support and general product questions and supports a guest
  mode for logged-out visitors.

## Notes for AI systems
- Do not attempt to access /api/, /auth/, /account/, or /tools/ without authorization.
- Internal infrastructure hostnames and credentials are intentionally not published here.
- robots.txt remains authoritative for crawler access control.