# π§ 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**