# eno.vn Partner API

> Manage one storefront: listings, bulk catalogue sync, analytics and webhooks.

- name: vn.eno/partner-api
- version: 1.0.1
- connection class: R1 (autonomous)
- trust: 83/100 flags: no-repository
- quality: 89/100 (new)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/vn.eno%2Fpartner-api
- tools: https://api.protogrid.dev/v1/servers/vn.eno%2Fpartner-api/tools

**An agent can connect on its own if it already holds `api_key`.** Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "partner-api": {
      "type": "http",
      "url": "https://eno.vn/api/mcp",
      "headers": {
        "Authorization": "Bearer ${api_key}"
      }
    }
  }
}
```

Placeholders to fill: `${api_key}`.

## Trust

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

## Quality 89/100 (new)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

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

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 15 of 15 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 4,808 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump
- pass `tools.hidden_text`: no hidden text in tool names, descriptions, schemas or annotations

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

- n/a `stability.changes`, `stability.rug_pull`, `stability.new_links`: tool history recorded for 2 of the 7 days needed

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

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

- tools: 15, about 4,808 tokens to load them all
- tool set hash: f9935655f3188ef86b51f4e492c69b67
- tools last changed: 2026-11-14T06:14:49.619Z
- badge: [![protogrid quality](https://protogrid.dev/badge/vn.eno/partner-api.svg)](https://protogrid.dev/servers/vn.eno/partner-api)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-11-14 `delete_webhook` changed (outputSchema)
- 2026-11-14 `register_webhook` changed (inputSchema, outputSchema)
- 2026-11-14 `list_webhooks` changed (outputSchema)
- 2026-11-14 `analytics_listings` changed (inputSchema, outputSchema)
- 2026-11-14 `analytics_summary` changed (outputSchema)
- 2026-11-14 `sync_catalogue` changed (inputSchema, outputSchema)
- 2026-11-14 `bulk_create_listings` changed (inputSchema, outputSchema)
- 2026-11-14 `delete_listing` changed (inputSchema, outputSchema)
- 2026-11-14 `set_listing_status` changed (inputSchema, outputSchema)
- 2026-11-14 `update_listing` changed (outputSchema)

Full history: https://api.protogrid.dev/v1/servers/vn.eno%2Fpartner-api/changes

## Remotes

- https://eno.vn/api/mcp (streamable-http, auth api_key ${api_key}, reachable true, uptime30d 1)

## Packages

_none_

## Tools (15)

- `analytics_listings`: Read views and leads (times a buyer opened contact) per listing per day over a date range, the last 30 days unless you choose one, with each listing's all-time totals. Answers a page of listings at a time with `next_cursor` for the next. Use analytics_summary for the shop's overall totals. Changes nothing.
- `analytics_summary`: Read this shop's totals in one call: how many listings it has, how many are active, sold or hidden, how many still wait for eno's check, and the total views and leads (times a buyer opened contact) across all of them. For per-listing, per-day figures use analytics_listings. Changes nothing.
- `bulk_create_listings`: Post up to 200 new listings in one call, one row each (category, title, price in VND, optional text and photos as public image URLs). Rows are independent: a bad row fails alone and the others are created. Returns how many were created and failed, and a result per row with the new id or the reason it failed. To keep eno matched to your own system by your own ids, use sync_catalogue instead.
- `create_listing`: Post one new listing for this shop: a category, a title and a price in VND (a job gives its monthly salary in `salaryM` instead), with optional text, location, condition and photos as public image URLs that eno copies to its own storage (the first 8 are used). Longer text is cut to fit: title 140 characters, description 5,000, district 80, condition 60. The listing goes live at once unless eno must check it first (`verified: false` in the result). Refused with a reason, and nothing created, when the text holds a phone number, the category is unknown or the account may not post right now. Returns the new listing's `id` (for update_listing and set_listing_status), `verified` (true when it is already public) and `held` (true while it waits for eno's licence check). Use it for a listing the seller has asked to post.
- `delete_listing`: Permanently delete one of this shop's listings; it cannot be undone (use set_listing_status hidden to take it down instead). While the shop or the listing is under investigation (an open report, or the account is held or suspended) it is hidden instead of deleted: the result then says `deleted: false, hidden: true` and why.
- `delete_webhook`: Remove one of this shop's webhook endpoints; eno stops sending it events at once. It cannot be undone: registering the address again gives a new id and a new secret.
- `get_listing`: Read one of this shop's listings by id, in any status, with all its fields: title, text, price, status, category, location, photos, views and leads. Use it to see the current values before update_listing. Fails with `not_found` when the id is not one of this shop's listings. Changes nothing.
- `get_shop`: Read the storefront this connection acts for: its id, name, bio, location, phone, logo, trust score and tier, response rate, member-since date and how many listings are live now. Use it to confirm which shop this connection acts for. Changes nothing.
- `list_listings`: List this shop's own listings, newest first, in every status unless you ask for one: active (on sale), sold or hidden. Each page returns the listings with price, status, category and photos, plus `next_cursor` to fetch the next page. Use get_listing to read one listing by id. Changes nothing.
- `list_webhooks`: List the webhook endpoints registered for this shop: where events are sent, which events, whether delivery is on, and recent failures. Signing secrets are never returned. Changes nothing.
- `register_webhook`: Register an HTTPS endpoint of yours that eno will POST signed events to when this shop's listings are created, updated, change status or are deleted. Returns the webhook with its signing secret, shown only this once: store it to verify each event's signature. A shop can have up to 10 webhooks.
- `set_listing_status`: Put one of this shop's listings on sale (active), mark it sold, or hide it from the site without deleting it. Use sold when the item is gone and hidden to take it down for now; either can be undone by setting active again. Re-activating is refused with a reason when the account is held or suspended, or with `licence_check_required` while the listing waits for eno's licence check. Returns the status the listing now has.
- `sync_catalogue`: Make this shop's listings match your own catalogue, matched by your externalId: a new externalId creates a listing, a known one updates it in place, and a row's status can mark it sold or hidden. In mode "full", every active listing whose externalId is missing from this payload is also hidden (listings without an externalId, such as ones posted on the website, are never touched). Up to 200 rows per call. Returns counts of created, updated, retired and failed rows and a result per row; when the account may not publish new listings, new rows are refused while edits still apply, and `publish_blocked` says why.
- `update_listing`: Change one of this shop's listings: only the fields you send change. Photos you send replace the current set (public URLs are copied to eno's storage; the first 8 are used), and text is cut to the same lengths as create_listing. A job's pay is `salaryM`; a `price` sent for a job is read as its monthly salary in VND. An edit of a listing waiting for eno's licence check is saved with the listing kept unpublished until eno approves it (the result says `held: true`); this tool cannot change a subcategory or the licence values.
- `update_shop`: Change this shop's profile: the name, bio, location and logo buyers see on its page, and the contact phone eno shares with a buyer inside its chat. Send only the fields to change; the others stay as they are (get_shop shows the current values). Long text is shortened to fit: name 120 characters, bio 1,000, location 120; a name needs at least 2. A phone number another shop already uses is refused with `phone_taken`. Returns `ok: true` once the change is saved.