| Name | automagik-tools JSON |
| Version |
0.9.9
JSON |
| download |
| home_page | None |
| Summary | A monorepo package for MCP tools with dynamic loading capabilities - featuring Evolution API v2 WhatsApp integration |
| upload_time | 2025-11-01 00:04:24 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | MIT |
| keywords |
mcp
tools
ai
agents
fastmcp
whatsapp
discord
notion
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<p align="center">
<img src=".github/images/automagik-tools-logo.svg" alt="Automagik Tools Logo" width="400">
</p>
<h2 align="center">From API to AI in 30 Seconds</h2>
<p align="center">
<strong>🎯 The Bridge Between Your APIs and Intelligent AI Agents</strong><br>
Transform any API into a smart MCP agent that learns, adapts, and speaks human<br>
No code generation, no complex setup—just instant intelligence
</p>
<p align="center">
<a href="https://github.com/namastexlabs/automagik-tools/actions"><img alt="Build Status" src="https://img.shields.io/github/actions/workflow/status/namastexlabs/automagik-tools/test.yml?branch=main&style=flat-square" /></a>
<a href="https://github.com/namastexlabs/automagik-tools/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/namastexlabs/automagik-tools?style=flat-square&color=00D9FF" /></a>
<a href="https://discord.gg/xcW8c7fF3R"><img alt="Discord" src="https://img.shields.io/discord/1095114867012292758?style=flat-square&color=00D9FF&label=discord" /></a>
<a href="https://pypi.org/project/automagik-tools/"><img alt="PyPI" src="https://img.shields.io/pypi/v/automagik-tools?style=flat-square&color=00D9FF" /></a>
<a href="https://github.com/orgs/namastexlabs/projects/9/views/1?filterQuery=project%3Atools"><img alt="Roadmap" src="https://img.shields.io/badge/📍_roadmap-view_initiatives-5319E7?style=flat-square" /></a>
</p>
<p align="center">
<a href="#-key-features">Features</a> •
<a href="#-quick-start">Quick Start</a> •
<a href="#-built-in-tools">Tools</a> •
<a href="https://github.com/orgs/namastexlabs/projects/9/views/1?filterQuery=project%3Atools">Roadmap</a> •
<a href="#-contributing">Contributing</a>
</p>
---
## 🚀 What is Automagik Tools?
**Automagik Tools** is the MCP (Model Context Protocol) toolkit that transforms any API into an intelligent agent in seconds. Think of it as the universal translator between your systems and AI—no coding required, just point to your API and start talking to it in natural language.
### 🎭 The API Integration Problem
**The Old Way**: Want your AI to talk to Stripe? Write 500 lines of integration code. Update the API? Rewrite everything. Need another API? Start from scratch. Hours turn into weeks, developers cry, budgets explode.
**The Automagik Way**:
```bash
# One command. 30 seconds. Done.
uvx automagik-tools openapi https://api.stripe.com/openapi.json
```
Now your AI can process payments, manage subscriptions, and handle refunds—all in natural language.
### 🚫 Why Traditional Integration Fails
The integration nightmare is real:
- **Weeks of Development**: Each API needs custom code (2-4 weeks average)
- **No Standardization**: Every team reinvents the wheel
- **Maintenance Hell**: APIs change, everything breaks
- **Zero Reusability**: Can't share work across projects
- **Complex Deployment**: Getting it to production is a full-time job
### ✅ The Automagik Tools Solution
We flip the script completely:
- ⚡ **30 Seconds to Integration**: Point to OpenAPI spec, done
- 🧠 **Self-Learning Agents**: Remember your patterns, adapt to your workflow
- 🔄 **Universal Protocol**: One standard (MCP) for all integrations
- 🎯 **Zero Code**: No SDKs, no wrappers, just conversation
- 📦 **Instant Deployment**: `uvx` = installed and running
- 🔌 **Plug & Play**: Works with Claude, Cursor, any MCP client
- 💰 **99% Cost Reduction**: R$ 45k → R$ 100 per integration
---
## 🌟 Key Features
- **🔧 Instant MCP Generation**: Any OpenAPI spec becomes an intelligent agent in seconds
- **🧠 Self-Learning Intelligence**: Agents remember your patterns and improve with use
- **📋 Markdown Processing**: GPT-4.1-nano cleans noisy JSON into readable output
- **🧞 Genie Orchestrator**: Connect and coordinate unlimited MCP servers with persistent memory
- **🤖 Automagik Integration**: Native orchestration with Spark, Hive, Forge, and Omni
- **🔄 Multiple Transports**: stdio for local, SSE for team sharing, HTTP for APIs
- **📱 WhatsApp Automation**: Complete Evolution API integration built-in
- **🎨 Three Intelligence Modes**: Standard (precise), Markdown (readable), Genie (natural language)
- **🚀 Zero Installation**: Run with `uvx` - no global install needed
- **🔌 Universal Compatibility**: Works with Claude Code, Cursor, Cline, Roo, Gemini CLI
- **📦 Centralized Toolkit**: All your tools in one hub, versioned and standardized
- **🏗️ Plugin Architecture**: Drop tools in a folder, auto-discovered instantly
- **100% Open Source**: MIT license, self-hostable, no vendor lock-in
---
## 🧞 Genie: Your Universal AI Conductor
Genie is the crown jewel—a meta-agent that orchestrates any MCP servers with persistent memory.
### What Makes Genie Special?
```bash
# Start Genie with memory
uvx automagik-tools tool genie -t sse --port 8000
```
**Connect Any MCP Servers**:
```bash
export GENIE_MCP_CONFIGS='{
"agent-memory": {
"url": "http://localhost:8001/sse",
"transport": "sse"
},
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/workspace"],
"env": {}
},
"github": {
"command": "uvx",
"args": ["mcp-server-git"],
"env": {"GITHUB_TOKEN": "your-token"}
}
}'
```
**Now Tell Genie in Natural Language**:
- "Use memory to track my GitHub preferences, then analyze my repos and create weekly summaries"
- "Coordinate between Slack and Linear to set up daily standups for the design team"
- "Monitor competitor pricing with the trading API and remember my risk preferences"
Genie **learns your patterns**—after a few interactions, it knows exactly how you like data formatted, which metrics matter, and when to alert you.
---
## 📸 Real-World Magic
### Stripe Payments in 30 Seconds
```bash
uvx automagik-tools openapi https://raw.githubusercontent.com/stripe/openapi/master/openapi/spec3.json
# Now just talk to it:
# "Process a $100 payment for customer cus_123"
# "Show me failed payments from last week"
# "Create a subscription for Pro plan"
```
### Discord Bot Without Code
```bash
uvx automagik-tools openapi \
https://raw.githubusercontent.com/discord/discord-api-spec/main/specs/openapi.json \
-t sse --port 8001
# Natural language commands:
# "Schedule a voice call for 3pm in the dev channel"
# "Find all threads mentioning the new feature"
# "Show unread messages from the design team"
```
### Your Internal API, AI-Ready
```bash
# Your company's API becomes conversational
uvx automagik-tools openapi https://api.yourcompany.com/openapi.json
# Team shares the same learning agent via SSE
# Agent adapts to company terminology and workflows
```
---
## 📡 MCP: Remote Control from Anywhere
Automagik Tools works with **any MCP-compatible client**—Claude Code, Cursor, Cline, Roo, Gemini CLI—you name it.
### Typical Workflow
1. **Point to API**: Give AutoMagik any OpenAPI spec
2. **Deploy Agent**: Choose stdio (local) or SSE (team sharing)
3. **Connect Client**: Add to Claude/Cursor/your favorite tool
4. **Start Talking**: Natural language, the agent figures it out
5. **Agent Learns**: Remembers your patterns, gets smarter
### Example Use Cases
- 🎯 **"Connect to our warehouse API and alert me when inventory drops below thresholds"**
- 🐛 **"Monitor production logs and categorize errors automatically"**
- ✅ **"Generate weekly sales reports and send to regional managers"**
- 📋 **"Track competitor prices and notify me of changes above 5%"**
### Available MCP Tools
| Tool | Description | Use Case |
|------|-------------|----------|
| `genie` | Universal MCP orchestrator | Coordinate multiple tools with memory |
| `automagik` | Automagik Suite integration | Orchestrate Spark, Hive, Forge, Omni |
| `automagik-workflows` | Claude workflow execution | Run and monitor Claude Code workflows |
| `evolution-api` | WhatsApp automation | Send/receive messages, media, groups |
| `openapi` | Dynamic API agent | Any OpenAPI spec → instant agent |
### Quick Setup
<details>
<summary><b>🤖 Claude Code Configuration</b></summary>
1. Open Claude Code settings
2. Navigate to MCP Servers section
3. Add configuration:
```json
{
"mcpServers": {
"automagik-tools": {
"command": "uvx",
"args": [
"automagik-tools@latest",
"serve",
"--tool",
"genie",
"--transport",
"stdio"
],
"env": {
"OPENAI_API_KEY": "your-openai-key",
"GENIE_MCP_CONFIGS": "{\"your-mcp-config-here\":{}}"
}
}
}
}
```
</details>
<details>
<summary><b>🎯 Cursor Configuration</b></summary>
1. Open Cursor Settings (`Cmd/Ctrl + ,`)
2. Search for "MCP"
3. Add to `~/.cursor/mcp.json`:
```json
{
"mcpServers": {
"automagik-tools": {
"command": "uvx",
"args": [
"automagik-tools@latest",
"serve",
"--tool",
"automagik",
"--transport",
"stdio"
],
"env": {
"AUTOMAGIK_API_KEY": "your-key",
"AUTOMAGIK_BASE_URL": "http://localhost:8881"
}
}
}
}
```
</details>
<details>
<summary><b>📝 VSCode + Cline Configuration</b></summary>
1. Install Cline from VSCode marketplace
2. Open Cline settings
3. Add MCP server:
```json
{
"cline.mcpServers": [
{
"name": "automagik-tools",
"command": "uvx",
"args": [
"automagik-tools@latest",
"serve",
"--openapi-url",
"https://api.example.com/openapi.json",
"--transport",
"stdio"
]
}
]
}
```
</details>
<details>
<summary><b>🚀 Roo Code Configuration</b></summary>
1. Open Roo Code preferences
2. Navigate to Extensions → MCP
3. Add server:
```yaml
servers:
automagik-tools:
command: uvx
args:
- automagik-tools@latest
- serve
- --tool
- genie
- --transport
- stdio
environment:
OPENAI_API_KEY: your-key
```
</details>
<details>
<summary><b>💎 Gemini CLI Configuration</b></summary>
1. Edit `~/.gemini/config.json`
2. Add MCP server:
```json
{
"mcp": {
"servers": {
"automagik-tools": {
"type": "stdio",
"command": "uvx",
"args": [
"automagik-tools@latest",
"serve",
"--tool",
"automagik",
"--transport",
"stdio"
]
}
}
}
}
```
</details>
<details>
<summary><b>🔧 Generic MCP Configuration</b></summary>
For any MCP-compatible tool:
```json
{
"command": "uvx",
"args": [
"automagik-tools@latest",
"serve",
"--openapi-url",
"YOUR_API_OPENAPI_URL",
"--transport",
"stdio"
],
"env": {
"OPENAI_API_KEY": "your-key",
"API_CUSTOM_ENV": "your-value"
}
}
```
</details>
---
## 🎭 From Chaos to Intelligence
### The Evolution of API Integration
```mermaid
graph LR
A[Your API] --> B[AutoMagik Tools]
B --> C[Intelligent MCP Agent]
C --> D[Claude/Cursor/AI]
D --> E[Natural Language Control]
E --> F[Agent Learns & Adapts]
F --> C
```
### Example: E-commerce Automation
```bash
You: "Set up my Shopify store as an AI agent"
Your Process:
1. Get OpenAPI spec URL
2. Run: uvx automagik-tools openapi https://shopify.dev/.../openapi.json
3. Done! Now talk to your store:
- "Show me orders from last week with revenue > $500"
- "Which products have low inventory?"
- "Create a discount code for returning customers"
Agent learns your patterns:
- Remembers your preferred date formats
- Knows which metrics you care about
- Adapts responses to your style
```
---
## 📦 Quick Start
### Prerequisites
- Python 3.12+ (that's it!)
- OpenAI API key (for intelligence features)
- Your API's OpenAPI specification
### Installation
**Option 1: No Installation (Recommended)**
```bash
# Use uvx - run directly without installing
uvx automagik-tools list
```
**Option 2: Global Install**
```bash
pip install automagik-tools
```
**Option 3: Development**
```bash
git clone https://github.com/namastexlabs/automagik-tools
cd automagik-tools
make install
```
### First Run
```bash
# List all available tools
uvx automagik-tools list
# Run Genie orchestrator
uvx automagik-tools tool genie --transport stdio
# Convert any API to agent
uvx automagik-tools openapi https://api.github.com/openapi.json
# Run with team sharing (SSE)
uvx automagik-tools tool automagik --transport sse --port 8000
```
### Environment Setup
Create `.env` file:
```bash
# OpenAI for intelligence
OPENAI_API_KEY=sk-your-key
# Automagik Suite integration (optional)
AUTOMAGIK_API_KEY=your-key
AUTOMAGIK_BASE_URL=http://localhost:8881
# Enable Markdown processing (optional)
ENABLE_JSON_PROCESSING=true
JSON_PROCESSOR_MODEL=gpt-4.1-nano
```
---
## 🛠️ Built-in Tools
### 🧞 Genie - Universal Orchestrator
Your AI conductor that coordinates any MCP servers with persistent memory.
```bash
uvx automagik-tools tool genie -t sse --port 8000
```
**Use Cases**:
- Coordinate multiple tools for complex workflows
- Remember context across all sessions
- Natural language task orchestration
- Team-wide shared intelligence
### 🤖 Automagik - Suite Integration
Native integration with the Automagik ecosystem (Spark, Hive, Forge, Omni).
```bash
uvx automagik-tools tool automagik -t stdio
```
**Use Cases**:
- Spawn agent swarms with Hive
- Schedule recurring tasks with Spark
- Manage development workflows with Forge
- Send WhatsApp notifications via Omni
### 🚀 Automagik Workflows - Claude Execution
Execute and monitor Claude Code workflows with real-time progress.
```bash
uvx automagik-tools tool automagik-workflows -t stdio
```
**Use Cases**:
- Run Claude workflows programmatically
- Track execution progress visually
- List available workflows
- Monitor workflow status
### 📱 Evolution API - WhatsApp Automation
Complete WhatsApp Business automation via Evolution API.
```bash
uvx automagik-tools tool evolution-api -t stdio
```
**Use Cases**:
- Send/receive messages and media
- Manage groups and contacts
- Handle status updates
- Automate customer support
### 🌐 OpenAPI - Dynamic Agents
Transform any OpenAPI spec into an instant intelligent agent.
```bash
uvx automagik-tools openapi https://api.example.com/openapi.json
```
**Use Cases**:
- Any REST API with OpenAPI/Swagger
- Internal company APIs
- Third-party services
- Legacy system integration
---
## 🛠️ Development
Interested in contributing or building custom tools?
### Creating Your Own Tool
```bash
# 1. Create tool folder
mkdir -p automagik_tools/tools/my_tool
# 2. Implement FastMCP server
# See docs/TOOL_CREATION_GUIDE.md for templates
# 3. Register in pyproject.toml
[project.entry-points."automagik_tools.plugins"]
my_tool = "automagik_tools.tools.my_tool"
# 4. Done! Auto-discovered
uvx automagik-tools list
```
### Development Commands
```bash
make install # Install with dev dependencies
make test # Run all tests
make lint # Check code quality
make format # Auto-format code
make build # Build package
```
See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.
---
## 🗺️ Roadmap
### Completed ✅
- [x] Dynamic OpenAPI agent generation
- [x] Genie universal orchestrator
- [x] Multi-transport support (stdio, SSE, HTTP)
- [x] Self-learning with memory
- [x] Markdown output processing
- [x] Evolution API (WhatsApp)
- [x] Automagik Suite integration
- [x] Plugin architecture
### Next Up 🚀 (Q4 2025 - Q1 2026)
- [ ] **Smart Tools v1**: Specialized SLMs per tool for expert-level API knowledge
- [ ] **Web UI**: Visual interface for managing and testing tools
- [ ] **Marketplace Beta**: Community tool sharing platform
- [ ] **5-Minute Creation**: Reduce tool creation from 30min to 5min
- [ ] **Tool Templates**: Pre-built templates for common API patterns
### Future Vision 🌟 (2026-2027)
- [ ] **Auto-Learning**: Tools improve themselves based on usage patterns
- [ ] **Auto-Discovery**: Connect to APIs without OpenAPI specs
- [ ] **Self-Maintenance**: Agents maintain their own code
- [ ] **Visual Builder**: Drag-and-drop tool creation
- [ ] **Enterprise Cloud**: Fully managed SaaS offering
- [ ] **Global Marketplace**: Buy/sell community tools
---
## 🤝 Contributing
We love contributions! However, to maintain project coherence:
1. **Discuss First**: Open an issue before starting work
2. **Align with Roadmap**: Ensure changes fit our vision
3. **Follow Standards**: Match existing code patterns
4. **Test Thoroughly**: Include tests for new features
5. **Document Well**: Update docs with your changes
See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.
---
## 🙏 Acknowledgments
Special thanks to:
- [Anthropic](https://anthropic.com) for creating MCP
- [FastMCP](https://github.com/jlowin/fastmcp) for the awesome framework
- Our amazing community of early adopters and contributors
- Every developer who's ever cursed at API documentation
---
## 📄 License
MIT License - see [LICENSE](LICENSE) file for details.
---
## 🔗 Links
- **GitHub**: [github.com/namastexlabs/automagik-tools](https://github.com/namastexlabs/automagik-tools)
- **PyPI**: [pypi.org/project/automagik-tools](https://pypi.org/project/automagik-tools)
- **Discord**: [discord.gg/xcW8c7fF3R](https://discord.gg/xcW8c7fF3R)
- **Twitter**: [@namastexlabs](https://twitter.com/namastexlabs)
- **DeepWiki Docs**: [deepwiki.com/namastexlabs/automagik-tools](https://deepwiki.com/namastexlabs/automagik-tools)
---
<p align="center">
<strong>🚀 Stop writing integrations. Start having conversations.</strong><br>
<strong>Every API becomes an intelligent agent that learns how you work.</strong><br><br>
<a href="https://github.com/namastexlabs/automagik-tools">Star us on GitHub</a> •
<a href="https://discord.gg/xcW8c7fF3R">Join our Discord</a>
</p>
<p align="center">
Made with ❤️ by <a href="https://namastex.ai">Namastex Labs</a><br>
<em>AI that elevates human potential, not replaces it</em>
</p>
<p align="center">
<a href="https://mseep.ai/app/namastexlabs-automagik-tools"><img src="https://mseep.net/pr/namastexlabs-automagik-tools-badge.png" alt="MseeP.ai Security Assessment Badge"></a><br>
<a href="https://deepwiki.com/namastexlabs/automagik-tools"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
</p>
Raw data
{
"_id": null,
"home_page": null,
"name": "automagik-tools",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "mcp, tools, ai, agents, fastmcp, whatsapp, discord, notion",
"author": null,
"author_email": "Felipe Rosa <felipe@namastex.ai>, Cezar Vasconcelos <cezar@namastex.ai>",
"download_url": "https://files.pythonhosted.org/packages/7e/9e/6f1955592be6f8abde70773ababb7a1b6d0cee187644464f12c17ed6dfbd/automagik_tools-0.9.9.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <img src=\".github/images/automagik-tools-logo.svg\" alt=\"Automagik Tools Logo\" width=\"400\">\n</p>\n<h2 align=\"center\">From API to AI in 30 Seconds</h2>\n\n<p align=\"center\">\n <strong>\ud83c\udfaf The Bridge Between Your APIs and Intelligent AI Agents</strong><br>\n Transform any API into a smart MCP agent that learns, adapts, and speaks human<br>\n No code generation, no complex setup\u2014just instant intelligence\n</p>\n\n<p align=\"center\">\n <a href=\"https://github.com/namastexlabs/automagik-tools/actions\"><img alt=\"Build Status\" src=\"https://img.shields.io/github/actions/workflow/status/namastexlabs/automagik-tools/test.yml?branch=main&style=flat-square\" /></a>\n <a href=\"https://github.com/namastexlabs/automagik-tools/blob/main/LICENSE\"><img alt=\"License\" src=\"https://img.shields.io/github/license/namastexlabs/automagik-tools?style=flat-square&color=00D9FF\" /></a>\n <a href=\"https://discord.gg/xcW8c7fF3R\"><img alt=\"Discord\" src=\"https://img.shields.io/discord/1095114867012292758?style=flat-square&color=00D9FF&label=discord\" /></a>\n <a href=\"https://pypi.org/project/automagik-tools/\"><img alt=\"PyPI\" src=\"https://img.shields.io/pypi/v/automagik-tools?style=flat-square&color=00D9FF\" /></a>\n <a href=\"https://github.com/orgs/namastexlabs/projects/9/views/1?filterQuery=project%3Atools\"><img alt=\"Roadmap\" src=\"https://img.shields.io/badge/\ud83d\udccd_roadmap-view_initiatives-5319E7?style=flat-square\" /></a>\n</p>\n\n<p align=\"center\">\n <a href=\"#-key-features\">Features</a> \u2022\n <a href=\"#-quick-start\">Quick Start</a> \u2022\n <a href=\"#-built-in-tools\">Tools</a> \u2022\n <a href=\"https://github.com/orgs/namastexlabs/projects/9/views/1?filterQuery=project%3Atools\">Roadmap</a> \u2022\n <a href=\"#-contributing\">Contributing</a>\n</p>\n\n---\n\n## \ud83d\ude80 What is Automagik Tools?\n\n**Automagik Tools** is the MCP (Model Context Protocol) toolkit that transforms any API into an intelligent agent in seconds. Think of it as the universal translator between your systems and AI\u2014no coding required, just point to your API and start talking to it in natural language.\n\n### \ud83c\udfad The API Integration Problem\n\n**The Old Way**: Want your AI to talk to Stripe? Write 500 lines of integration code. Update the API? Rewrite everything. Need another API? Start from scratch. Hours turn into weeks, developers cry, budgets explode.\n\n**The Automagik Way**:\n\n```bash\n# One command. 30 seconds. Done.\nuvx automagik-tools openapi https://api.stripe.com/openapi.json\n```\n\nNow your AI can process payments, manage subscriptions, and handle refunds\u2014all in natural language.\n\n### \ud83d\udeab Why Traditional Integration Fails\n\nThe integration nightmare is real:\n- **Weeks of Development**: Each API needs custom code (2-4 weeks average)\n- **No Standardization**: Every team reinvents the wheel\n- **Maintenance Hell**: APIs change, everything breaks\n- **Zero Reusability**: Can't share work across projects\n- **Complex Deployment**: Getting it to production is a full-time job\n\n### \u2705 The Automagik Tools Solution\n\nWe flip the script completely:\n- \u26a1 **30 Seconds to Integration**: Point to OpenAPI spec, done\n- \ud83e\udde0 **Self-Learning Agents**: Remember your patterns, adapt to your workflow\n- \ud83d\udd04 **Universal Protocol**: One standard (MCP) for all integrations\n- \ud83c\udfaf **Zero Code**: No SDKs, no wrappers, just conversation\n- \ud83d\udce6 **Instant Deployment**: `uvx` = installed and running\n- \ud83d\udd0c **Plug & Play**: Works with Claude, Cursor, any MCP client\n- \ud83d\udcb0 **99% Cost Reduction**: R$ 45k \u2192 R$ 100 per integration\n\n---\n\n## \ud83c\udf1f Key Features\n\n- **\ud83d\udd27 Instant MCP Generation**: Any OpenAPI spec becomes an intelligent agent in seconds\n- **\ud83e\udde0 Self-Learning Intelligence**: Agents remember your patterns and improve with use\n- **\ud83d\udccb Markdown Processing**: GPT-4.1-nano cleans noisy JSON into readable output\n- **\ud83e\uddde Genie Orchestrator**: Connect and coordinate unlimited MCP servers with persistent memory\n- **\ud83e\udd16 Automagik Integration**: Native orchestration with Spark, Hive, Forge, and Omni\n- **\ud83d\udd04 Multiple Transports**: stdio for local, SSE for team sharing, HTTP for APIs\n- **\ud83d\udcf1 WhatsApp Automation**: Complete Evolution API integration built-in\n- **\ud83c\udfa8 Three Intelligence Modes**: Standard (precise), Markdown (readable), Genie (natural language)\n- **\ud83d\ude80 Zero Installation**: Run with `uvx` - no global install needed\n- **\ud83d\udd0c Universal Compatibility**: Works with Claude Code, Cursor, Cline, Roo, Gemini CLI\n- **\ud83d\udce6 Centralized Toolkit**: All your tools in one hub, versioned and standardized\n- **\ud83c\udfd7\ufe0f Plugin Architecture**: Drop tools in a folder, auto-discovered instantly\n- **100% Open Source**: MIT license, self-hostable, no vendor lock-in\n\n---\n\n## \ud83e\uddde Genie: Your Universal AI Conductor\n\nGenie is the crown jewel\u2014a meta-agent that orchestrates any MCP servers with persistent memory.\n\n### What Makes Genie Special?\n\n```bash\n# Start Genie with memory\nuvx automagik-tools tool genie -t sse --port 8000\n```\n\n**Connect Any MCP Servers**:\n```bash\nexport GENIE_MCP_CONFIGS='{\n \"agent-memory\": {\n \"url\": \"http://localhost:8001/sse\",\n \"transport\": \"sse\"\n },\n \"filesystem\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@modelcontextprotocol/server-filesystem\", \"/workspace\"],\n \"env\": {}\n },\n \"github\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-git\"],\n \"env\": {\"GITHUB_TOKEN\": \"your-token\"}\n }\n}'\n```\n\n**Now Tell Genie in Natural Language**:\n- \"Use memory to track my GitHub preferences, then analyze my repos and create weekly summaries\"\n- \"Coordinate between Slack and Linear to set up daily standups for the design team\"\n- \"Monitor competitor pricing with the trading API and remember my risk preferences\"\n\nGenie **learns your patterns**\u2014after a few interactions, it knows exactly how you like data formatted, which metrics matter, and when to alert you.\n\n---\n\n## \ud83d\udcf8 Real-World Magic\n\n### Stripe Payments in 30 Seconds\n```bash\nuvx automagik-tools openapi https://raw.githubusercontent.com/stripe/openapi/master/openapi/spec3.json\n\n# Now just talk to it:\n# \"Process a $100 payment for customer cus_123\"\n# \"Show me failed payments from last week\"\n# \"Create a subscription for Pro plan\"\n```\n\n### Discord Bot Without Code\n```bash\nuvx automagik-tools openapi \\\n https://raw.githubusercontent.com/discord/discord-api-spec/main/specs/openapi.json \\\n -t sse --port 8001\n\n# Natural language commands:\n# \"Schedule a voice call for 3pm in the dev channel\"\n# \"Find all threads mentioning the new feature\"\n# \"Show unread messages from the design team\"\n```\n\n### Your Internal API, AI-Ready\n```bash\n# Your company's API becomes conversational\nuvx automagik-tools openapi https://api.yourcompany.com/openapi.json\n\n# Team shares the same learning agent via SSE\n# Agent adapts to company terminology and workflows\n```\n\n---\n\n## \ud83d\udce1 MCP: Remote Control from Anywhere\n\nAutomagik Tools works with **any MCP-compatible client**\u2014Claude Code, Cursor, Cline, Roo, Gemini CLI\u2014you name it.\n\n### Typical Workflow\n\n1. **Point to API**: Give AutoMagik any OpenAPI spec\n2. **Deploy Agent**: Choose stdio (local) or SSE (team sharing)\n3. **Connect Client**: Add to Claude/Cursor/your favorite tool\n4. **Start Talking**: Natural language, the agent figures it out\n5. **Agent Learns**: Remembers your patterns, gets smarter\n\n### Example Use Cases\n\n- \ud83c\udfaf **\"Connect to our warehouse API and alert me when inventory drops below thresholds\"**\n- \ud83d\udc1b **\"Monitor production logs and categorize errors automatically\"**\n- \u2705 **\"Generate weekly sales reports and send to regional managers\"**\n- \ud83d\udccb **\"Track competitor prices and notify me of changes above 5%\"**\n\n### Available MCP Tools\n\n| Tool | Description | Use Case |\n|------|-------------|----------|\n| `genie` | Universal MCP orchestrator | Coordinate multiple tools with memory |\n| `automagik` | Automagik Suite integration | Orchestrate Spark, Hive, Forge, Omni |\n| `automagik-workflows` | Claude workflow execution | Run and monitor Claude Code workflows |\n| `evolution-api` | WhatsApp automation | Send/receive messages, media, groups |\n| `openapi` | Dynamic API agent | Any OpenAPI spec \u2192 instant agent |\n\n### Quick Setup\n\n<details>\n<summary><b>\ud83e\udd16 Claude Code Configuration</b></summary>\n\n1. Open Claude Code settings\n2. Navigate to MCP Servers section\n3. Add configuration:\n\n```json\n{\n \"mcpServers\": {\n \"automagik-tools\": {\n \"command\": \"uvx\",\n \"args\": [\n \"automagik-tools@latest\",\n \"serve\",\n \"--tool\",\n \"genie\",\n \"--transport\",\n \"stdio\"\n ],\n \"env\": {\n \"OPENAI_API_KEY\": \"your-openai-key\",\n \"GENIE_MCP_CONFIGS\": \"{\\\"your-mcp-config-here\\\":{}}\"\n }\n }\n }\n}\n```\n\n</details>\n\n<details>\n<summary><b>\ud83c\udfaf Cursor Configuration</b></summary>\n\n1. Open Cursor Settings (`Cmd/Ctrl + ,`)\n2. Search for \"MCP\"\n3. Add to `~/.cursor/mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"automagik-tools\": {\n \"command\": \"uvx\",\n \"args\": [\n \"automagik-tools@latest\",\n \"serve\",\n \"--tool\",\n \"automagik\",\n \"--transport\",\n \"stdio\"\n ],\n \"env\": {\n \"AUTOMAGIK_API_KEY\": \"your-key\",\n \"AUTOMAGIK_BASE_URL\": \"http://localhost:8881\"\n }\n }\n }\n}\n```\n\n</details>\n\n<details>\n<summary><b>\ud83d\udcdd VSCode + Cline Configuration</b></summary>\n\n1. Install Cline from VSCode marketplace\n2. Open Cline settings\n3. Add MCP server:\n\n```json\n{\n \"cline.mcpServers\": [\n {\n \"name\": \"automagik-tools\",\n \"command\": \"uvx\",\n \"args\": [\n \"automagik-tools@latest\",\n \"serve\",\n \"--openapi-url\",\n \"https://api.example.com/openapi.json\",\n \"--transport\",\n \"stdio\"\n ]\n }\n ]\n}\n```\n\n</details>\n\n<details>\n<summary><b>\ud83d\ude80 Roo Code Configuration</b></summary>\n\n1. Open Roo Code preferences\n2. Navigate to Extensions \u2192 MCP\n3. Add server:\n\n```yaml\nservers:\n automagik-tools:\n command: uvx\n args:\n - automagik-tools@latest\n - serve\n - --tool\n - genie\n - --transport\n - stdio\n environment:\n OPENAI_API_KEY: your-key\n```\n\n</details>\n\n<details>\n<summary><b>\ud83d\udc8e Gemini CLI Configuration</b></summary>\n\n1. Edit `~/.gemini/config.json`\n2. Add MCP server:\n\n```json\n{\n \"mcp\": {\n \"servers\": {\n \"automagik-tools\": {\n \"type\": \"stdio\",\n \"command\": \"uvx\",\n \"args\": [\n \"automagik-tools@latest\",\n \"serve\",\n \"--tool\",\n \"automagik\",\n \"--transport\",\n \"stdio\"\n ]\n }\n }\n }\n}\n```\n\n</details>\n\n<details>\n<summary><b>\ud83d\udd27 Generic MCP Configuration</b></summary>\n\nFor any MCP-compatible tool:\n\n```json\n{\n \"command\": \"uvx\",\n \"args\": [\n \"automagik-tools@latest\",\n \"serve\",\n \"--openapi-url\",\n \"YOUR_API_OPENAPI_URL\",\n \"--transport\",\n \"stdio\"\n ],\n \"env\": {\n \"OPENAI_API_KEY\": \"your-key\",\n \"API_CUSTOM_ENV\": \"your-value\"\n }\n}\n```\n\n</details>\n\n---\n\n## \ud83c\udfad From Chaos to Intelligence\n\n### The Evolution of API Integration\n\n```mermaid\ngraph LR\n A[Your API] --> B[AutoMagik Tools]\n B --> C[Intelligent MCP Agent]\n C --> D[Claude/Cursor/AI]\n D --> E[Natural Language Control]\n E --> F[Agent Learns & Adapts]\n F --> C\n```\n\n### Example: E-commerce Automation\n```bash\nYou: \"Set up my Shopify store as an AI agent\"\n\nYour Process:\n1. Get OpenAPI spec URL\n2. Run: uvx automagik-tools openapi https://shopify.dev/.../openapi.json\n3. Done! Now talk to your store:\n - \"Show me orders from last week with revenue > $500\"\n - \"Which products have low inventory?\"\n - \"Create a discount code for returning customers\"\n\nAgent learns your patterns:\n- Remembers your preferred date formats\n- Knows which metrics you care about\n- Adapts responses to your style\n```\n\n---\n\n## \ud83d\udce6 Quick Start\n\n### Prerequisites\n\n- Python 3.12+ (that's it!)\n- OpenAI API key (for intelligence features)\n- Your API's OpenAPI specification\n\n### Installation\n\n**Option 1: No Installation (Recommended)**\n```bash\n# Use uvx - run directly without installing\nuvx automagik-tools list\n```\n\n**Option 2: Global Install**\n```bash\npip install automagik-tools\n```\n\n**Option 3: Development**\n```bash\ngit clone https://github.com/namastexlabs/automagik-tools\ncd automagik-tools\nmake install\n```\n\n### First Run\n\n```bash\n# List all available tools\nuvx automagik-tools list\n\n# Run Genie orchestrator\nuvx automagik-tools tool genie --transport stdio\n\n# Convert any API to agent\nuvx automagik-tools openapi https://api.github.com/openapi.json\n\n# Run with team sharing (SSE)\nuvx automagik-tools tool automagik --transport sse --port 8000\n```\n\n### Environment Setup\n\nCreate `.env` file:\n\n```bash\n# OpenAI for intelligence\nOPENAI_API_KEY=sk-your-key\n\n# Automagik Suite integration (optional)\nAUTOMAGIK_API_KEY=your-key\nAUTOMAGIK_BASE_URL=http://localhost:8881\n\n# Enable Markdown processing (optional)\nENABLE_JSON_PROCESSING=true\nJSON_PROCESSOR_MODEL=gpt-4.1-nano\n```\n\n---\n\n## \ud83d\udee0\ufe0f Built-in Tools\n\n### \ud83e\uddde Genie - Universal Orchestrator\nYour AI conductor that coordinates any MCP servers with persistent memory.\n\n```bash\nuvx automagik-tools tool genie -t sse --port 8000\n```\n\n**Use Cases**:\n- Coordinate multiple tools for complex workflows\n- Remember context across all sessions\n- Natural language task orchestration\n- Team-wide shared intelligence\n\n### \ud83e\udd16 Automagik - Suite Integration\nNative integration with the Automagik ecosystem (Spark, Hive, Forge, Omni).\n\n```bash\nuvx automagik-tools tool automagik -t stdio\n```\n\n**Use Cases**:\n- Spawn agent swarms with Hive\n- Schedule recurring tasks with Spark\n- Manage development workflows with Forge\n- Send WhatsApp notifications via Omni\n\n### \ud83d\ude80 Automagik Workflows - Claude Execution\nExecute and monitor Claude Code workflows with real-time progress.\n\n```bash\nuvx automagik-tools tool automagik-workflows -t stdio\n```\n\n**Use Cases**:\n- Run Claude workflows programmatically\n- Track execution progress visually\n- List available workflows\n- Monitor workflow status\n\n### \ud83d\udcf1 Evolution API - WhatsApp Automation\nComplete WhatsApp Business automation via Evolution API.\n\n```bash\nuvx automagik-tools tool evolution-api -t stdio\n```\n\n**Use Cases**:\n- Send/receive messages and media\n- Manage groups and contacts\n- Handle status updates\n- Automate customer support\n\n### \ud83c\udf10 OpenAPI - Dynamic Agents\nTransform any OpenAPI spec into an instant intelligent agent.\n\n```bash\nuvx automagik-tools openapi https://api.example.com/openapi.json\n```\n\n**Use Cases**:\n- Any REST API with OpenAPI/Swagger\n- Internal company APIs\n- Third-party services\n- Legacy system integration\n\n---\n\n## \ud83d\udee0\ufe0f Development\n\nInterested in contributing or building custom tools?\n\n### Creating Your Own Tool\n\n```bash\n# 1. Create tool folder\nmkdir -p automagik_tools/tools/my_tool\n\n# 2. Implement FastMCP server\n# See docs/TOOL_CREATION_GUIDE.md for templates\n\n# 3. Register in pyproject.toml\n[project.entry-points.\"automagik_tools.plugins\"]\nmy_tool = \"automagik_tools.tools.my_tool\"\n\n# 4. Done! Auto-discovered\nuvx automagik-tools list\n```\n\n### Development Commands\n\n```bash\nmake install # Install with dev dependencies\nmake test # Run all tests\nmake lint # Check code quality\nmake format # Auto-format code\nmake build # Build package\n```\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.\n\n---\n\n## \ud83d\uddfa\ufe0f Roadmap\n\n### Completed \u2705\n- [x] Dynamic OpenAPI agent generation\n- [x] Genie universal orchestrator\n- [x] Multi-transport support (stdio, SSE, HTTP)\n- [x] Self-learning with memory\n- [x] Markdown output processing\n- [x] Evolution API (WhatsApp)\n- [x] Automagik Suite integration\n- [x] Plugin architecture\n\n### Next Up \ud83d\ude80 (Q4 2025 - Q1 2026)\n- [ ] **Smart Tools v1**: Specialized SLMs per tool for expert-level API knowledge\n- [ ] **Web UI**: Visual interface for managing and testing tools\n- [ ] **Marketplace Beta**: Community tool sharing platform\n- [ ] **5-Minute Creation**: Reduce tool creation from 30min to 5min\n- [ ] **Tool Templates**: Pre-built templates for common API patterns\n\n### Future Vision \ud83c\udf1f (2026-2027)\n- [ ] **Auto-Learning**: Tools improve themselves based on usage patterns\n- [ ] **Auto-Discovery**: Connect to APIs without OpenAPI specs\n- [ ] **Self-Maintenance**: Agents maintain their own code\n- [ ] **Visual Builder**: Drag-and-drop tool creation\n- [ ] **Enterprise Cloud**: Fully managed SaaS offering\n- [ ] **Global Marketplace**: Buy/sell community tools\n\n---\n\n## \ud83e\udd1d Contributing\n\nWe love contributions! However, to maintain project coherence:\n\n1. **Discuss First**: Open an issue before starting work\n2. **Align with Roadmap**: Ensure changes fit our vision\n3. **Follow Standards**: Match existing code patterns\n4. **Test Thoroughly**: Include tests for new features\n5. **Document Well**: Update docs with your changes\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.\n\n---\n\n## \ud83d\ude4f Acknowledgments\n\nSpecial thanks to:\n- [Anthropic](https://anthropic.com) for creating MCP\n- [FastMCP](https://github.com/jlowin/fastmcp) for the awesome framework\n- Our amazing community of early adopters and contributors\n- Every developer who's ever cursed at API documentation\n\n---\n\n## \ud83d\udcc4 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n---\n\n## \ud83d\udd17 Links\n\n- **GitHub**: [github.com/namastexlabs/automagik-tools](https://github.com/namastexlabs/automagik-tools)\n- **PyPI**: [pypi.org/project/automagik-tools](https://pypi.org/project/automagik-tools)\n- **Discord**: [discord.gg/xcW8c7fF3R](https://discord.gg/xcW8c7fF3R)\n- **Twitter**: [@namastexlabs](https://twitter.com/namastexlabs)\n- **DeepWiki Docs**: [deepwiki.com/namastexlabs/automagik-tools](https://deepwiki.com/namastexlabs/automagik-tools)\n\n---\n\n<p align=\"center\">\n <strong>\ud83d\ude80 Stop writing integrations. Start having conversations.</strong><br>\n <strong>Every API becomes an intelligent agent that learns how you work.</strong><br><br>\n <a href=\"https://github.com/namastexlabs/automagik-tools\">Star us on GitHub</a> \u2022\n <a href=\"https://discord.gg/xcW8c7fF3R\">Join our Discord</a>\n</p>\n\n<p align=\"center\">\n Made with \u2764\ufe0f by <a href=\"https://namastex.ai\">Namastex Labs</a><br>\n <em>AI that elevates human potential, not replaces it</em>\n</p>\n\n<p align=\"center\">\n <a href=\"https://mseep.ai/app/namastexlabs-automagik-tools\"><img src=\"https://mseep.net/pr/namastexlabs-automagik-tools-badge.png\" alt=\"MseeP.ai Security Assessment Badge\"></a><br>\n <a href=\"https://deepwiki.com/namastexlabs/automagik-tools\"><img src=\"https://deepwiki.com/badge.svg\" alt=\"Ask DeepWiki\"></a>\n</p>\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A monorepo package for MCP tools with dynamic loading capabilities - featuring Evolution API v2 WhatsApp integration",
"version": "0.9.9",
"project_urls": {
"Documentation": "https://github.com/namastexlabs/automagik-tools/README.md",
"Homepage": "https://github.com/namastexlabs/automagik-tools",
"Issues": "https://github.com/namastexlabs/automagik-tools/issues",
"Repository": "https://github.com/namastexlabs/automagik-tools"
},
"split_keywords": [
"mcp",
" tools",
" ai",
" agents",
" fastmcp",
" whatsapp",
" discord",
" notion"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "2b017bf930d0e1ad0a078dd837f7a2b600578b9d7d9095abe588ebfecdf1f8ca",
"md5": "4bd62b8c42cef052868b5e2042c55946",
"sha256": "542bebc0b98a4010af088957d14d266e4db444b6323540fe16bd50e01817b3a5"
},
"downloads": -1,
"filename": "automagik_tools-0.9.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4bd62b8c42cef052868b5e2042c55946",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 110481,
"upload_time": "2025-11-01T00:04:22",
"upload_time_iso_8601": "2025-11-01T00:04:22.398918Z",
"url": "https://files.pythonhosted.org/packages/2b/01/7bf930d0e1ad0a078dd837f7a2b600578b9d7d9095abe588ebfecdf1f8ca/automagik_tools-0.9.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "7e9e6f1955592be6f8abde70773ababb7a1b6d0cee187644464f12c17ed6dfbd",
"md5": "9000d76c00d898883ddf0ac6d7377703",
"sha256": "5d2f6339a1f76b0e560703b56491b8e57715a15f18e0e459ac27e1f14a1a3c1e"
},
"downloads": -1,
"filename": "automagik_tools-0.9.9.tar.gz",
"has_sig": false,
"md5_digest": "9000d76c00d898883ddf0ac6d7377703",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 114314,
"upload_time": "2025-11-01T00:04:24",
"upload_time_iso_8601": "2025-11-01T00:04:24.160816Z",
"url": "https://files.pythonhosted.org/packages/7e/9e/6f1955592be6f8abde70773ababb7a1b6d0cee187644464f12c17ed6dfbd/automagik_tools-0.9.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-11-01 00:04:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "namastexlabs",
"github_project": "automagik-tools",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "automagik-tools"
}
