# Routecraft

> Routecraft is a code-first TypeScript automation framework that bridges traditional integration patterns (ETL, webhooks, cron jobs) and AI-native workflows (MCP tool use). Write deterministic capabilities in TypeScript, expose them to AI agents via Model Context Protocol, and keep full control over what AI can access.

## Getting Started

- [Changelog](https://routecraft.dev/raw/docs/changelog.md): All notable changes to Routecraft.

## Introduction

- [Introduction](https://routecraft.dev/raw/docs/introduction.md): What Routecraft is and how it works.
- [Installation](https://routecraft.dev/raw/docs/introduction/installation.md): System requirements, manual setup, and production builds.
- [Project structure](https://routecraft.dev/raw/docs/introduction/project-structure.md): A conventional folder layout that Routecraft expects out of the box.
- [Capabilities](https://routecraft.dev/raw/docs/introduction/capabilities.md): Define what your AI can do, and exactly how it does it.
- [The Exchange](https://routecraft.dev/raw/docs/introduction/exchange.md): The data envelope that flows through every capability.
- [Operations](https://routecraft.dev/raw/docs/introduction/operations.md): The steps that transform, filter, and route data inside a capability.
- [Adapters](https://routecraft.dev/raw/docs/introduction/adapters.md): Connectors that link your capabilities to the outside world.

## Advanced

- [Plugins](https://routecraft.dev/raw/docs/advanced/plugins.md): Extend the Routecraft runtime with cross-cutting behaviour.
- [Events](https://routecraft.dev/raw/docs/introduction/events.md): Observe and react to what happens inside the runtime without touching capability code.
- [Composing Capabilities](https://routecraft.dev/raw/docs/advanced/composing-capabilities.md): Connect capabilities together to build multi-stage pipelines.
- [Error Handling](https://routecraft.dev/raw/docs/advanced/error-handling.md): Catch pipeline errors and recover gracefully with .error().
- [Creating adapters](https://routecraft.dev/raw/docs/advanced/custom-adapters.md): Build your own source, destination, or processor adapter.
- [Expose as MCP](https://routecraft.dev/raw/docs/advanced/expose-as-mcp.md): Run your capabilities as MCP tools for Claude, Cursor, and other AI clients.
- [Call an MCP](https://routecraft.dev/raw/docs/advanced/call-an-mcp.md): Call tools on external MCP servers from within a capability.
- [Linting](https://routecraft.dev/raw/docs/advanced/linting.md): Enforce Routecraft best practices with ESLint.
- [Testing](https://routecraft.dev/raw/docs/introduction/testing.md): Test your capabilities with fast unit tests and optional E2E runs.
- [Deployment](https://routecraft.dev/raw/docs/introduction/deployment.md): Deploy Routecraft as a Node.js process or a Docker container.
- [Monitoring](https://routecraft.dev/raw/docs/introduction/monitoring.md): Log and observe your capabilities at runtime.
- [Terminal UI](https://routecraft.dev/raw/docs/introduction/tui.md): Inspect routes, exchanges, and live events from the terminal.

## Reference

- [Adapters](https://routecraft.dev/raw/docs/reference/adapters.md): Full catalog of adapters with signatures and options.
- [Operations](https://routecraft.dev/raw/docs/reference/operations.md): DSL operators with signatures and examples.
- [Events](https://routecraft.dev/raw/docs/reference/events.md): Full catalog of lifecycle and runtime events emitted by the Routecraft context.
- [Configuration](https://routecraft.dev/raw/docs/reference/configuration.md): Full reference for CraftConfig fields and logging options.
- [CLI](https://routecraft.dev/raw/docs/reference/cli.md): Run Routecraft capabilities from the command line.
- [Plugins](https://routecraft.dev/raw/docs/reference/plugins.md): Full catalog of built-in plugins with options and behaviour.
- [Linting](https://routecraft.dev/raw/docs/reference/linting.md): Rule catalog for @routecraft/eslint-plugin-routecraft.
- [Errors](https://routecraft.dev/raw/docs/reference/errors.md): Short, actionable RC error codes used across Routecraft.

## Examples

- [File to HTTP](https://routecraft.dev/raw/docs/examples/api-sync.md): Read a CSV file and send each row to an API.

## Community

- [Contribution Guide](https://routecraft.dev/raw/docs/community/contribution-guide.md): How to contribute to Routecraft.
- [FAQ](https://routecraft.dev/raw/docs/community/faq.md): Answers to common questions.

## Optional

- [Full Documentation (single file)](https://routecraft.dev/llms-full.txt): All documentation concatenated into one markdown file for bulk ingestion
- [Changelog](https://routecraft.dev/raw/docs/changelog.md)