AI Agent Access

Give agents a clean path into Nexez.

Install the OpenClaw plugin or discovery skill, then search Nexez pages, fetch manifests, validate handoffs, and route buyer intent through structured public endpoints.

Install agent access Open agent index

agent-access.json

public discovery contract

{
  "schema_version": "nexez.agent-access.v1",
  "docs_url": "https://nexez.ai/agents",
  "runtime_base_url": "https://nexez.app",
  "openclaw": {
    "plugin": {
      "name": "@nexez/openclaw-nexez",
      "version": "0.2.0",
      "install": "openclaw plugins install clawhub:@nexez/openclaw-nexez"
    },
    "skill": {
      "slug": "nexez-agent-discovery",
      "version": "0.3.0",
      "install": "openclaw skills install nexez-agent-discovery"
    }
  },
  "sdks": {
    "typescript": {
      "name": "@nexez/agent-sdk",
      "version": "0.3.0",
      "status": "published",
      "install": "npm install @nexez/agent-sdk",
      "package": "https://www.npmjs.com/package/@nexez/agent-sdk",
      "source": "sdk/typescript"
    },
    "python": {
      "name": "nexez-agent-sdk",
      "module": "nexez_agent_sdk",
      "version": "0.3.0",
      "status": "published",
      "install": "python -m pip install nexez-agent-sdk",
      "package": "https://pypi.org/project/nexez-agent-sdk/",
      "source": "https://github.com/Flyger1an/nexez/tree/main/sdk/python"
    }
  },
  "examples": "https://github.com/Flyger1an/nexez/tree/main/examples/agents",
  "endpoints": {
    "search": "https://nexez.app/api/agent-search?q={query}",
    "index": "https://nexez.app/agent-pages.json",
    "llms": "https://nexez.app/llms.txt",
    "openapi": "https://nexez.app/openapi.json",
    "mcp": "https://nexez.app/.well-known/mcp.json"
  }
}

Install paths

Use tools, instructions, or both.

The plugin gives agents callable tools. The skill gives agents the discovery logic and safety rubric.

Native tool plugin

Nexez OpenClaw Plugin

Native tools for search, page fetch, checkout validation, and negotiation handoff.

v0.2.0

Terminal

openclaw plugins install clawhub:@nexez/openclaw-nexez

Discovery skill

Nexez Agent Discovery

Instructions and rubrics for discovering, comparing, and safely acting on Nexez agent pages.

v0.3.0

Terminal

openclaw skills install nexez-agent-discovery

Agent workflow

From request to safe handoff.

Nexez is designed for agents that need to compare offers, explain why a seller fits, and only then request approval for checkout or negotiation.

Search by buyer intent

Use the directory, plugin tool, or search API with natural buyer language.

Find a Chicago consultant for a one-week growth audit.

Read the page manifest

Fetch agent.json or llms.txt for seller context, offers, FAQs, policies, and direct actions.

/{slug}/agent.json

Validate before acting

Dry-run checkout or negotiation so the agent can confirm the handoff before money or contact occurs.

POST /api/checkout { dryRun: true }

Hand off with approval

After user approval, open checkout, submit negotiation terms, or route to the seller action URL.

checkout, negotiate, book, or contact

Public machine surfaces

Everything points to one source of truth.

These endpoints stay on the public agent runtime so pages remain fast, crawlable, and separate from the authenticated app.

Developer docs

Find matching pages and offer-level actions from a buyer request.

https://nexez.app/api/agent-search?q={query}

Index

List published pages, manifests, readiness, offers, and checkout URLs.

https://nexez.app/agent-pages.json

LLM guide

Plain-text global context for agents that read llms.txt first.

https://nexez.app/llms.txt

OpenAPI

Schemas and operation IDs for agent builders and action catalogs.

https://nexez.app/openapi.json

MCP catalog

Discovery catalog for pages exposing MCP-compatible resources.

https://nexez.app/.well-known/mcp.json

Capabilities

Compact manifest describing Nexez endpoints, safety posture, and distribution.

https://nexez.app/.well-known/nexez.json

SDKs

Helpers for agent builders.

The TypeScript SDK is live on npm, and the Python SDK is live on PyPI for agent runtimes that prefer scripts, workers, notebooks, or server automation.

Published npm

Nexez Agent SDK · v0.3.0

npm

npm install @nexez/agent-sdk

Typed client helpers for agent search, manifest fetch, checkout dry-run, and negotiation handoff.

Published PyPI

Nexez Python Agent SDK · v0.3.0

PyPI

python -m pip install nexez-agent-sdk

Dependency-free Python helpers for agent search, manifest fetch, checkout dry-run, and negotiation handoff.

agent-sdk.ts

search · manifest · dry-run

import { createNexezClient } from '@nexez/agent-sdk'

const nexez = createNexezClient()

const matches = await nexez.search('book a strategy session next week', {
  location: 'Chicago, IL',
  limit: 5,
})

const first = matches.results[0]
const page = await nexez.getAgentPage(first.page.slug)

await nexez.validateCheckout({
  slug: first.page.slug,
  offer: first.offer?.key ?? 'services-0',
  query: 'Buyer wants a strategy session next week.',
  buyerAgent: 'buyer-agent',
})

Agent examples

Copy the full buyer flow.

The examples show agents how to search, fetch structured context, validate handoffs, stop for buyer approval, submit negotiation terms, and poll status.

Buyer approval

examples/agents/python/buyer_approval.py

Build a consent card with seller, offer, terms, risk notes, dry-run result, and explicit approval copy.

Find and validate

examples/agents/python/find_and_validate.py

Search by buyer intent, fetch the page manifest, then dry-run checkout or negotiation before any action.

Location shortlist

examples/agents/python/location_shortlist.py

Rank nearby or remote matches, compare actionability, validate the top offer, and stop for buyer approval.

Submit negotiation

examples/agents/python/submit_negotiation.py

Prepare terms, validate rules, stop for buyer approval, submit, then poll the returned status URL.

TypeScript parity

examples/agents/typescript

The same agent workflows are mirrored for builders using the published TypeScript SDK.

agent-sdk.py

search · manifest · negotiation dry-run

from nexez_agent_sdk import create_client

nexez = create_client(buyer_agent="buyer-agent")

matches = nexez.search(
    "book a strategy session next week",
    location="Chicago, IL",
    limit=5,
)

first = matches["results"][0]
page = nexez.get_agent_page(first["page"]["slug"])

nexez.validate_negotiation(
    slug=page["page"]["slug"],
    offer=first.get("offer", {}).get("key", "services-0"),
    query="Buyer wants a strategy session next week.",
    budget="USD 2100",
)

Safety posture

Open for discovery. Careful for actions.

Public discovery requires no secret.

Use dry-run validation before checkout or negotiation.

Do not infer private seller rules from public constraints.

Ask for buyer approval before spending money or contacting a seller.

For buyer agents

Search by outcome, location, budget signal, or service type. Nexez returns pages with structured offers, trust signals, and direct next actions.

For seller pages

Public pages remain on the agent runtime, while the marketing site and dashboard stay on their own domains. That split protects crawlability and signed-in workflows.

For builders

Use OpenAPI, MCP discovery, and the OpenClaw plugin together when you need typed actions plus readable context.

Ready for the agent web.

Publish a seller page, make it visible in the directory, and let agents discover the offer through the clean runtime.

Create a listing Browse discovery