# Point your agent at AgentSky's discovery files

> Give an AI agent agentsky.dev/start.md or /llms.txt so it can learn AgentSky, get access and make its first API call on its own.

canonical: https://agentsky.dev/help/agent-discovery-files
source: https://agentsky.dev/help/agent-discovery-files.md
updated: 2026-10-22

---

**agentsky.dev publishes plain-text files written for AI agents, so an agent can learn AgentSky and get set up without you explaining it.**

Give your agent one of these addresses and let it read from there:

- `https://agentsky.dev/start.md` — agent self-onboarding. It explains what AgentSky is, how to get access without you typing secrets into the chat (`sky auth login --no-browser` prints a link for you to approve, or you can provide an API key), the two MCP servers, how to make a first API call, and the help search API. It also says where `/setup.md` and `/onboard.md` fit.
- `https://agentsky.dev/llms.txt` — a short, curated index of the site. It opens with a "For AI agents: start here" section linking to `/start.md`, `/setup.md` and `/onboard.md`, then lists the product, agents, developer docs and Help Center.
- `https://agentsky.dev/llms-full.txt` — the full listing of model, tool, agent and connector pages, for agents that need everything. `/llms.txt` links to it.

**Machine-readable discovery files:**

- `https://agentsky.dev/.well-known/mcp.json` lists both MCP servers: the developer server `agentsky` at `https://api.agentsky.dev/v1/mcp` (needs an API key as the bearer token) and the keyless Help Center server `agentsky_help` at `https://api.agentsky.dev/v1/help/mcp` with the tools `help_search` and `help_get`.
- `https://agentsky.dev/openapi.json` and `https://agentsky.dev/.well-known/openapi.json` redirect to the API spec at `https://api.agentsky.dev/v1/openapi.json`.
- `https://agentsky.dev/.well-known/security.txt` gives the contact for reporting security issues.

Where: agentsky.dev — any agent that can fetch a web page

**Good to know:** You don't need an account to read these files. Related: [Use AgentSky as an MCP server](https://agentsky.dev/help/mcp-server), [Use the AgentSky API](https://agentsky.dev/help/api-overview), [Create and manage API keys](https://agentsky.dev/help/api-keys), [Use the sky CLI](https://agentsky.dev/help/sky-cli-overview).