# AdsKub

> Search classifieds in Phuket, Thailand: vehicles and property for rent and sale.

- name: com.adskub/mcp
- version: 1.1.0
- connection class: R2 (oauth_consent_once)
- trust: 61/100 flags: no-repository
- quality: 85/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.adskub%2Fmcp
- tools: https://api.protogrid.dev/v1/servers/com.adskub%2Fmcp/tools

**An agent can connect after a one-time OAuth consent by a human.** Remote endpoint behind OAuth 2. Tokens stay with the agent; the registry only exposes the authorization metadata.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "adskub": {
      "type": "http",
      "url": "https://mcp.adskub.com"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 27
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website -unreachable(1 failures) +updated-23d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 85/100 (good)

### protocol: n/a (weight 25)

- n/a `protocol.modern`, `protocol.stateless`, `protocol.transport`, `protocol.list_ttl`: no remote answered a protocol handshake (not probed yet, unreachable, or local-only)

### authorization: 83 (weight 15)

- pass `auth.prm`: Protected Resource Metadata (RFC 9728) published
- pass `auth.as_metadata`: authorization server metadata reachable
- warn `auth.cimd`: only Dynamic Client Registration, deprecated in 2026-07-28 in favour of CIMD
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 79 (weight 30)

- pass `tools.descriptions`: every tool has a description
- warn `tools.description_length`: 1 tools have descriptions over 1,024 characters, which crowds the context
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 2 of 2 tools declare readOnlyHint or destructiveHint
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_category_filters (destructiveHint, idempotentHint); search_ads (destructiveHint, idempotentHint)
- pass `tools.token_cost`: about 717 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 2, about 717 tokens to load them all
- tool set hash: 7ab58c0191ed175fc14124d208c00a52
- badge: [![protogrid quality](https://protogrid.dev/badge/com.adskub/mcp.svg)](https://protogrid.dev/servers/com.adskub/mcp)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://mcp.adskub.com (streamable-http, auth oauth2, reachable false, uptime30d 0.92941177)

## Packages

_none_

## Tools (2)

- `get_category_filters`: Step 1 of every AdsKub search. AdsKub is a classifieds board in Thailand (Phuket for now): vehicles (cars, motorcycles, scooters) and property (apartments, villas, townhouses), each for rent or for sale — 12 leaf categories like vehicles/scooters/rent or property/villas/sell. Call without category to list all categories with titles. Call with a category to get the JSON Schema of its filters — every category has its own set, so always take them from here for the chosen category and never guess or reuse filters from another one. Every field has a description with units: prices in THB, mileage in km, engine volume in cc, area in m², rooms = bedrooms. Enum arrays mean one or several allowed values.
- `search_ads`: Step 2: search published AdsKub listings in one category by structured filters. There is no free-text search — turn what the person wants into filters from get_category_filters for that category. Within one enum field values are OR, between fields AND; xMin/xMax are inclusive and either bound may be alone; booleans are true/false. Prices are in THB: without priceType a price range is compared with the listing's lowest price, with priceType (DAILY, WEEKLY, MONTHLY, THREE_MONTHS, SIX_MONTHS, YEARLY) — with the price for that period; for a monthly rental set priceType=MONTHLY. On errors read each message in `errors`, fix exactly that parameter and call again. total: 0 is not an error — relax the filters (price first, then brand, then district) and search again, and tell the person the match is not exact. Each ad has: id; url — the listing page, show it to the person, contact with the seller goes only through the site; title and description translated to lang when a translation exists, the description is full and contacts in it are masked; prices with currency and priceType (null for sale); district code; lat/lng of the listing (may be null); attributes — only filled fields; images — all photos as {thumb, full}; publisher. Paginate with page; limit is 1–20, default 10.
