Developer Hub

MCP Connector (Model Context Protocol)

The Index is callable as tools, not only fetchable as pages. The connector speaks MCP revision 2025-11-25 over a remote Streamable HTTP endpoint at https://www.vizoryo.com/mcp/v1, and every caller authenticates: an unauthenticated request is answered with 401 and the OAuth metadata an MCP client needs to run the sign-in itself. A free Vizoryo account is the whole entry price — no plan, and nothing to copy or paste. The tools stay READ-ONLY and wrap the public REST endpoints documented below, which stay open to every agent, signed up or not.

  • search_businesses — Find businesses in the Index by name, category, or city; returns ranked matches, each with a stable slug.
  • get_business_profile — Fetch one complete AI Identity by slug: identity, classification, services, location, contact, hours, Schema.org JSON-LD, the stable VizoryoProfileID, and per-field provenance.
  • cite_business — Fetch the citation contract for a business: a ready-to-use citation string, the stable VizoryoProfileID, the canonical URL, the record status, and per-field provenance.
  • resolve_business_by_url — Map business website URLs to their Index entries, up to 50 per call; returns the Index slug for each URL that matches, and omits the URLs that have no entry. Follow up with get_business_profile or cite_business for the record itself.
  • browse_businesses — List businesses filtered by category, city, and/or country, paginated; ordered by how completely each record is structured for AI systems to read.

Full setup, the authenticated owner connector, and the machine-readable descriptor: https://www.vizoryo.com/he/mcp · https://www.vizoryo.com/api/index/mcp

Public REST API (no authentication required)

  • GET /api/index/browse?category={cat}&city={city}&limit=20&offset=0&sort=readability
  • GET /api/index/autocomplete?q={query}
  • GET /api/index/profile/{slug}
  • GET /api/index/profile/{slug}/cite — the citation contract + per-field provenance, under 2 KB
  • GET /api/index/profile/{slug}/related
  • GET /api/index/profile/{slug}/branches
  • GET /api/index/sectors
  • GET /api/index/sector/{sector_slug}
  • GET /api/index/categories
  • GET /api/index/cities
  • GET /api/index/industry-groups
  • GET /api/index/stats
  • GET /api/index/slugs?urls={comma-separated}
  • GET /api/index/enrichment?urls={comma-separated}
  • GET /api/index/leaderboard?category={cat}&city={city}

Machine-Readable Manifests

  • /llms.txt — Top-level manifest for AI models
  • /llms-full.txt — Full index manifest
  • /llms/sector/{slug}.txt — Per-sector manifest (the middle tier: a sector's industries)
  • /llms/category/{slug}.txt — Per-category manifest
  • /llms/city/{slug}.txt — Per-city manifest

Specifications & Discovery

See also: About Vizoryo · browse the AI business index · What is an AI index?