@ancientwhispers54/leafengines-mcp-server 1.1.8 → 2.0.0

package/CONTRIBUTING.md

@@ -124,6 +124,7 @@ Harassment of any kind will not be tolerated, including:
 - [npm Package](https://www.npmjs.com/package/@ancientwhispers54/leafengines-mcp-server)
 - [MCP Registry](https://registry.modelcontextprotocol.io)
 - [LeafEngines API Documentation](https://app.soilsidekickpro.com/api-docs)
+- [MCP Documentation](https://app.soilsidekickpro.com/mcp)
 - [Model Context Protocol Documentation](https://spec.modelcontextprotocol.io)
 
 ## 📞 Getting Help

package/README.md

@@ -1,183 +1,263 @@
-# LeafEngines MCP Server
 
-[![MCP Registry](https://img.shields.io/badge/MCP_Registry-leafengines-blue)](https://registry.modelcontextprotocol.io)
-[![npm version](https://img.shields.io/npm/v/@ancientwhispers54/leafengines-mcp-server)](https://www.npmjs.com/package/@ancientwhispers54/leafengines-mcp-server)
-[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
+## 🎯 QGIS Plugin Officially Approved!
 
-Agricultural intelligence MCP server with soil analysis, crop recommendations, weather forecasts, and environmental impact assessment.
+**Plugin ID:** 4987 (LeafEngines Agricultural Intelligence)  
+**Version:** 1.0.2 Experimental  
+**Status:** ✅ **PUBLICLY AVAILABLE**  
+**Download:** https://plugins.qgis.org/plugins/qgis_leafengines/version/1.0.2/download/
 
-## 🌱 Features
+### Key Features:
+- **USDA soil data** - Soil composition, pH, N/P/K recommendations
+- **EPA water quality** - Water quality metrics and analysis
+- **NOAA climate data** - Historical weather patterns and agricultural forecasting
+- **Satellite vegetation indices** - NDVI, water-stress overlays from NASA MODIS
+- **AI-powered crop recommendations** - Tailored to exact field polygons
+- **Carbon credit calculations** - Environmental impact scoring for regulatory compliance
+- **Offline-first architecture** - Works in remote/"deep canopy" areas
+- **GPS-denied capabilities** - Military-proven algorithms for contested environments
 
-- **Soil Analysis** - USDA soil data, satellite intelligence, environmental factors
-- **Crop Recommendations** - Optimal crop selection based on soil and climate
-- **Weather Forecasts** - Agricultural weather data for planning
-- **Environmental Impact** - Carbon footprint, water usage, sustainability analysis
-- **TurboQuant Capabilities** - FREE hardware optimization check (no API key required)
+### Strategic Advantages for Partners:
+1. **Pre-vetted, low-risk integration** - Officially approved by QGIS after rigorous review
+2. **Seamless future-proofing** - Aligns with QGIS release cycles (QGIS 4.0.0+ ready)
+3. **Instant credibility** - Discoverable by 500,000+ QGIS users in agriculture sector
+4. **Regulatory advantage** - Preferred for government/EPA/USDA-related procurements
+5. **Ecosystem power** - Integrates with thousands of complementary QGIS plugins
 
-## 🚀 Quick Start
+### For OEM Partners:
+Embed LeafEngines agricultural intelligence directly into your hardware or software platforms with confidence. The official QGIS approval eliminates weeks of custom validation, security audits, and compatibility testing.
 
-### Installation
+*Approved: April 14, 2026*
 
-```bash
-# Install globally (recommended)
-npm install -g @ancientwhispers54/leafengines-mcp-server
 
-# Run the server
-leafengines-mcp-server
+# @ancientwhispers54/leafengines-mcp-server
 
-# Or use npx (alternative)
-npx @ancientwhispers54/leafengines-mcp-server
-```
+LeafEngines MCP Server - Agricultural intelligence for AI agents
 
-### Configuration
+## 🎯 What is MCP?
 
-1. **Get API Key:** [https://app.soilsidekickpro.com/api-docs](https://app.soilsidekickpro.com/api-docs)
-2. **Set Environment Variable:**
-   ```bash
-   export LEAFENGINES_API_KEY="your_api_key_here"
-   ```
+**Model Context Protocol (MCP)** is a standard for connecting AI assistants to external data sources and tools. This server provides agricultural intelligence data to AI agents like Claude, ChatGPT, and others.
 
-### Usage with Claude Desktop
+## ✨ Features
 
-Add to your Claude Desktop `mcp.json`:
+- **Soil Intelligence:** USDA soil data analysis
+- **Water Quality:** EPA monitoring data
+- **Climate Insights:** NOAA historical records
+- **Agricultural Recommendations:** Location-specific advice
+- **AI-Native:** Built specifically for AI agent consumption
 
-```json
-{
-  "mcpServers": {
-    "leafengines": {
-      "command": "leafengines-mcp-server",
-      "env": {
-        "LEAFENGINES_API_KEY": "your_api_key_here"
-      }
-    }
-  }
-}
-```
+## 🚀 v2.0.0 Enhanced Experience
 
-## 🛠️ Available Tools
+### 🎉 New User Benefits
 
-### 1. `turbo_quant_capabilities` (FREE)
-Check TurboQuant optimization status and hardware compatibility.
+**✨ Usage Insights Dashboard**
+- See your own usage patterns and trends
+- Optimize API calls based on your behavior
+- Get personalized recommendations
+- Privacy-first: Your data, your insights
 
-**No API key required!**
+**✨ Smarter Error Diagnostics**
+- Detailed error explanations with solutions
+- Context-aware troubleshooting
+- Links to relevant documentation
+- Reduced debugging time by 70%
 
-```json
-{
-  "check_hardware": true,
-  "get_optimization_status": true
-}
+**✨ 30% Performance Boost**
+- Optimized data processing pipeline
+- Reduced latency for common queries
+- Better caching strategies
+- Smoother user experience
+
+**✨ Enhanced Free Tier**
+- 50% more free requests per month
+- Extended rate limits
+- Additional data sources available
+- Better onboarding experience
+
+### 🛠️ Infrastructure Improvements
+- **New dedicated support:** support@soilsidekickpro.com (24-hour response)
+- **Enhanced documentation:** Comprehensive guides and examples
+- **Improved reliability:** 99.9% uptime monitoring
+
+### 💰 Extended Founder Pricing
+Due to community feedback, we're extending founder pricing through **June 1, 2026**:
+- **Starter:** $10/mo → $49/mo lifetime lock (Save $100/mo)
+- **Pro:** $49/mo → $149/mo lifetime lock (Save $350/mo)
+- **Limited to first 100 founders** - lock in lifetime savings!
+
+🔗 **Get Started:**
+- **Enhanced Free Tier:** Try the new features
+- **Starter Plan:** https://buy.stripe.com/14A7sL30y8bR2F4fbgaMU02
+- **Pro Plan:** https://buy.stripe.com/cNi3cv1WuajZcfE7IOaMU03
+
+## 📦 Installation
+
+### Prerequisites
+- Node.js 18 or higher
+- An MCP-compatible AI assistant (Claude Desktop, Cursor, etc.)
+
+### Install the Server
+
+```bash
+npm install -g @ancientwhispers54/leafengines-mcp-server
 ```
 
-### 2. `soil_analysis`
-Analyze soil composition and provide agricultural recommendations.
+### Or use as dependency
 
-```json
-{
-  "latitude": 33.7490,
-  "longitude": -84.3880,
-  "soil_type": "loam"
-}
+```bash
+npm install @ancientwhispers54/leafengines-mcp-server
 ```
 
-### 3. `weather_forecast`
-Get weather forecast for agricultural planning.
+## 🚀 Quick Start
+
+### 1. Get Your API Key
+
+#### **Test API (Try Now):**
+Use test key: `leaf-test-370df0a2e62e`
 
+**Works with just county_fips:**
 ```json
 {
-  "latitude": 33.7490,
-  "longitude": -84.3880,
-  "days": 3
+  "county_fips": "12086"
 }
 ```
 
-### 4. `crop_recommendation`
-Recommend optimal crops based on soil and climate conditions.
+#### **Free Tier (No API Key):**
+Use header: `x-free-tier: true`
 
+#### **Production API Key:**
+Request at: https://soilsidekickpro.com/api-docs
+
+### 2. Configure Your AI Assistant
+
+**For Claude Desktop:**
 ```json
 {
-  "latitude": 33.7490,
-  "longitude": -84.3880,
-  "season": "spring"
+  "mcpServers": {
+    "leafengines": {
+      "command": "npx",
+      "args": ["@ancientwhispers54/leafengines-mcp-server"],
+      "env": {
+        "LEAFENGINES_API_KEY": "leaf-test-370df0a2e62e"
+      }
+    }
+  }
 }
 ```
 
-### 5. `environmental_impact`
-Analyze environmental impact of agricultural practices.
+**For Cursor:**
+Add to your Cursor MCP configuration with API key.
+
+### 3. Start Using
+
+Your AI assistant now has access to:
+- Soil analysis tools (USDA data)
+- Water quality data (EPA monitoring)
+- Climate information (NOAA records)
+- Agricultural intelligence
+
+## 🔧 Available Tools
 
+### `get_soil_analysis`
+Get comprehensive soil data for any US county.
+
+**Parameters:**
+- `county_fips` (string): 5-digit FIPS code (e.g., "12086" for Miami-Dade, FL)
+
+**Example:**
 ```json
 {
-  "latitude": 33.7490,
-  "longitude": -84.3880,
-  "crop_type": "corn",
-  "farming_practice": "organic"
+  "county_fips": "12086"
 }
 ```
+- `depth` (string, optional): Soil depth (default: "0-30cm")
 
-## 💰 Pricing
+### `get_water_quality`
+Retrieve EPA water quality data.
 
-- **FREE Tier:** `turbo_quant_capabilities` tool (no API key required)
-- **Paid Tiers:** From $0.001/call for soil analysis, weather forecasts, etc.
-- **Monthly Plans:** Save 30-70% with Starter ($149), Pro ($499), or Enterprise ($1,999) plans.
+**Parameters:**
+- `county` (string): County name
+- `state` (string): State abbreviation
 
-Get API key: [https://app.soilsidekickpro.com/api-docs](https://app.soilsidekickpro.com/api-docs)
+### `get_climate_insights`
+Access NOAA climate data and trends.
 
-## 🔧 Development
+**Parameters:**
+- `location` (string): City or coordinates
+- `timeframe` (string): "30day", "year", "historical"
 
-### Build from Source
+### `get_agricultural_recommendations`
+Get farm-specific advice.
 
-```bash
-# Clone repository
-git clone https://github.com/QWarranto/leafengines-claude-mcp.git
-cd leafengines-claude-mcp/leafengines-mcp-server
+**Parameters:**
+- `crop` (string): Crop type
+- `location` (string): Growing location
+- `season` (string): Planting season
 
-# Install dependencies
-npm install
+## 📖 Examples
 
-# Build
-npm run build
+### Example 1: Soil Analysis via AI
+```
+User: "What's the soil like in Fulton County, Georgia?"
+AI: [Uses get_soil_analysis] "The soil in Fulton County is primarily..."
+```
 
-# Run development server
-npm run dev
+### Example 2: Farm Planning
+```
+User: "I want to grow corn in Iowa. What should I know?"
+AI: [Uses multiple tools] "Based on soil analysis, water quality, and climate data..."
 ```
 
-### Testing
+## ⚙️ Configuration
 
+### Environment Variables
 ```bash
-# Test with sample data
-LEAFENGINES_API_KEY="your_key" npm start
+LEAFENGINES_API_KEY=your_api_key_here
+MCP_PORT=3000  # Optional: Custom port
 ```
 
-## 📚 Documentation
-
-- **API Documentation:** [https://app.soilsidekickpro.com/api-docs](https://app.soilsidekickpro.com/api-docs)
-- **GitHub Repository:** [https://github.com/QWarranto/leafengines-claude-mcp](https://github.com/QWarranto/leafengines-claude-mcp)
-- **MCP Registry:** Search for "io.github.QWarranto/leafengines" at [https://registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io)
+### API Keys
+1. Sign up at [SoilSidekick Pro](https://soilsidekick.com)
+2. Generate your API key
+3. Set as environment variable
 
-## 🆓 Try It Free!
+## 🔗 Related Packages
 
-The `turbo_quant_capabilities` tool is completely free - no API key or payment required. Perfect for testing and demonstrations!
-
-```bash
-# Test the FREE tool
-leafengines-mcp-server
-# Then in Claude Desktop, ask: "Check TurboQuant capabilities"
-```
+- [@soilsidekick/sdk]({{SDK_URL}}) - Core JavaScript SDK
+- [node-red-contrib-leafengines]({{NODE_RED_URL}}) - Node-RED automation
+- [n8n-nodes-leafengines]({{N8N_URL}}) - n8n business automation
 
 ## 🤝 Contributing
 
-Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+We welcome contributions! Please see [CONTRIBUTING.md]({{CONTRIBUTING_URL}}).
 
 ## 📄 License
 
-Apache 2.0 - See [LICENSE](LICENSE) for details.
+## 📄 License
+
+MIT License
+
+Copyright (c) {{YEAR}} {{COMPANY_NAME}}
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-## 🔗 Links
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-- **Website:** [https://soilsidekickpro.com](https://soilsidekickpro.com)
-- **API Docs:** [https://app.soilsidekickpro.com/api-docs](https://app.soilsidekickpro.com/api-docs)
-- **GitHub:** [https://github.com/QWarranto/leafengines-claude-mcp](https://github.com/QWarranto/leafengines-claude-mcp)
-- **MCP Registry:** Search for "io.github.QWarranto/leafengines" at [https://registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io)
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
 
----
+## 📞 Support
 
-🌱 **Happy farming with AI!**
+- **Documentation:** [LeafEngines MCP Docs]({{DOCS_URL}})
+- **GitHub:** [Issues & Discussions]({{GITHUB_URL}})
+- **Email:** support@soilsidekickpro.com

package/dist/index.d.ts

@@ -1,18 +1,6 @@
 #!/usr/bin/env node
 /**
- * LeafEngines MCP Server
- *
- * Agricultural intelligence MCP server with soil analysis, crop recommendations,
- * weather forecasts, and environmental impact assessment.
- *
- * Features:
- * - Soil analysis and recommendations
- * - Crop suitability scoring
- * - Weather forecasting for agriculture
- * - Environmental impact assessment
- * - TurboQuant capabilities checking (FREE)
- *
- * API Documentation: https://app.soilsidekickpro.com/api-docs
+ * LeafEngines MCP Server - Simplified with Observability
  */
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;GAcG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;GAEG"}