Can I use Typst as a CLI?

Yes. KosmoKrator exposes a Typst CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Typst through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Typst tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Typst credentials stored?

Typst credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Typst MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

rendering

Typst MCP Integration for Claude Code

Connect Typst to Claude Code through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

1 functions 0 read 1 write No credentials auth

Submit Typst feedback View package source

Connect Typst to Claude Code

Connect local KosmoKrator integrations to Claude Code through one scoped MCP gateway entry.

Add KosmoKrator as a stdio MCP server in the Claude Code project config and select the integrations that should be visible. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Code can inspect read-capable tools without receiving write access by default.

Typst MCP Config for Claude Code

Claude Code can launch the local kosmo binary directly from the project MCP config.

{
  "mcpServers": {
    "kosmokrator-typst": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=typst",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=typst --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Typst instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Typst Tools Visible to Claude Code

Claude Code sees stable MCP tool names generated from the Typst integration catalog.

MCP tool	Source function	Type	Description
`integration__typst__render_typst`	`typst.render_typst`	Write	Render a Typst document to PDF. Pass valid Typst markup and get back a downloadable PDF link. Use this tool to generate formatted documents: reports, invoices, proposals, summaries, letters, tables, and more. Example markup: ``` #set page(margin: 2cm) #set text(size: 11pt) = Quarterly Report == Summary Revenue increased by 15% compared to last quarter. #table( columns: (1fr, 1fr, 1fr), [Metric], [Q1], [Q2], [Revenue], [$1.2M], [$1.38M], [Users], [12,000], [15,400], ) ``` Key Typst syntax: - `= Heading` for headings (`==` for h2, `===` for h3) - `bold` for bold, `_italic_` for italic - `#table(columns: ..., [...], [...])` for tables - `#set page(margin: 2cm)` for page settings - `#set text(size: 12pt, font: "...")` for text settings - `- item` for bullet lists, `+ item` for numbered lists - `#line(length: 100%)` for horizontal rules - `#align(center)[...]` for alignment - `#v(1em)` for vertical spacing

Related Typst Pages

Typst CLIUse direct JSON commands instead of MCP discovery. Typst MCPFull gateway reference and MCP tool names. KosmoKrator for Claude CodeClient-level gateway setup.