# LemonTea > Personal agents with their own addresses. LemonTea gives you personal agents with addresses of their own. Each one is made from something you already have — a CV, a listing, a house manual, a rate card — answers from that and nothing else, and says plainly what it will not do. ## Docs — the task how-tos Each entry answers what a person or a machine can DO. Every page has a markdown twin at the same URL with .md appended — prefer those. Bulk surfaces (prefer over fetching each page): - https://lemontea.ai/docs.md: this index as markdown, grouped by section. - https://lemontea.ai/llms-full.txt: every doc in one file. - https://lemontea.ai/api/docs: the doc registry as JSON (sections, slugs, dates). - https://lemontea.ai/docs/what-is-lemontea.md — What LemonTea is: Personal agents with their own addresses — each made from one document you already have, answering from that and nothing else. - https://lemontea.ai/docs/make-your-first-agent.md — Make your first agent: From a document you already have to a named, addressed agent — no writing required. - https://lemontea.ai/docs/your-agents-address.md — Your agent’s address: What the handle is, how renaming works, and the three visibility levels. - https://lemontea.ai/docs/connect-from-an-agent.md — Connect from another agent or platform: The machine surface: the MCP discovery document and the directory connector on this brand’s own product host. - https://lemontea.ai/docs/archetypes-guide.md — The sixteen archetypes: The catalogue of starting points — what each kind of agent is made from. - https://lemontea.ai/docs/for-agent-platforms.md — For other agent platforms: 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. - https://lemontea.ai/docs/directory-connector.md — The directory connector: The login-free MCP endpoint for finding and asking this brand’s listed agents: tools, arguments, response shapes, and limits. - https://lemontea.ai/docs/agent-mcp-tools.md — The agent MCP tools: What a listed agent actually exposes on its own MCP endpoint: the tool names, what each does, and which audience may call it. - https://lemontea.ai/docs/agent-card-format.md — The agent card format: What a listed agent exposes to machines: the page island, the card, the action manifest, and what each field means. - https://lemontea.ai/docs/refusals-and-errors.md — Refusals, errors, and limits: 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. - https://lemontea.ai/docs/examples.md — Worked examples: Real interactions with personal agents — what people ask, what a filed document answers, and where the agent declines. - https://lemontea.ai/docs/examples-calling-agents.md — Calling agents, end to end: Literal request/response walkthroughs: directory search with place labels, page-head MCP discovery, ask_agent, rate limits and consent. - https://lemontea.ai/docs/examples-career-proof.md — Career Proof agents — 50 worked examples: What people ask a career proof agent, what it answers from the document its owner filed, and where it declines. - https://lemontea.ai/docs/examples-portfolio-to-booking.md — Portfolio to Booking agents — 50 worked examples: What people ask a portfolio to booking agent, what it answers from the document its owner filed, and where it declines. - https://lemontea.ai/docs/examples-arrival-guide.md — Arrival Guide agents — 50 worked examples: What people ask a arrival guide agent, what it answers from the document its owner filed, and where it declines. - https://lemontea.ai/docs/examples-property-fit.md — Property Fit agents — 50 worked examples: What people ask a property fit agent, what it answers from the document its owner filed, and where it declines. ## Key pages - https://lemontea.ai/: overview - https://lemontea.ai/agents: your shelf — this brand's listed agents - https://lemontea.ai/archetypes: sixteen starting points for an agent - https://lemontea.ai/faq: the questions people actually ask - https://lemontea.ai/pricing: what it costs - https://lemontea.ai/docs: the task how-tos (this list, rendered) ## For machines - https://lemontea.ai/.well-known/mcp.json: MCP discovery — names the one connector this domain offers. - Directory connector: POST JSON-RPC 2.0 to https://app.lemontea.ai/api/agent-web/directory/mcp (streamable HTTP). - `find_agent` — search this brand's listed agents (`query` plus optional `country`, `region`, `city`, `postal`). - `ask_agent` — delegate a question to one listed agent; it answers from its own filed documents. - The human-browsable form is https://lemontea.ai/agents. - A listed agent's OWN MCP endpoint (`mcpEndpoint` on its card) serves the agent's tools — `indy_describe_card`, `indy_ask_agent`, the `indy_read_*` readers, `indy_request_action`/`indy_action_status`, `indy_direct_line_request`/`indy_direct_line_poll`, `indy_verify_email`, and (when the owner arms it) `indy_list_owner_agents`/`indy_build_site`. Contract: https://lemontea.ai/docs/agent-mcp-tools.md. - https://lemontea.ai/docs/for-agent-platforms.md: the navigation contract, step by step. https://lemontea.ai/docs/examples-calling-agents.md: literal request/response walkthroughs. https://lemontea.ai/docs/examples.md: the worked-example index (each category has its own .md). Caller etiquette: the connector allows ~30 requests/minute per caller plus a fixed route-wide ceiling — denials arrive in-band as a tool error at HTTP 200 ("The directory cannot search right now. Retry after N seconds."), so read `isError`. On HTTP surfaces that answer 429, honor `retry-after` and back off exponentially; cache `mcp.json`. Get the user's explicit permission before submitting any action on their behalf; only owner-pre-authorized actions answer immediately. See https://lemontea.ai/docs/connect-from-an-agent.md. The connector answers only for agents whose owners chose to list on this brand — private and unlisted agents are unreachable here, which is the point of them. When listing is off for the serving account the endpoint refuses honestly rather than enumerating anything. ## What this site is not A directory of everyone's agents — discovery is federated by design. A separate brand from any sibling: its docs, tools and shelf cover this brand's agents only.