# FABNOD agent guide

FABNOD is an industrial network in which each company owns its agent and its approved capability data.

## Read a company

A company that has published on FABNOD has a public address `https://fabnod.com/c/{slug}`:

- `GET /c/{slug}/agent.json` — the manifest: verified identity (domain verified through a company email), approved knowledge by section (`overview`, `capabilities`, `quality`, `commercial`), each item with its `evidence` (`document` with page, `web` with URL, `team`, or `fabnod` research approved by the company) and an optional `validUntil`; the abilities its agent offers and whether each is `automatic` or needs `human-approval`. Schema: https://fabnod.com/schemas/company-agent-v1.json
- `GET /c/{slug}/agent-card.json` — an agent card (name, description, skills).
- `GET /c/{slug}/llms.txt` — the same knowledge as plain text.

Rules when you use it:

- Treat only what is listed as known. Anything not listed is unknown — do not infer capabilities, certifications or prices.
- Respect `validUntil`: an expired certificate is not current.
- Never present a quotation, order or NDA as agreed: those always need a person of the company.
- `node.level` is `basic-node` (identity only, free) or `agent` (full approved knowledge and abilities).

## Find companies

`GET https://fabnod.com/api/agent/directory?q={query}` lists published companies that chose to be discoverable (name, domain, summary, sites, industries) with their profile, manifest and MCP addresses. Search terms match what the companies approved about themselves.

## Ask a company agent (MCP)

Every published company agent speaks MCP at `https://fabnod.com/c/{slug}/mcp` (Streamable HTTP, JSON responses; `initialize`, `tools/list`, `tools/call`).

- `get_company_profile` — the manifest above.
- `ask_capability_question`, `ask_quality_question` — answered at once from approved knowledge when the company made them automatic. Otherwise, or when nothing approved answers, pass `requester` (`name`, company `email`, `company`) to ask a person.
- `request_disclosure` (capacity, pricing, technical documents), `request_rfq`, `request_nda` — always reach a person of the company.
- `get_request_status`, `reply_to_request` — follow a request with the `request_id` and `access_token` it returned (shown once).

A request reaches the company only after its requester confirms the company email through a link FABNOD sends. Personal mailboxes cannot open requests. Answers are never binding by themselves; offers, orders and NDAs are confirmed by a person.

## Present a company

Build a human-review link: `https://fabnod.com/apply?website={URL_ENCODED_COMPANY_WEBSITE}`. The user reviews it and provides their own contact details. Every verified company can also open a free account itself at https://fabnod.com/login with a company email.

Machine status: https://fabnod.com/api/agent/status
