tiun-sdk

tiun Skills

Agent Skills for building against the tiun SDK: auth and billing in one JS library (@tiun/sdk).

Installing

Works with any agent that supports the Agent Skills standard.

Claude Code

Install through the plugin marketplace:

/plugin marketplace add tiun-app/skills
/plugin install tiun-sdk@tiun-sdk

Cursor

Add manually via Settings > Rules > Add Rule > Remote Rule (Github) with tiun-app/skills.

gh skill

Or use the gh skill extension (preview):

gh skill install tiun-app/skills

gh skill figures out which agents you have installed and drops the skill in the right place. Add --scope user to make it available across every project.

Clone

If you'd rather wire it up by hand, clone and copy skills/tiun-sdk/ into your agent's skills directory:

Agent	Skill directory
Claude Code	~/.claude/skills/
Cursor	~/.cursor/skills/
OpenAI Codex	~/.codex/skills/
Gemini CLI	~/.gemini/skills/

Skills

Skill	Useful for
tiun-sdk	Wiring up @tiun/sdk: subscription gating with userChange and productAccess, time-based paywalls with tiun.start() and paywallShow / paywallHide, hosted checkout/login, server-side verification, and framework setup for vanilla JS, React, Vue 3, Nuxt, Next.js, Svelte, Solid, Astro, Angular, and mobile WebViews. Includes a mandatory discovery step before generating code.

The skill triggers automatically on imports of @tiun/sdk, calls like tiun.init / tiun.checkout, and questions about tiun products or entitlements.

MCP server

Install the tiun MCP server so agents can fetch your providers and products directly from your dashboard during integration. It backs the discovery step in tiun-sdk and gives agents live access to your account context (products, environments, sandbox state).

Universal config

{
  "mcpServers": {
    "tiun": {
      "type": "http",
      "url": "https://mcp.tiun.business"
    }
  }
}

Per client

• Claude Code: the plugin marketplace install (/plugin install tiun-sdk@tiun-sdk) auto-wires the MCP via this repo's .mcp.json. To add manually: claude mcp add tiun https://mcp.tiun.business --transport http (verify the exact flag in your Claude Code version).
• Cursor: Settings → MCP → Add new MCP server → paste the JSON block above. Or merge it into ~/.cursor/mcp.json.
• OpenAI Codex / Gemini CLI / others: paste the universal config above into the client's MCP config file. See the client's MCP documentation for the exact path.

On first call, agents will prompt for authentication against my.tiun.business.

Updating

When tiun's SDK changes, the reference files under skills/tiun-sdk/references/ get refreshed against docs.tiun.io/llms-full.txt. Pull the latest with:

gh skill update tiun-app/skills

Resources

• tiun docs (LLM-friendly bundle)
• tiun dashboard
• Agent Skills spec