# 🧠 Pollinations Think MCP Server

An advanced Model Context Protocol (MCP) server that provides sophisticated thinking and analysis capabilities using the Pollinations AI API with DeepSeek reasoning models.

## 🌟 Features

- **🎯 Advanced Strategic Thinking**: Multi-cycle analysis with contradiction detection and synthesis
- **🔄 Flexible Model Support**: DeepSeek reasoning, OpenAI reasoning, and other advanced models
- **🛡️ Robust Error Handling**: Comprehensive retry logic and graceful degradation
- **⚙️ Configurable Parameters**: Customizable thinking cycles, timeouts, and model selection
- **📊 Health Monitoring**: Built-in health checks and status monitoring
- **☁️ Cloud Deployment Ready**: Optimized for Smithery.ai deployment to resolve network issues

## 🛠️ Available Tools

### 1. `think`
Advanced strategic thinking and analysis using openai-reasoning model.

**Parameters:**
- `text` (required): The topic, question, or problem to analyze
- `model` (optional): AI model to use (default: openai-reasoning)
- `seed` (optional): Random seed for reproducible results
- `maxCycles` (optional): Maximum thinking cycles (default: 3, max: 5)

**Example:**
```json
{
  "name": "think",
  "arguments": {
    "text": "Should a startup focus on growth or profitability first?",
    "maxCycles": 3
  }
}
```

### 2. `search`
Search the web in real-time using SearchGPT model.

**Parameters:**
- `query` (required): The search query to find information on the web

**Example:**
```json
{
  "name": "search",
  "arguments": {
    "query": "latest AI developments 2024"
  }
}
```

### 3. `continue_thinking`
Continue receiving the next part of a large thinking response.

**Parameters:** None

**Example:**
```json
{
  "name": "continue_thinking",
  "arguments": {}
}
```

## 🚀 Installation

1. **Clone the repository:**
   ```bash
   git clone <repository-url>
   cd pollinations-think-mcp
   ```

2. **Install dependencies:**
   ```bash
   npm install
   ```

3. **Start the server:**
   ```bash
   npm start
   ```

## 🧪 Testing

### Run Basic Tests
```bash
npm test
```

### Test Search Functionality
```bash
node test-search.js
```

### Manual API Testing
Test the SearchGPT endpoint directly:
```bash
# PowerShell
(Invoke-WebRequest -Uri 'https://text.pollinations.ai/your query here/?model=searchgpt' -Method Get).Content
```

## 📋 API Endpoints Used

### Thinking (OpenAI Reasoning)
- **URL**: `https://text.pollinations.ai/{prompt}/?model=openai-reasoning&token=`
- **Method**: GET
- **Purpose**: Advanced reasoning and strategic analysis

### Search (SearchGPT)
- **URL**: `https://text.pollinations.ai/{prompt}/?model=searchgpt&token=`
- **Method**: GET
- **Purpose**: Real-time web search and current information retrieval

## 🔧 Configuration

### MCP Client Setup
Add to your MCP client configuration:

```json
{
  "mcpServers": {
    "pollinations-think": {
      "command": "node",
      "args": ["/path/to/pollinations-think-mcp/index.js"]
    }
  }
}
```

### Environment Variables
No environment variables required - the server uses public Pollinations.ai endpoints.

## 📊 Response Handling

### Large Response Management
- Responses exceeding ~30KB are automatically split
- Use `continue_thinking` tool to get subsequent parts
- Continuation data is maintained across calls

### Error Handling
- Comprehensive error messages for debugging
- Graceful fallbacks for API failures
- Detailed logging for troubleshooting

## 🎯 Use Cases

### Strategic Thinking
- Business strategy development
- Problem-solving and decision making
- Risk assessment and mitigation planning
- Innovation and opportunity analysis

### Web Search
- Current events and news research
- Market research and competitive analysis
- Technical documentation lookup
- Real-time data verification

## 🔍 Example Outputs

### Think Tool Response
```
# 🧠 Advanced Strategic Thinking Analysis

## 📋 Analysis Overview
- Topic: Should a startup focus on growth or profitability first?
- Thinking Cycles: 3
- Analysis Depth: Advanced Multi-Layer Cognitive Processing

## 🎯 Strategic Analysis
[Comprehensive strategic framework with executive summary, 
risk mitigation, success metrics, and next steps]

## 🔬 Meta-Cognitive Assessment
[Quality assessment and thinking process evaluation]
```

### Search Tool Response
```
# 🔍 Web Search Results: latest AI developments 2024

## Recent AI Developments:
- [Trump plans executive orders to power AI growth](https://reuters.com/...)
- [Nvidia CES 2025 keynote highlights](https://apnews.com/...)
- [OpenAI's AGI roadmap for 2025](https://time.com/...)

[Detailed search results with sources and current information]
```

## 🛡️ Security

- Uses public API endpoints (no authentication required)
- No sensitive data storage
- Input validation and sanitization
- Safe error handling

## 📝 Version History

### v2.0.0
- ✅ Added real-time web search with SearchGPT
- ✅ Enhanced thinking engine with meta-cognitive assessment
- ✅ Improved response handling for large outputs
- ✅ Comprehensive testing suite

### v1.0.0
- Initial release with strategic thinking capabilities
- DeepSeek reasoning integration
- Basic MCP server implementation

## 🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Submit a pull request

## 📄 License

MIT License - see LICENSE file for details.

## 🙏 Acknowledgments

- [Pollinations.ai](https://pollinations.ai) for providing the AI API endpoints
- [Model Context Protocol](https://modelcontextprotocol.io) for the MCP framework
- DeepSeek for the reasoning model
- SearchGPT for real-time web search capabilities

---

**Made with ❤️ for the MCP community**