This directory contains conceptual guides that explain core MCI principles and features. These guides are adapter-agnostic and focus on understanding MCI itself, not specific implementation details.
Learn about MCI project organization, including:
- Entry files in the project root
- Toolsets directory organization
- MCP server caching
- Basic templating with default values
Start here to understand how to organize your MCI projects.
Understand the four tool execution types:
- HTTP: API requests and workflow integration (n8n, Zapier, Make)
- CLI: Running scripts (.py, .js, .php) and command-line tools
- File: The best way to manage prompts with advanced templating
- Text: Simple text generation
Learn when to use each type and see practical examples.
Master tool organization and sharing:
- Creating reusable tool collections
- Loading and resolving toolsets
- Schema-level filtering
- Sharing toolsets across projects and teams
Perfect for understanding how to organize and distribute tools.
Learn about MCP integration benefits:
- Automatic caching for 20x faster tool discovery
- Filtering MCP tools
- Splitting and combining tools from different servers
- Performance optimization
Discover why MCI's MCP integration is better than direct MCP connections.
Master MCI's standard templating system:
- Variable substitution (
{{props.field}},{{env.VAR}}) - Default values (
{{env.VAR|default}}) - Conditionals (
@if,@else,@endif) - Loops (
@for,@foreach)
These features work consistently across all MCI adapters (Python, JavaScript, Go, etc.).
For Beginners:
- Structure - Understand project organization
- Tools - Learn about execution types
- Templates - Master templating basics
For Tool Organization:
- Tools - Individual tool definitions
- Toolsets - Organizing tools into collections
- Structure - Overall project layout
For MCP Integration:
- MCP Servers - Integration and caching
- Toolsets - Managing MCP toolsets
- Structure - MCP cache location
For Advanced Templating:
- Templates - Complete templating reference
- Tools - Using templates in file execution
- Structure - Templating in entry files
All examples in these guides use:
- JSON for MCI schema files
- XML for template file examples (where applicable)
- Plain text for other templates
No adapter-specific code (Python, JavaScript, etc.) is included in these concept guides. For adapter-specific usage, see:
Currently, only the Python adapter is available; documentation for other adapters will be added as they are released.
- Basic Usage Guide - Python adapter examples
- API Reference - Python API documentation
- Quickstart Guide - Get started in 5 minutes
- Basic Usage Guide - Detailed Python usage
- Schema Reference - Complete schema documentation
- API Reference - Python API documentation
- MCP Integration Guide - MCP server setup
These concept guides are meant to be clear, practical, and universally applicable across all MCI adapters. If you find areas that could be improved or clarified, please open an issue or submit a pull request.