# Vortex

> Which stores can actually ship to your destination, at what real landed cost.

- name: dev.rohnelt.vortex/vortex
- version: 0.1.0
- connection class: unknown (unknown)
- trust: 50/100 flags: no-repository, unreachable
- quality: 85/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/dev.rohnelt.vortex%2Fvortex
- tools: https://api.protogrid.dev/v1/servers/dev.rohnelt.vortex%2Fvortex/tools

**Not classified yet.** The remote endpoints have not been probed successfully, or the listing has nothing to connect to.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "vortex": {
      "type": "http",
      "url": "https://vortex.rohnelt.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${VORTEX_TOKEN}"
      }
    }
  }
}
```

Placeholders to fill: `${VORTEX_TOKEN}`.

## Trust

- hygiene: 80
- liveness: 0
- freshness: 85
- provenance: 55
- drivers: +dns-namespace +website -unreachable(8 failures) ~updated-56d-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: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 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: 86 (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`: 8 of 10 tools declare readOnlyHint or destructiveHint
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: identity_create (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); feasibility (destructiveHint, idempotentHint); landed (destructiveHint, idempotentHint); …
- pass `tools.token_cost`: about 2,230 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: 10, about 2,230 tokens to load them all
- tool set hash: 013bbdb8f016957f080eb2a331d41b12
- badge: [![protogrid quality](https://protogrid.dev/badge/dev.rohnelt.vortex/vortex.svg)](https://protogrid.dev/servers/dev.rohnelt.vortex/vortex)
- 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://vortex.rohnelt.dev/mcp (streamable-http, auth none, reachable false, uptime30d 0.86206895)

## Packages

_none_

## Tools (10)

- `capabilities`: Return the full machine-readable manifest of Vortex: every operation, its price in USD, its input schema and how to pay. Free.

When to use: Call this first if you have never used Vortex and want to know what it can do and what it costs.

Price: Free.
- `credit_deposit`: Buy Vortex credit with USDC on Base over x402. One on-chain settlement, then every call is debited off-chain.

When to use: Call when your balance is low. Operations cost fractions of a cent, so a single deposit covers hundreds of them.

Price: Free.
- `feasibility`: Everything Vortex knows about whether one storefront can serve one destination: its published shipping zones, the currency it charges in, the cards it takes, what buyers reported, and whether its reach changed recently. Returns a verdict, not just data.

When to use: Call this when you already have a store in mind and are about to spend real money. Answers reaches, cannot_reach or unknown, and says which of the three it is rather than guessing.

Price: US$0.002000 per call.
- `find`: Search real storefronts for a product and get back only the ones that can ship to your destination, with live price and stock. Every other product index answers what matches the words; this one answers what matches the words and can be delivered.

When to use: Call this before shopping anywhere else. Most storefronts serve one country: a search that ignores reach will hand you results your buyer can never receive, and you find out at checkout after the work is done.

Price: US$0.005000 per call.
- `history`: The recorded price and stock series for a product, where today sits against its own record, how often it has gone out of stock, and every change to where its store ships.

When to use: Call this when you have a candidate and want to know whether to buy now or wait. Vortex says how many observations it actually has and withholds the percentile when the series is too short to mean anything.

Price: US$0.002000 per call.
- `identity_create`: Turn a wallet address into a permanent Vortex identity and an API token. Free, and grants a small trial credit. No signup, no email, no human.

When to use: Call this once, before anything else. You need the returned token for every other call.

Price: Free.
- `landed`: Item plus shipping plus import tax plus local tax, itemised, for a destination — and the name and effective date of the tax rule applied. A US$120 item into Brazil lands near US$220; the shelf price is not the number to budget against.

When to use: Call this before committing to a cross-border purchase, and before comparing two stores in different countries. If Vortex has no rule on file for the destination it says so instead of returning a confident guess.

Price: US$0.003000 per call.
- `report`: Tell Vortex how a purchase actually went. Free, and checked against the merchant's own feed before it counts — a claim the store contradicts is stored and marked contradicted rather than believed.

When to use: Call this after any purchase attempt, good or bad. It is free, it makes every later answer better, and reporting the freight you were quoted is the one number Vortex cannot collect for itself.

Price: Free.
- `watch`: Register standing interest in a product or a store: a price drop below your threshold, a return to stock, or a store that stops shipping to your destination.

When to use: Call this instead of polling find on a schedule. One watch costs less than two searches and catches the change at the moment it happens.

Price: US$0.005000 per call.
- `whoami`: Your handle, wallet, balance and usage. Free.

When to use: Call this to check your balance before a run, or to confirm your token still works.

Price: Free.
