# LemonTea — docs

> Guides and worked examples for making a personal agent from a document you already have — and for reaching listed agents as a machine.

Every doc links to its markdown twin. The whole corpus in one file: https://lemontea.ai/llms-full.txt. The registry as JSON: https://lemontea.ai/api/docs. The site briefing: https://lemontea.ai/llms.txt.

## Start here

- [What LemonTea is](https://lemontea.ai/docs/what-is-lemontea.md) — Personal agents with their own addresses — each made from one document you already have, answering from that and nothing else.

- [Make your first agent](https://lemontea.ai/docs/make-your-first-agent.md) — From a document you already have to a named, addressed agent — no writing required.

## Publish an agent

- [Your agent’s address](https://lemontea.ai/docs/your-agents-address.md) — What the handle is, how renaming works, and the three visibility levels.

- [The sixteen archetypes](https://lemontea.ai/docs/archetypes-guide.md) — The catalogue of starting points — what each kind of agent is made from.

## Machine access

- [Connect from another agent or platform](https://lemontea.ai/docs/connect-from-an-agent.md) — The machine surface: the MCP discovery document and the directory connector on this brand’s own product host.

- [For other agent platforms](https://lemontea.ai/docs/for-agent-platforms.md) — The navigation contract, in order: how your agent finds, opens and calls a listed agent on this brand — and the etiquette that keeps the surface cheap for everyone.

- [The directory connector](https://lemontea.ai/docs/directory-connector.md) — The login-free MCP endpoint for finding and asking this brand’s listed agents: tools, arguments, response shapes, and limits.

- [The agent MCP tools](https://lemontea.ai/docs/agent-mcp-tools.md) — What a listed agent actually exposes on its own MCP endpoint: the tool names, what each does, and which audience may call it.

## Reference

- [The agent card format](https://lemontea.ai/docs/agent-card-format.md) — What a listed agent exposes to machines: the page island, the card, the action manifest, and what each field means.

- [Refusals, errors, and limits](https://lemontea.ai/docs/refusals-and-errors.md) — The failure contract for this brand’s machine surface: how a refusal reads, which errors carry which signals, and what a well-behaved caller does next.

- [Calling agents, end to end](https://lemontea.ai/docs/examples-calling-agents.md) — Literal request/response walkthroughs: directory search with place labels, page-head MCP discovery, ask_agent, rate limits and consent.

## Worked examples

- [Worked examples](https://lemontea.ai/docs/examples.md) — Real interactions with personal agents — what people ask, what a filed document answers, and where the agent declines.

- [Career Proof agents — 50 worked examples](https://lemontea.ai/docs/examples-career-proof.md) — What people ask a career proof agent, what it answers from the document its owner filed, and where it declines.

- [Portfolio to Booking agents — 50 worked examples](https://lemontea.ai/docs/examples-portfolio-to-booking.md) — What people ask a portfolio to booking agent, what it answers from the document its owner filed, and where it declines.

- [Arrival Guide agents — 50 worked examples](https://lemontea.ai/docs/examples-arrival-guide.md) — What people ask a arrival guide agent, what it answers from the document its owner filed, and where it declines.

- [Property Fit agents — 50 worked examples](https://lemontea.ai/docs/examples-property-fit.md) — What people ask a property fit agent, what it answers from the document its owner filed, and where it declines.