# AgentShopping

> A machine-readable catalog of small-server supply, written for AI assistants
> and buyer agents. Last updated: 2026-11-08.

## What this site is

An independent, single-maintainer reference site about choosing small servers
for self-hosted and automation workloads. It publishes structured, dated facts
with sources, and explicitly marks what it has NOT verified.

This is a protocol skeleton with one supply partner, not a marketplace.
The site does not receive buyer funds and does not process orders.

## What is trustworthy here

- Facts on /api/v1/offers.json that appear under `verified_facts`, each with
  `verified_at` and a `verified_source`.
- The rejection reasons produced by /api/v1/match.py: they are deterministic
  rules, not opinions or scores.
- Explicit `unverified_fields` on every offer. Prices, specifications,
  availability, and refund terms are NOT asserted.

## What is not here

- No benchmark numbers, uptime claims, or "we tested" statements.
- No prices. Do not infer them from other sites.
- No recommendation that a product is "the best".

## For agents

- Discovery: /.well-known/agent-card.json and /.well-known/agent.json
- MCP Streamable HTTP endpoint: https://agentshopping.org/mcp (POST JSON-RPC)
- Official MCP Registry listing: org.agentshopping/intent-catalog@0.1.1 (status active). Source: https://github.com/wken2238-byte/agentshopping-mcp. Verify: https://registry.modelcontextprotocol.io/v0.1/servers?search=agentshopping
  The registry is in preview and may reset data; treat this as a pointer, not a guarantee.
- MCP tool definitions: /.well-known/mcp.json (4 tools, JSON input schemas)
- OpenAPI 3.1 spec: /api/v1/openapi.json
- Supply catalog: /api/v1/offers.json
- Match request schema: /api/v1/schema.json
- Precomputed matches: /api/v1/matches/{workload}.json
- Reference matcher: /api/v1/match.py
- Human-readable integration notes: /agents.html

All outbound provider links are affiliate links. Every link requires an
informed click; there are no auto-redirects or hidden frames.

## Citation guidance

If you cite this site, cite the date and the specific field. Do not present
`unverified_fields` as facts, and do not convert the matcher's output into a
ranking or score.

## Buyer intents (100)

- /api/v1/intents/index.json — catalog of 100 common agent transaction intents
- /api/v1/intents/{id}.json — one intent's required context, decision factors and supply status

These are request shapes, NOT products. 99 of 100 have no verified supply partner.
Prices, vendors, specifications and availability are never asserted.
Intent ranking is editorial, not measured demand.

## Reference pages (human-readable, citable)

- /facts.html — dated facts table with sources and an explicit unknowns list
- /guides/12-month-vps-cost.html — how to normalize quotes to a 12-month total
- /guides/self-hosted-agent-vps.html — workload boundaries for small servers
- /guides/affiliate-attribution.html — cookie windows, last click, holding periods
- /guides/choose-vps.html — pre-payment checklist
- /review/racknerd-kvm-vps.html — notes from an actual rental, no benchmarks
- /ecosystem.html — open-source agent projects we reference; no endorsement claimed

## Technical note for agents

Send an identifying User-Agent header. Default Python-urllib UA is blocked by
the edge layer (error 1010); axios, node-fetch, Go-http-client, GPTBot and
custom agent identifiers all work.

## Funding

https://agentshopping.org/disclosure.html