Warframe MCP Server
A Model Context Protocol (MCP) server for Warframe that provides intelligent recommendations based on your account data, current world state, and market conditions.
Features
- Account Integration: Connect your Warframe account via Alecaframe API to access your inventory, relics, and progress
- World State Awareness: Real-time data on current events, rotations, vault status, and invasions
- Market Intelligence: Integration with Warframe.market for trading insights and pricing
- Smart Recommendations: Answer questions like:
- "Which prime parts should I farm now?"
- "What standing should I focus on?"
- "Best way to gain credits based on current events?"
- "What relics are most valuable right now?"
- "Is Baro here and what's he selling?"
- "What's the market price for [item]?"
Available Tools
The MCP server provides 10 powerful tools:
Recommendations
- recommend_prime_farming - Get personalized prime part farming recommendations
- recommend_standing_farming - Find the best syndicate standing opportunities
- recommend_credit_farming - Optimize your credit farming strategy
World State & Events
- get_world_state - View current game state, events, and cycles
- get_baro_status - Check Baro Ki'Teer's location and inventory
- get_varzia_status - View Prime Resurgence rotation and schedule
Market Data
- get_market_price - Look up item prices on warframe.market
- search_market_items - Search for tradeable items
Your Account (Requires Alecaframe)
- get_my_relics - View your personal relic inventory with counts and refinement levels
- get_my_stats - View your trading statistics and account metrics
See USAGE.md for detailed documentation and examples.
Setup
Prerequisites
- Go 1.21 or higher
- (Optional) Warframe account with Alecaframe integration for personalized relic recommendations
Configuration
The server supports three configuration methods (in order of precedence):
Option 1: Environment Variables (Recommended for MCP)
Set environment variables in your MCP server configuration:
- ALECAFRAME_USER_HASH - Your Alecaframe user hash
- ALECAFRAME_PUBLIC_TOKEN - Your Alecaframe public token
This is the easiest method when using with Claude Desktop or other MCP clients.
Option 2: Config File
Create a config.json in one of these locations:
- Current directory: ./config.json
- Home directory: ~/.config/warframe-mcp/config.json
- System: `/etc/warframe-mcp/config.json````json
{
"alecaframe": {
"publicToken": "your-public-token-here"
},
"cache": {
"worldStateTTL": 300,
"marketDataTTL": 600
}
}
See `config.example.json` for a template.
**Option 3: No Configuration**
The server will work without any configuration, but Alecaframe features (personalized relic inventory) will be disabled.
**Testing Alecaframe Integration:**
If you're having issues with Alecaframe tools (404 or 401 errors), see TESTING_ALECAFRAME.md for a comprehensive testing guide including:
- Automated endpoint discovery tool
- Manual curl testing commands
- Troubleshooting common issues
### Installation
**On macOS/Linux:**```bash
go build -o warframe-mcp
On Windows (PowerShell or Command Prompt):```powershell
go build -o warframe-mcp.exe
> 📝 **Windows Users:** See WINDOWS_SETUP.md for a complete step-by-step Windows setup guide with troubleshooting tips.
### Usage with Claude Desktop
Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS, `%APPDATA%\Claude\claude_desktop_config.json` on Windows):
**Option 1: Basic Setup (No Alecaframe)**
macOS/Linux:```json
{
"mcpServers": {
"warframe": {
"command": "/absolute/path/to/warframe-mcp"
}
}
}
Windows:```json
{
"mcpServers": {
"warframe": {
"command": "C:\Users\YourUsername\path\to\warframe-mcp.exe"
}
}
}
**Option 2: With Alecaframe Credentials (Recommended)**
macOS/Linux:```json
{
"mcpServers": {
"warframe": {
"command": "/absolute/path/to/warframe-mcp",
"env": {
"ALECAFRAME_USER_HASH": "your-user-hash-here",
"ALECAFRAME_PUBLIC_TOKEN": "your-public-token-here"
}
}
}
}
Windows:```json
{
"mcpServers": {
"warframe": {
"command": "C:\Users\YourUsername\path\to\warframe-mcp.exe",
"env": {
"ALECAFRAME_USER_HASH": "your-user-hash-here",
"ALECAFRAME_PUBLIC_TOKEN": "your-public-token-here"
}
}
}
}
To get your credentials:
1. Go to Alecaframe and link your Warframe account if you haven't already
2. Navigate to the "Stats" tab on Alecaframe
3. Click on the "Data export & API" button
4. Click "Copy my API token" - this is your `ALECAFRAME_USER_HASH` (keep this private!)
5. For `ALECAFRAME_PUBLIC_TOKEN`: Location currently unknown - check Alecaframe documentation or contact support
6. Add both credentials to the `env` section above
Restart Claude Desktop, and you'll see the Warframe tools available in conversations!
### Quick Start
Once configured, try asking Claude:
- "What should I farm in Warframe right now?"
- "Is Baro here and what's worth buying?"
- "What's the best way to get credits today?"
- "Show me the current world state"
See USAGE.md for more examples and detailed usage instructions.
## How It Works
The Warframe MCP server integrates multiple Warframe community APIs to provide comprehensive, context-aware recommendations:
### API Integrations
- **Alecaframe API** - User account data and relic inventory
- Provides your personal relic collection
- Enables personalized farming recommendations
- **WarframeStat.us API** - World state and event tracking
- Real-time game state (alerts, invasions, fissures, sorties)
- Baro Ki'Teer and Varzia schedules
- Open world cycles (Cetus, Orb Vallis, Cambion Drift)
- **Warframe.market API** - Trading and market data
- Live buy/sell orders
- Price trends and market statistics
- Item search and discovery
### Intelligent Recommendations
The server combines data from all sources to provide smart, actionable advice:
- Cross-references your relics with active fissures
- Identifies high-value items from current vault rotations
- Suggests optimal activities based on time-limited events
- Provides market insights for trading decisions
### Caching & Rate Limiting
- Implements intelligent caching (5min for world state, 10min for market data)
- Respects API rate limits (3 req/sec for warframe.market)
- Minimizes API calls while keeping data fresh
## Project Structure```
warframe-mcp/
├── main.go # MCP server entry point
├── internal/
│ ├── config/ # Configuration management
│ ├── alecaframe/ # Alecaframe API client
│ ├── worldstate/ # WarframeStat.us API client
│ ├── market/ # Warframe.market API client
│ └── recommender/ # Recommendation engine
├── config.example.json # Configuration template
└── README.md # This file
Testing
The project includes comprehensive tests for all components. Run tests using:```bash
Run all tests
make test
Run tests with verbose output
make test-verbose
Run tests with coverage report
make test-coverage
Run specific package tests
make test-worldstate
make test-market
make test-recommender
Or use Go directly:```bash
go test ./...
go test ./internal/worldstate -v
Contributing
Contributions are welcome! Feel free to:
- Report bugs or suggest features via GitHub Issues
- Submit pull requests with improvements
- Add support for additional Warframe APIs
- Improve recommendation algorithms
Before submitting a PR:
- Run make test to ensure all tests pass
- Run make fmt to format your code
- Add tests for new functionality
License
MIT
Acknowledgments
Built using:
- mcp-go by mark3labs
- Warframe community APIs and the amazing WFCD team
- Claude by Anthropic for the MCP protocol
