# Get your AI product listed on Hokai

> Hokai (https://hokai.io) is an editor-curated directory of AI tools, models, agents, skills (MCP servers, plugins, connectors), AI infrastructure services and AI companies. Buyers describe what they need to Smart Match, which answers with three ranked picks drawn only from listed products. Listing is open to any AI product. Rankings are never for sale.

## Price
- $25 one-time. Nothing renews, no subscription, no contract.
- Free alternative: place the "Listed on Hokai" badge on your own site (see below).
- Every submission is reviewed by a person. Refunds are not automatic: if the product turns out not to fit, ask us at damien@hokai.io and a person answers.
- Paying never changes a ranking. Smart Match ranks on fit with the buyer's brief only.

## What a listing includes
- Eligibility for Smart Match, where most buyers arrive
- A researched brief written by our team: capabilities, pricing, integrations, limits
- A permanent page on hokai.io, indexed and schema-structured, that links to your site
- Readable by ChatGPT, Perplexity, Claude and AI Overviews
- A free vendor account: 30 days of visits and clicks, the pages that mention you, and changes done within 14 days
- Reviewed against your site when you tell us something moved

## The free route: the badge
- Put the badge on a page of your own site, inside a normal link to hokai.io (no nofollow). Once your page is live, point the link at it
- Tell us the page; we check it the moment you submit
- We re-check weekly. Missing for 7 days after a warning, and the listing is removed
- Put it back any time and press Check again: the page is restored
- Badge image: https://hokai.io/badges/listed-on-hokai.svg

## What can be listed
- AI tools and apps
- AI agents (autonomous or assisted)
- Skills: MCP servers, plugins, connectors, function-calling tools
- AI models (frontier, open-weights, specialty)
- AI infrastructure and hosting services
- AI companies and labs

## How to submit
1. Web form: https://hokai.io/for-vendors#get-listed (tool URL and a work email; no account).
2. HTTP, for agents: `POST https://hokai.io/api/agent/listing` (see "For AI agents" below). The older `POST https://hokai.io/api/listing/checkout` with JSON `{"tool_url": "...", "email": "...", "company": "...", "note": "..."}` returns `{"url": "..."}`, a card payment page a person completes. For the free badge route, `POST https://hokai.io/api/listing/badge` with the same fields plus `badge_page_url`.
3. MCP: the Hokai MCP server at https://hokai.io/mcp exposes `submit_listing` and `buy_listing` (same fields), which return the payment link.
4. Email: info@hokai.io with the product URL.

## What happens next
- A person researches the product from its own site and writes the page: capabilities, pricing, integrations, limits.
- The page usually goes live within a few business days. We email the link when it does.
- Your listing comes with a free Listed vendor account. We email a link to open it when the payment clears; after that you can sign in with an emailed link or a password. It shows 30 days of visits and outbound clicks, the pages that mention you, and takes page changes (done within 14 days).
- Premium is $50 a year, optional, and included when you buy leads: the Verified maker tick, reader contact requests, full history, Google and AI-assistant numbers, Smart Match shortlists and 24-hour turnaround. Factual corrections by email are always free.
- Want your product in a guide on its merits? Use "Suggest us for a guide" in the dashboard. An editor decides; an editorial pick is never paid for and never guaranteed.
- If your site publishes a `/pricing.md` or `/llms.txt`, we read it first when researching and re-checking your page, then confirm it against your live pricing page.

## Leads
Smart Match buyers can consent to hear from vendors. Their brief (problem, budget, timeline in their own words) is sold as a lead, at most three vendors per lead.
- $25 per lead for 1 to 9, $15 for 10 to 49, $10 for 50 to 100, paid once, no subscription. No account needed first.
- Leads are delivered as buyers who fit come in. There is no stock cap: the balance never expires and one lead is used each time you open a buyer's brief.
- Every purchase includes a year of Premium.
- Buy: https://hokai.io/for-vendors#leads

## Guide spots
- A labelled Sponsored entry in one Hokai guide for 12 months: one payment, nothing renews. Each guide has its own price, $150, $250 or $450, set by how widely the guide is read.
- 2 paid spots per guide at most; every other pick in the guide is the editors' own. Paying never changes a pick or a ranking.
- Guide spots are pay first. The entry is written by hand and goes live within 48 hours of payment, or on the start date if that is later. If the guide does not suit the product, we move the spot to a guide that does.
- Book any free window up to 12 months ahead; the first payment wins. No account needed first.
- Each guide shows one number, its expected reach for the next 12 months: how many times we expect it to be loaded by people, search engines and AI assistants. It is a projection, not a promise.
- Every guide open for booking, with its calendar: https://hokai.io/for-vendors/guides. Machine-readable: `GET https://hokai.io/api/agent/catalog` (never who holds a spot).
- To change or cancel a booking, ask us: info@hokai.io.

## For AI agents
An agent can buy any of the three products for a vendor. No account, no API key.
1. `GET https://hokai.io/api/agent/catalog`: the three products, live prices, limits and the guides open for booking, as JSON.
2. `POST https://hokai.io/api/agent/listing` with `{"tool_url": "...", "email": "..."}`, `POST https://hokai.io/api/agent/guide-spot` with `{"email": "...", "guide": "<slug>", "product": {"type": "tools", "slug": "<hokai slug>"}}` (or `"product": {"name": "...", "url": "https://..."}`), or `POST https://hokai.io/api/agent/leads` with `{"email": "...", "quantity": 5}`.
3. Each answers with `checkout_url`, a Stripe card payment page. A person, or an agent that can pay, completes it. On payment the vendor account for that email is created and a sign-in link is mailed to it.
4. `GET https://hokai.io/api/agent/order?session_id=cs_...` says whether it was paid.
- OpenAPI: https://hokai.io/api/agent/openapi.json. The same four are MCP tools at https://hokai.io/mcp: `vendor_catalog`, `buy_listing`, `buy_guide_spot`, `buy_leads`.
- Guide spots are pay first. The entry is written by hand and goes live within 48 hours of payment, or on the start date if that is later. If the guide does not suit the product, we move the spot to a guide that does.
- Refunds are not automatic. Ask us at damien@hokai.io and a person answers.
- Limits: a handful of started checkouts per email and per address a day, 3 free badge listings per email or badge page a day, and two unpaid guide-spot holds at a time (a hold lasts 30 minutes).

## Links
- Vendor page (Get listed, Guide spots, Leads): https://hokai.io/for-vendors
- Editorial policy and how we rank: https://hokai.io/about
- Directory index for AI crawlers: https://hokai.io/llms.txt
