routecraft-skills

About

Routecraft is a code-first automation platform for TypeScript. Write routes that send emails, manage calendars, and automate work. Expose them to any AI agent via MCP.

Why Routecraft?

• ✅ AI that does real work - Send emails, schedule meetings, automate tasks
• ✅ Code, not configs - TypeScript all the way with full IDE support
• ✅ Works with Claude & Cursor - Expose tools via MCP automatically
• ✅ Secure by design - AI only accesses the capabilities you expose

Quick Start

Write a tool

import { mcp } from '@routecraft/ai'
import { craft, mail } from '@routecraft/routecraft'
import { z } from 'zod'

// Define a tool AI can call
export default craft()
  .from(mcp('send-team-email', {
    description: 'Send email to team members',
    schema: z.object({ 
      to: z.string().email().refine(
        email => email.endsWith('@company.com'),
        'Can only send to @company.com addresses'
      ),
      subject: z.string(),
      message: z.string()
    })
  }))
  .to(mail())  // Config loaded from context

Expose to Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "my-tools": {
      "command": "bunx",
      "args": ["@routecraft/cli", "run", "./routes/tools.mjs"]
    }
  }
}

The craft CLI runs on Bun (>=1.1.0). Node users embed @routecraft/routecraft programmatically; see the Programmatic Invocation guide.

Now talk to Claude: "Send an email to john@example.com thanking him for yesterday's meeting"

Claude discovers your tool and uses it automatically. ✨

📚 Get Started | Examples | API Reference

Key Features

• Make AI useful - Send emails, schedule meetings, automate tasks
• Code-first - TypeScript with full IDE support, testing, and version control
• MCP native - Works with Claude Desktop, Cursor, and any MCP client
• Type-safe - Zod-powered validation ensures data integrity
• Deploy anywhere - Run locally, self-host, or use our upcoming cloud platform

Monorepo Structure

• packages/routecraft – Core library (builder, DSL, context, adapters, consumers)
• packages/ai – AI integrations: LLM providers, agents, embeddings, MCP server / client
• packages/browser – Browser automation adapter (headless / headed via agent-browser)
• packages/cli – craft CLI to run capabilities and start contexts (Bun >= 1.1.0)
• packages/create-routecraft – Project scaffolder (bunx create-routecraft)
• packages/eslint-plugin-routecraft – ESLint rules for capability authoring
• packages/os – System-native adapters (shell, etc.) – placeholder, in development
• packages/testing – Test utilities (testContext, spy logger, mockAdapter, fixtures)
• skills/ – Agent Skills for authoring Routecraft (Claude Code, Cursor, Codex, Windsurf, Cline, Continue, Copilot, ...; bunx skills add routecraftjs/routecraft). See skills/README.md
• apps/routecraft.dev – Documentation site (docs, examples, guides)
• examples/ – Runnable example capabilities

Examples

Browse runnable examples in examples/src/ — hello-world.ts, mcp-greet.ts, agent.ts, mail-noreply-notify.ts, programmatic-invocation.ts, split.ts. Each demonstrates a different feature combination.

Try one:

bun install
bun run build
bunx craft run ./examples/dist/mcp-greet.js

For end-to-end walkthroughs, see the docs site.

Contributing

Contributions are welcome! Please read our contribution guide at https://routecraft.dev/docs/community/contribution-guide for guidelines on how to propose changes, add adapters, and write routes.

License

Licensed under the Apache 2.0 License.