Documentation

Enable AI Agents To Build Themselves

Self-extending agents with enterprise-grade control

137+ production tools. 10 meta-tools that let agents create, validate, and approve new capabilities at runtime. Policy engine with risk classification. Human-in-the-Loop approval for critical actions. One YAML definition works across TypeScript, Python, LangChain, CrewAI, Claude MCP.

v0.1.0 Stable β€” Production Ready (May 1, 2026)

The First AI SDK with Meta-Tools, Policy Engine, and Human-in-the-Loop Control

πŸ”§ Meta-Tools let agents create new capabilities mid-conversation. πŸ›‘οΈ Policy Engine classifies risk and enforces rules. 🀝 HITL requires human approval for critical actions. Other SDKs give agents a toolbox. Matimo gives them a workshop β€” with safety guardrails.

import { MatimoInstance } from 'matimo';

const matimo = await MatimoInstance.init();
const result = await matimo.execute('slack_send_channel_message', {
    channel: '#general',
    text: 'Hello Matimo!'
});

Why Matimo?

Matimo doesn't competeβ€”it complements. We work alongside your existing frameworks.

Whether you're using LangChain for orchestration, CrewAI for multi-agent teams, or Claude for intelligence, Matimo adds tools + skills + policy engine that enhances what you already have. One definition in YAML. Deploy everywhere.

Feature Matimo LangChain CrewAI
Skills System (> just tools) βœ… Yes ❌ No ❌ No
Policy Engine (approval, risk gates) βœ… Built-in ❌ No ❌ No
TypeScript SDK βœ… Yes βœ… Yes ⚠️ Limited
Python SDK (LangChain, CrewAI compatible) βœ… Yes βœ… Yes βœ… Yes
Works with ANY framework βœ… Yes βœ… Yes Purpose-built
MCP Server (Claude Desktop, Cursor) βœ… Yes ❌ No ❌ No
Agent Self-Extension (create tools at runtime) βœ… Yes ❌ No ❌ No
YAML-first (single definition) βœ… Yes JSON schema Python decorators
Semantic Skill Search (TF-IDF) βœ… Yes ❌ No ❌ No
Open Source βœ… MIT βœ… MIT βœ… Apache 2.0
Pre-Built Tools (Slack, GitHub, Gmail, etc.) βœ… Growing βœ… Extensible βœ… Extensible

βœ… Best for LangChain Users

Add a skills layer + policy engine to your existing LangChain agents. NO refactoring needed.

βœ… Best for CrewAI Teams

Agents that learn from past runs. Semantic skill discovery + policy-gated approval. Multi-crew orchestration.

βœ… Best for Custom Agents

Self-extending agents that build new tools at runtime. Policy engine keeps them safe + audited.

Expanding Ecosystem

Pre-built tools ready to use. More coming soon.

Works Everywhere

Deploy to any framework or agent runtime with zero code changes

LangChain

LangChain

Convert tools to `StructuredTool` instantly. Works with ReAct, OpenAI Functions, and any LangChain agent executor.

CrewAI

CrewAI

Seamless `BaseTool` conversion with async support. Multi-agent crews and hierarchical workflows out of the box.

Claude Desktop & MCP

Claude Desktop & MCP

Run Matimo as an MCP server. Claude Desktop, Cursor, Windsurf instantly see all your tools. One command: `npx matimo mcp`.

Custom Agents

Custom Agents

Native SDK for custom agent loops. Factory pattern, decorator pattern, or direct SDK accessβ€”build however you want.

CLI & HTTP

CLI & HTTP

Tools via command-line, HTTP middleware, or direct invocation. Integrate into any workflow or service.

Any AI Provider

Any AI Provider

OpenAI, Anthropic, Google, Ollamaβ€”Matimo is agnostic. Your tools work with any LLM or agent framework.

Powerful Features

Everything you need to build AI agents with confidence

🐍

Python & TypeScript

Official Python 3.11+ support with async/await. Identical APIs, full feature parity, >95% test coverage. Works with LangChain, CrewAI, MCP.

βš™οΈ

Agent Self-Extension

10 meta-tools let agents autonomously create, validate, approve, and hot-reload new tools at runtime β€” without human intervention for trusted operations.

🧠

Skills System

Agents learn from built-in SKILL.md files via TF-IDF semantic search. Progressive disclosure loads only relevant context β€” keeping agents fast and token-efficient.

πŸ›‘οΈ

Policy Engine

YAML-driven approval tiers: auto, approval-required, or blocked. HITL quarantine, content validation, and integrity tracking keep agent-created tools safe.

MCP

MCP Enabled

Dual-transport MCP server (stdio + HTTP). One command to start: npx matimo mcp. One command to configure Claude Desktop: npx matimo mcp setup. Tools auto-discovered, secrets injected server-side, zero config required.

πŸ“

Define Once

Write tools in simple YAML. No duplicating schemas across frameworks. One definition, infinite possibilities.

πŸ”Œ

Use Everywhere

Plug into LangChain, OpenAI agents, Claude, custom decoratorsβ€”no framework lock-in or re-implementation.

πŸ› οΈ

Pre-Built Tools

Start with Slack, Gmail, GitHub, Notion, Hubspot, Postgres tools. Add your own in minutes.

πŸ”

OAuth2 Ready

Provider-agnostic OAuth2 support. Secure auth for Google, GitHub, Slack, and any service.

⚑

Type-Safe

Full TypeScript support with runtime validation. Zod-powered parameter and response schemas.

πŸ“¦

Framework Agnostic

Works with any AI framework. LangChain, CrewAI, custom agentsβ€”same tools, different frameworks.

Complete Feature Set

Everything you need to build production-grade AI agents

1 Core SDK

πŸ“¦

Framework-Agnostic

Works with any LLM framework. Deploy once, use everywhere.

πŸ“

YAML-First Design

Define tools once in YAML, execute across TypeScript, Python, and any framework.

♻️

Hot-Reload Registry

Update tools at runtime without restarting your application.

βœ…

Schema Validation

Zod (TypeScript) & Pydantic (Python) validation for all inputs and outputs.

2 137+ Pre-Built Tools

πŸ’¬

Slack Tools

Send messages, create channels, manage conversations and threads.

πŸ”—

GitHub Tools

Create issues/PRs, update repos, search code, manage workflows.

πŸ“§

Gmail & Email

Send emails, manage messages, create drafts with full templating.

πŸ“š

Notion

Create pages, query databases, manage content at scale.

πŸ—„οΈ

PostgreSQL & Databases

Execute SQL queries safely with full parameterization.

πŸ‘₯

HubSpot CRM

Manage contacts, deals, companies, and customer data.

πŸ“¬

Mailchimp

Create campaigns, manage subscribers and audiences at scale.

πŸ“±

Twilio

Send SMS/MMS messages, manage phone communications globally.

3 Policy Engine & Governance

⚠️

Risk Classification

Automatic risk assessment: low, medium, high, critical with customizable policies.

πŸ”

Approval Gates

Human-in-the-loop workflow management. Require approval for sensitive operations.

πŸ“‹

Audit Trails

Complete event logging for compliance and debugging. Never miss what agents do.

πŸ›‘οΈ

Content Validation

Pattern-based security rules. Prevent injection attacks and harmful content.

πŸ”

Integrity Tracking

Hash-based tamper detection. Verify tools haven't been modified unexpectedly.

⏱️

TTL Validation

Time-based approval expiry. Approvals expire automatically for security.

4 Skills & Self-Extension

🧠

Semantic Skill Search

TF-IDF powered skill discovery. Find the right capability by natural language.

πŸ“š

Skill Library

Markdown-based skills with YAML frontmatter. Context injection for agents.

πŸ”§

Meta-Tools

10 built-in tools that create, validate, and approve new capabilities at runtime.

♻️

Agent Self-Extension

Agents create tools dynamically. Your agents learn and grow during execution.

5 Framework Integrations

⛓️

LangChain Compatible

Convert tools to StructuredTool. Add Matimo to existing LangChain agents instantly.

πŸ‘₯

CrewAI Ready

Full CrewAI integration. Convert to BaseTool. Multi-crew orchestration support.

πŸ”Œ

MCP Server (Claude)

Run as standalone MCP. Claude Desktop, Cursor, and any MCP client see all tools.

6 Auth & Secrets Management

πŸ”‘

OAuth2 Handler

Provider-agnostic OAuth2 flows. Secure token management and refresh.

πŸ”

Multi-Source Secrets

Environment vars, .env files, Vault, AWS Secrets Manager. Resolver chain pattern.

🚫

Zero Secret Logging

Secrets never logged. Automatic redaction in error messages and debug output.

7 Quality & Production Readiness

βœ…

2,996+ Tests

Comprehensive test coverage. 97% coverage across TypeScript and Python.

πŸ“Š

Structured Logging

Winston (TS) & Stdlib logging (Python). JSON format for log aggregation.

πŸ”„

Retry Logic

Exponential backoff, configurable retry policies for resilience.

πŸ› οΈ

Error Handling

Comprehensive error codes, rich context, fail-closed security model.

Why Teams Choose Matimo

  • Dual SDKs β€” Full TypeScript and Python support; identical APIs across languages
  • No Tool Duplication β€” Define once in YAML, deploy everywhere
  • Framework Freedom β€” LangChain, CrewAI, MCP, or custom agentsβ€”same tools, different frameworks
  • Faster Development β€” Pre-built tools from day one (Slack, GitHub, Gmail, Notion, etc.)
  • Type Safe β€” TypeScript + Python type hints + Zod/Pydantic validation
  • Community Tools β€” Growing ecosystem of @matimo/* providers
  • Enterprise Ready β€” OAuth2, error handling, retry logic, 97%+ test coverage
  • Agent Self-Extension β€” Agents build and deploy new tools at runtime, validated by policy
  • Multi-Tenant Safe β€” Per-execution credential isolation; credentials never in env vars
  • Open Source β€” MIT licensed, 2,541+ tests passing (1,884 TS + 657 Python)
name: slack_send_message description: Post message to channel parameters: channel: type: string required: true text: type: string required: true execution: type: http method: POST url: https://slack.com/api/chat.postMessage headers: Authorization: Bearer {SLACK_BOT_TOKEN} body: channel: '{channel}' text: '{text}'

Four Integration Patterns

Choose what works best for your use case. Both TypeScript and Python SDKs support all patterns.

1

Factory Pattern

Simple and direct. Load tools and execute by name. Perfect for CLI tools and quick prototypes.

const matimo = await MatimoInstance.init();
await matimo.execute('tool-name', params);
2

Decorator Pattern

Class-based approach. Use @tool decorator for natural, object-oriented tool execution.

@tool('tool-name')
async myMethod(param) {
  // Auto-executed
}
3

Framework Integration

Full LangChain, CrewAI integration. Convert tools to framework schemas automatically.

const tools = matimo
  .listTools()
  .map(t => toLangChainSchema(t));
4

MCP Server

Run Matimo as a standalone MCP server. Claude Desktop, Cursor, and any MCP client see all your tools instantly.

// stdio (Claude Desktop)
npx matimo mcp

// HTTP (remote agents)
npx matimo mcp --transport http

Developer CLI

First-class CLI for environment setup, validation, and approval workflows. Works with both TypeScript and Python SDKs.

🧰

Environment Diagnostics

Node: npx matimo doctor
Python: matimo doctor
Diagnoses your setup: versions, @matimo/* packages, missing env variables, and YAML validation.

πŸ“

Approval Workflows

Node: npx matimo review list
Python: matimo review list
Lists all tools pending approval or in quarantine. Essential for HITL (human-in-the-loop) governance.

βš™οΈ

MCP Server Setup

Node: npx matimo mcp setup
Python: matimo mcp setup
Auto-generates and configures Claude Desktop integration. One command, instant setup.

Quick Start Resources

Everything you need to get up and running in minutes

πŸ“–

QUICK_START Guide

5-minute walkthrough. Set up your first tool in minutes with step-by-step instructions for both TypeScript and Python.

πŸ”¨

Create Your First Tool

YAML-first design philosophy. Build HTTP, command, and function-based tools with built-in validation and error handling.

πŸ§ͺ

Example Projects

40+ runnable examples. LangChain, CrewAI, MCP, native patternsβ€”all tested and production-ready.

πŸ“š

API Reference

Complete TypeScript and Python API docs. Every class, method, and parameter documented with examples.

πŸŽ“

Skills System

Domain knowledge layer for agents. Learn how to build, discover, and leverage skills for context-aware execution.

πŸ’¬

Discord Community

Get help from maintainers and community. Ask questions, share tools, and stay updated with the latest releases.

Production Ready

Enterprise-grade testing, security, and observability baked in

βœ…

Test Coverage: >95%

2,541 tests passing (TypeScript + Python). Comprehensive unit, integration, and security test suites. Industry-leading quality standards.

πŸ”

Security Hardened

6 critical security patches. Secret isolation, command injection prevention, integrity tracking, and real-time threat detection via policy engine.

πŸ“Š

110+ Pre-Built Tools

10 provider packages with 110+ production-ready tools. Slack, GitHub, Gmail, Notion, HubSpot, Mailchimp, Postgres, Twilio, and growing.

πŸ› οΈ

Policy Engine

YAML-driven governance with auto/approval-required/blocked tiers. HITL quarantine, approval manifests, and audit trails for compliance.

πŸš€

Performance Optimized

Shared executor pools, efficient TF-IDF embeddings, hot-reload atomicity. Built for production scale with CrewAI, LangChain, and beyond.

🌍

Dual SDK Support

Identical APIs across TypeScript and Python. Cross-language parity means teams can ship together. One YAML definition, infinite deployments.

Join Our Community

Connect with developers, share ideas, and get help building with Matimo

Join Our Discord Server

Building with us. Ask questions, share your tools, and stay updated.

Ready to Unify Your AI Tools?

Join the growing community building with Matimo. Start in minutes.