# Competitive Intelligence & Daily Planning MCP Tool
A FastMCP server that provides AI-powered competitive intelligence and daily planning capabilities.
## Features
### Competitive Intelligence
- Automated monitoring of competitor activities
- News aggregation from multiple sources
- AI-powered analysis and summarization
- Structured report generation
- Focus on key areas (pricing, product launches, partnerships)
### Daily Planning
- Calendar integration with OAuth authentication
- Task prioritization based on multiple factors
- Time-blocking and schedule optimization
- Identification of 2-3 most impactful daily activities
- Contextual recommendations
## Installation
1. Clone the repository:
```bash
git clone https://github.com/yourusername/competitive-intelligence-mcp.git
cd competitive-intelligence-mcp
```
2. Create and activate virtual environment:
```bash
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
```
3. Install dependencies:
```bash
pip install -r requirements.txt
```
4. Configure environment variables:
```bash
cp .env.example .env
# Edit .env with your actual API keys and configuration
```
## Configuration
Edit the `.env` file with your settings:
```bash
# API Keys
NEWS_API_KEY=your_news_api_key_here
# Google Calendar OAuth
GOOGLE_CLIENT_ID=your_google_client_id_here
GOOGLE_CLIENT_SECRET=your_google_client_secret_here
# Jira API
JIRA_API_TOKEN=your_jira_api_token_here
JIRA_DOMAIN=your_domain.atlassian.net
# Asana API
ASANA_API_TOKEN=your_asana_api_token_here
# Configuration
DEFAULT_COMPETITORS=competitor1,competitor2,competitor3
DEFAULT_FOCUS_AREAS=pricing,product_launches,partnerships
DEFAULT_CALENDAR_SOURCE=google
```
## Usage
### Running the Server
Start the FastMCP server:
```bash
python src/server.py
```
### Using with Cursor
Add to your Cursor MCP configuration:
```json
{
"mcpServers": {
"competitive-intelligence": {
"command": "python",
"args": ["src/server.py"]
}
}
}
```
## Available Tools
### Competitive Intelligence Tools
#### `get_competitive_intelligence`
Gather competitive intelligence for specified competitors.
**Parameters:**
- `competitors` (required): List of competitor names to monitor
- `date_range` (optional): Date range for analysis (default: last 24 hours)
- `focus_areas` (optional): Specific areas to focus on
**Example:**
```python
get_competitive_intelligence(
competitors=["CompetitorA", "CompetitorB"],
focus_areas=["pricing", "product_launches"]
)
```
### Daily Planning Tools
#### `create_daily_plan`
Create a focused daily plan based on calendar, tasks, and priorities.
**Parameters:**
- `calendar_source` (optional): Calendar service to use (google, outlook)
- `task_sources` (optional): Task management systems to integrate (jira, asana, email)
- `focus_areas` (optional): Areas to prioritize (strategic, operational, learning)
- `time_available_hours` (optional): Available hours for the day
**Example:**
```python
create_daily_plan(
calendar_source="google",
task_sources=["jira", "email"],
focus_areas=["strategic", "operational"],
time_available_hours=8
)
```
#### `schedule_morning_intelligence`
Schedule automated morning intelligence gathering and daily planning.
**Parameters:**
- `time` (optional): Time to run automation (HH:MM format)
- `competitors` (optional): List of competitors to monitor
- `calendar_source` (optional): Calendar service for daily planning
**Example:**
```python
schedule_morning_intelligence(
time="06:00",
competitors=["CompetitorA", "CompetitorB"],
calendar_source="google"
)
```
## Development
### Running Tests
```bash
pytest tests/
```
### Code Formatting
```bash
black src/ tests/
isort src/ tests/
```
### Type Checking
```bash
mypy src/
```
## API Setup
### News API
1. Sign up at [NewsAPI.org](https://newsapi.org/)
2. Get your API key
3. Add to `.env` file as `NEWS_API_KEY`
### Google Calendar API
1. Go to [Google Cloud Console](https://console.cloud.google.com/)
2. Create a new project
3. Enable Google Calendar API
4. Create OAuth 2.0 credentials
5. Add to `.env` file as `GOOGLE_CLIENT_ID` and `GOOGLE_CLIENT_SECRET`
### Jira API
1. Get API token from your Jira instance
2. Add to `.env` file as `JIRA_API_TOKEN`
3. Set your domain in `.env` as `JIRA_DOMAIN`
### Asana API
1. Get API token from Asana
2. Add to `.env` file as `ASANA_API_TOKEN`
## Deployment
### FastMCP Cloud
Deploy to FastMCP Cloud for easy access:
```bash
# Configure FastMCP Cloud credentials
export FASTMCP_CLOUD_TOKEN=your_token_here
# Deploy
fastmcp deploy src/server.py
```
### Self-Hosted
Run with HTTP transport:
```bash
python src/server.py --transport http --host 0.0.0.0 --port 8000
```
## License
MIT License - see LICENSE file for details.
