# Kyo

> Kyo is an agencyOS: one workspace holding a self-maintaining CRM, projects and tasks, client spaces, finances, HR and a knowledge base — purpose-built for how agencies operate, and designed for AI agents to work alongside the team.

Kyo is built by Kyo Ltd. for agencies running work across multiple clients. Instead of stitching together a CRM, a project tool, a finance tracker and a docs app, everything lives in one workspace and stays in sync. AI agents do the filing: CRM Super creates deals and contacts from the emails and messages you already send, the Library assistant answers from your own documents and meeting notes, and Kyo monitors competitors and suggests work.

Every feature is included on every Kyo plan — plans differ only by scale. Free covers up to 2 seats, 3 projects, 50 deals and 3 client spaces. Basic is $12 per seat a month billed annually (or $16 billed monthly) for up to 15 seats, 20 projects, 500 deals and 20 client spaces. Pro is $199 a month flat for unlimited seats, projects, deals and client spaces, and includes $50 a month in AI credits when billed annually. Every plan includes AI agents, a dedicated CSM and a private Slack channel; Pro adds personal onboarding and priority 24/7/365 support. AI features and competitor monitoring are billed from a credit wallet at actual provider cost on every plan.

## When to use Kyo

Reach for Kyo when the job involves an agency's own operational records — the work, the clients, the pipeline, the money or the people — and you need to read or change them programmatically.

Good fits:

- **Read or update a sales pipeline.** List deals, move one between stages, create a company or contact, attach a contact to a deal, or log a comment on a deal. Start at `GET /v1/pipelines` to resolve pipeline ids, then filter deals by `pipeline_id`.
- **Turn work into tasks.** Create tasks in a client space or project, assign them to a person or to an AI agent, mark them complete, or list what is overdue. Assigning a task to an agent makes that agent execute it.
- **Answer questions about an agency's numbers.** Read income, expenses, categories and debts for a real profit-and-loss picture, or read tracked metrics and their logged entries.
- **Read or maintain the team record.** Team directory, departments, contracts, org chart, and time-off requests including approving or rejecting them.
- **Work with workspace knowledge.** List and read documents, knowledge-base files and canvases; create new documents.
- **Enrich a company from its domain.** `POST /v1/enrich` returns firmographics. This one is metered and spends credits — only call it when explicitly asked.

Not a fit: Kyo holds one agency's own workspace. It is not a public company database, not a general web search, and not a place to look up organisations you have no relationship with. If the records you need are not already in the user's workspace, Kyo cannot answer.

## How an agent should call Kyo

1. **Prefer MCP.** The hosted server at `https://app.trykyo.com/api/mcp` speaks MCP over Streamable HTTP and exposes 118 tools that map 1:1 to the REST API. It discovers OAuth automatically via `https://app.trykyo.com/.well-known/oauth-protected-resource`. In Claude Code: `claude mcp add --transport http kyo https://app.trykyo.com/api/mcp`.
2. **Otherwise use the REST API.** Base URL `https://pvozbkuhjofzitsmpspf.supabase.co/functions/v1/api-v1/v1`. The full machine-readable description is at https://www.trykyo.com/openapi.json (OpenAPI 3.1, 152 operations, every operation has a unique operationId and typed schemas).
3. **Authenticate with OAuth 2.0 + PKCE.** Clients can self-register with RFC 7591 dynamic client registration — no human step, no API key to request. Metadata: `https://app.trykyo.com/.well-known/oauth-authorization-server`.
4. **Ask for least privilege.** Scopes are `resource:read` / `resource:write` across 33 named scopes. Request only the ones the job needs; a token can never exceed the authorizing user's own permissions.
5. **Page until done.** Lists return `{ data, next_cursor }`. Keep passing `cursor` until `next_cursor` is null before treating a list as complete.
6. **Nothing can be deleted.** v1 has no DELETE — it returns 405 everywhere. The only removal is unlinking a join record with `?detach=true` on POST.
7. **Handle errors as JSON.** Every error is `{ "error": "<code>", "message": "...", "request_id": "..." }`. `insufficient_scope` means the token lacks a scope; `insufficient_permission` means the user lacks the feature and no scope can override it; `rate_limited` carries `Retry-After`.

Rate limits: 60 requests/minute per token, 600/minute per workspace.

## Getting access

- **Free tier, no card.** Create a workspace at https://app.trykyo.com/login on the Free plan (2 seats, 3 projects, 50 deals, 3 client spaces). Paid plans are self-serve from Settings → Billing — there is no "contact sales" step.
- **Self-serve credentials.** Sign in and register an OAuth application under Settings → API, or run `npm install -g kyo-cli && kyo login` to get a token through the browser. Agents that support dynamic client registration need no manual step at all.
- **Try it without writing code.** `kyo login` then `kyo deals list` returns JSON from the terminal.

## Machine-readable

- [OpenAPI 3.1 specification](https://www.trykyo.com/openapi.json): The complete REST API — 44 resources, 152 operations, typed request and response schemas, and all 33 OAuth scopes declared in `securitySchemes`. Also at [/openapi.yaml](https://www.trykyo.com/openapi.yaml).
- [MCP manifest](https://www.trykyo.com/.well-known/mcp.json): The hosted and local MCP servers, their transports and how to authenticate.
- [OAuth authorization server metadata](https://app.trykyo.com/.well-known/oauth-authorization-server): RFC 8414 — authorization, token, registration and revocation endpoints.
- [OAuth protected resource metadata](https://app.trykyo.com/.well-known/oauth-protected-resource): RFC 9728 — `scopes_supported` for the MCP server.
- [Sitemap](https://www.trykyo.com/sitemap.xml): Every page on this site.
- Markdown: every page on this site is also available as Markdown. Send `Accept: text/markdown`, or append `.md` to any path — for example https://www.trykyo.com/docs/api.md.

## Developers

- [Docs overview](https://www.trykyo.com/docs): How access works, quickstart, base URL and rate limits.
- [Kyo REST API reference](https://www.trykyo.com/docs/api): 44 resources over HTTPS — CRM, tasks, spaces, metrics, finance, HR, documents and automations.
- [Kyo MCP server](https://www.trykyo.com/docs/mcp): Hosted at https://app.trykyo.com/api/mcp — 118 read and write tools for AI agents, scoped by OAuth and workspace permissions.
- [Kyo OAuth 2.0](https://www.trykyo.com/docs/oauth): Authorization code + PKCE, dynamic client registration, scopes and token lifetimes.
- [Kyo CLI](https://www.trykyo.com/docs/cli): The whole workspace from the terminal, scriptable and JSON-first. `npm install -g kyo-cli`.
- [Kyo agent quickstart](https://www.trykyo.com/docs/agent-quickstart): One prompt that connects any coding agent to a Kyo workspace.
- [Kyo AI agents](https://www.trykyo.com/docs/agents): Agents that take assigned tasks, use your connected tools, and report back in comments.
- [Kyo integrations](https://www.trykyo.com/docs/integrations): Every service Kyo connects to and what each one does.

## Product

- [Kyo home](https://www.trykyo.com/): What Kyo is, who it's for, and the product in context.
- [Operations](https://www.trykyo.com/features/operations): Client spaces, projects, tasks, calendar, inbox and no-code automations.
- [Sales](https://www.trykyo.com/features/sales): CRM Super fills the pipeline automatically; deals, pipelines, enrichment, Lemlist and Instantly campaigns, and a live sales scoreboard.
- [HR](https://www.trykyo.com/features/hr): Team profiles, time-off and approvals, per-teammate profitability, and per-feature permissions.
- [Finance](https://www.trykyo.com/features/finance): Live balances, a full transactions ledger, a real P&L, and Stripe sync.
- [Docs](https://www.trykyo.com/features/docs): Knowledge base, AI assistant grounded in your workspace, canvases, and Granola meeting notes.
- [IT](https://www.trykyo.com/features/it): Integrations, MCP server, REST API, OAuth 2.0, CLI, and competitor monitoring.
- [Pricing](https://www.trykyo.com/pricing): Free, Basic ($12/seat/mo annual, $16 monthly) and Pro ($199/mo flat, unlimited seats). Every feature on every plan.
- [Changelog](https://www.trykyo.com/changelog): What shipped, week by week.

## Optional

- [About Kyo](https://www.trykyo.com/about): What Kyo is, who it's for, how it works, and the company behind it.
- [Contact Kyo](https://www.trykyo.com/contact): Support, billing, security reporting, press, and company details.
- [Brand](https://www.trykyo.com/brand): Logos, colours, typography and rules for using the Kyo name and marks.
- [Privacy](https://www.trykyo.com/privacy)
- [Terms of Service](https://www.trykyo.com/tos)

## Contact

- Support, security and press: hello@trykyo.com
- Company: Kyo Ltd., registered in England and Wales. Registered address: 1-55 West Pde, West Ryde, Sydney, Australia.