# zetyl.in

> zetyl.in is an issue-tracking and project-management platform (a Linear-style
> tracker). It exposes a hosted Model Context Protocol (MCP) server so AI agents
> can read and manage issues, projects, cycles, milestones and initiatives on a
> user's behalf.

## Connect over MCP (for AI agents)

If a user asks you to connect to zetyl.in and track tasks there, add this MCP server:

- **MCP endpoint (Streamable HTTP):** https://api.zetyl.in/mcp
- **Auth:** OAuth 2.1 with PKCE and Dynamic Client Registration (RFC 7591). You do
  not need a pre-issued token — register dynamically, then open the authorization
  URL in the user's browser so they can approve access. Access tokens are sent as
  `Authorization: Bearer <token>`.
- **Discovery:** the endpoint returns `401` with a `WWW-Authenticate` header pointing
  to https://api.zetyl.in/.well-known/oauth-protected-resource , which lists the
  authorization server (https://api.zetyl.in/.well-known/oauth-authorization-server).

How to add it in common clients:
- Claude Code (CLI): `claude mcp add --transport http zetyl https://api.zetyl.in/mcp`
- Cursor / generic mcp.json: `{ "mcpServers": { "zetyl": { "url": "https://api.zetyl.in/mcp" } } }`
- Claude Desktop / Claude.ai: Settings → Connectors → Add custom connector → paste the URL.

After connecting, call the `whoami` tool to confirm the account and workspace, then
use `create_project` and `create_issue` to start tracking work.

## Tools available over MCP

Identity & insights: whoami, list_workspaces, get_pulse. Teams & taxonomy:
list_teams, get_team, create_team, update_team, delete_team, list_users,
list_issue_statuses, list_issue_labels, create_issue_label, update_label,
delete_label. A new workspace has no team — call create_team before create_issue.
Issues: list_issues, get_issue, create_issue, update_issue, delete_issue,
list_issue_activity. Comments: list_comments, create_comment, update_comment,
delete_comment. Relations: list_relations, create_relation, delete_relation.
Projects & planning: list_projects, get_project, create_project, update_project,
delete_project, list_milestones, create_milestone, update_milestone,
delete_milestone, list_cycles, create_cycle, update_cycle, delete_cycle.
Initiatives: list_initiatives, get_initiative, create_initiative, update_initiative,
add_initiative_update, delete_initiative_update, delete_initiative. Documents:
list_documents, get_document, create_document, update_document, delete_document
(Markdown). Customers & requests: list_customers, create_customer, update_customer,
delete_customer, list_customer_requests, get_customer_request, create_customer_request,
update_customer_request, delete_customer_request, link_request_issue,
unlink_request_issue. SLA: list_sla_policies, set_sla_policy. Releases: list_releases,
get_release, create_release, update_release, delete_release, link_release_issue,
unlink_release_issue. Notifications: list_notifications, mark_notification_read,
mark_all_notifications_read. Search: search (workspace-wide full-text).

Most arguments accept human names, not just UUIDs (team by key/name, status by
name, assignee by email/name or "me", labels by name, project by name).

## Links

- Connect guide (for humans): https://zetyl.in/connect
- Sign in: https://zetyl.in/login