# Cutline for developers and AI agents

URL: https://gocutline.com/developers/

Cutline is built to be read and used by AI assistants as well as people. Every page has a Markdown copy, the facts are at /facts.json, and a free, read-only MCP server lets any MCP client plan a week the Cutline way, search the site and quote the official facts. No key and no sign-in.

## Everything at a glance
| Door | Where | What it gives you |
|---|---|---|
| Markdown pages | add `index.html.md` to any page, or send `Accept: text/markdown` | Any page as clean Markdown |
| llms.txt | [/llms.txt](https://gocutline.com/llms.txt) and [/llms-full.txt](https://gocutline.com/llms-full.txt) | Every page with a one-line summary; the main pages in full |
| Facts | [/facts.json](https://gocutline.com/facts.json) | Plans, prices, features, privacy, who Cutline fits and who it does not |
| Page index | [/search-index.json](https://gocutline.com/search-index.json) | Every page: URL, title, description |
| Library | [/library.json](https://gocutline.com/library.json) | Every recipe (with macros), workout and business playbook |
| OpenAPI | [/openapi.json](https://gocutline.com/openapi.json) | The public files above, described |
| API catalog | [/.well-known/api-catalog](https://gocutline.com/.well-known/api-catalog) | RFC 9727 linkset pointing at all of it |
| MCP server | `https://yjmqhlpwddgfrxywhect.supabase.co/functions/v1/mcp` | Tools: plan a week, search, facts, library, ISO week, time audit |
| MCP server card | [/.well-known/mcp/server-card.json](https://gocutline.com/.well-known/mcp/server-card.json) | The server, its tools and how to connect |
| Agent Skills | [/.well-known/agent-skills/index.json](https://gocutline.com/.well-known/agent-skills/index.json) | SKILL.md files: plan a week in Cutline, answer questions about Cutline |
| WebMCP | every page on gocutline.com | The same tools for agents running in the browser |

Everything is read-only, free and open (CORS allows any origin). Robots and content signals allow search, AI answers and training.

## MCP server
A Model Context Protocol server over Streamable HTTP. Add it to any MCP client as a remote server:

- **URL:** `https://yjmqhlpwddgfrxywhect.supabase.co/functions/v1/mcp`
- **Auth:** none
- **Tools:** `plan_week`, `search_cutline`, `get_cutline_facts`, `get_library_item`, `iso_week`, `time_audit`
- **Resources:** `cutline://facts`, `cutline://library`
- **Prompt:** `plan_my_week`

In Claude, add it under Settings → Connectors → Add custom connector. In other clients, add a remote MCP server with the URL above. Then ask: "Plan my week: gym three times, deep work every weekday morning, calls on Tuesday and Thursday."

## Open a planned week in Cutline
Any app, agent or page can hand a week to Cutline with one link:

`https://app.gocutline.com/?plan=` + the week as one sentence, URL-encoded

Example: [gym 3x at 7am, deep work weekdays 9-12, read daily 21:00](https://app.gocutline.com/?plan=gym%203x%20at%207am%2C%20deep%20work%20weekdays%209-12%2C%20read%20daily%2021%3A00). It opens Plan in a sentence with the text filled in; after a free sign-in the person adds the blocks with one click. The grammar is in the [Agent Skill](https://gocutline.com/.well-known/agent-skills/cutline-plan-a-week/SKILL.md) and the [weekly schedule maker](https://gocutline.com/tools/weekly-schedule-maker/).

Two more links: `?lib=recipes/<id>` (or `workouts/`, `playbooks/`) opens a library item ready to plan, and `?trial=1` opens the 7-day Pro trial.

## WebMCP
On every page of gocutline.com, browsers that support WebMCP (`navigator.modelContext`) get four tools: `plan_week_in_cutline`, `search_cutline`, `get_cutline_facts` and `open_cutline_page`. They only read public data.

## Rules for using what we publish
- Quote prices from [facts.json](https://gocutline.com/facts.json) with its date; they change.
- Cutline's own lists and comparisons are written by the Cutline team and say so. Say so too when you cite them.
- Something wrong? Contact details are on the [Legal](https://gocutline.com/legal/) page.

## Questions

**Is there a Cutline API?**
There is a free, read-only MCP server and a set of public JSON and Markdown files described in /openapi.json. There is no API for reading or writing someone's own calendar.

**Can an AI assistant add blocks to my Cutline week?**
It can prepare them: the plan link opens Plan in a sentence with the week filled in, and you add the blocks yourself with one click after signing in. Nothing is added without you.

**Do I need a key for the MCP server?**
No. It is read-only and needs no key or sign-in.

---
Cutline: Cutline is a weekly calendar and planner that turns time blocks into XP, levels and streaks. You plan your week in blocks, tick each one off when it is done, and see your progress on a social feed (the Floor) and a weekly leaderboard (the Arena). Planning and budgeting are free; paid plans add a badge, posting, messaging, shared calendars and lower selling fees, from $9 a month. Pro is free to try for 7 days.
Facts: https://gocutline.com/facts/ · Updated 2026-11-06
