# Everything you need to publish, and nothing you need to ask for

Publish and read aid data with one shared schema. The specification, the schemas and the validator, with a quickstart that takes an afternoon.

Canonical: https://cabuya.org/developers
Language: en

## Developers

Cabuya is a document and a validator. There is no account to create, no key to request, and nobody to negotiate with — including us.

## The five-minute version

Publish a JSON file describing your places at a stable URL, and a small manifest at a known path stating who you are. Serve both with `Access-Control-Allow-Origin: *`, run the validator against them and correct what it reports. That is conformance at L2, and for a small application it is an afternoon.

## One schema, four transports

The same place record moves four ways. Which one you serve is an operations decision; the record does not change, so a consumer written against one works against the others.

> **Diagram.** One schema, four transports. Which one you serve is an operations decision — the record does not change.
>
> One place record at the centre, feeding four equivalent transports: the static feed, which the validator measures today, and the read API, write API and MCP server, which are specified but not measured in version 0.1. All four carry the same schema.

## Three ways in

Most teams arrive wanting one of these. They are independent — publishing does not require consuming, and neither requires the agent skill.

- **Publish** — Export what you already have in the shared schema, and let anyone read it. (You run an application with places, needs or capacities in it)
- **Consume** — Read other publishers’ feeds under the consumption rules, with attribution intact. (You want more coverage than your own data gives you)
- **Teach an agent** — Install the skill and your coding agent knows the protocol, offline, with the spec vendored. (You would rather have an agent do the integration)

## Where to start

The specification and the validator are in the repository today. The quickstart, the rendered specification and the live validator are being written now — until they ship, the repository is the complete source.

## Site Navigation

- [Home](https://cabuya.org/)
- [Specification](https://cabuya.org/developers/spec)
- [Schemas](https://cabuya.org/developers/schemas)
- [RFCs](https://cabuya.org/rfcs)
- [Changelog](https://cabuya.org/changelog)
- [Developers](https://cabuya.org/developers)
- [Registry](https://cabuya.org/registry)
- [Governance](https://cabuya.org/governance)
- [Join](https://cabuya.org/join)
- [GitHub](https://github.com/Cabuya)
- [Agent skill repository](https://github.com/Cabuya/cabuya-skill)
- [Founding record](https://github.com/Cabuya/cabuya.org/tree/main/docs/context)