Automatisch Overstappen MCP Server

🌉 MCP Bridge for Energy Contract Management

A Model Context Protocol (MCP) bridge that forwards energy contract analysis tools to cloud Firebase Functions. This allows you to use energy supplier comparison and switching tools directly in Claude Desktop.

⚡ Quick Start

Installation & Usage

# Run directly with npx (recommended)
npx automatisch-overstappen-mcp-server

# Or install globally
npm install -g automatisch-overstappen-mcp-server
automatisch-overstappen-mcp-server

Claude Desktop Configuration

Add this to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "automatisch-overstappen": {
      "command": "npx",
      "args": ["-y", "automatisch-overstappen-mcp-server"],
      "env": {
        "MCP_API_KEY": "your-api-key-here"
      }
    }
  }
}

🔧 Configuration

API Key Setup

The bridge requires an API key to connect to the cloud functions. You can provide it in two ways:

Method 1: Environment Variable (Recommended)

# Set in your .env file or environment
MCP_API_KEY=your-api-key-here

Method 2: CLI Argument

npx automatisch-overstappen-mcp-server --api-key your-api-key-here

Custom Cloud URL

If you're using a different cloud deployment:

npx automatisch-overstappen-mcp-server --url https://your-custom-endpoint.com

CLI Options

automatisch-overstappen-mcp-server [options]

Options:
  -V, --version              display version number
  -u, --url <url>           Cloud API URL (default: https://mcpserver-oguyrjqdqa-ew.a.run.app)
  -k, --api-key <key>       API key for cloud functions (can also use MCP_API_KEY env var)
  -h, --help                display help for command

🏠 Available Tools

The bridge provides these energy management tools:

1. get_user_energy_overview

Get comprehensive overview of energy contracts and houses

• View all properties and current contracts
• Filter for upcoming renewals
• Monitor contract expiration dates

2. check_cheapest_supplier

Compare energy suppliers for a specific house

• Analyzes current consumption data
• Returns top 5 cheapest 1-year fixed contracts
• Shows monthly and yearly pricing
• Provides switching IDs for seamless transitions

3. switch_energy_supplier

Switch to a new energy supplier

• Preview mode shows detailed comparison
• Confirms all house and personal data
• Handles the complete switching process
• Supports both preview and confirmed modes

4. update_house

Update house information

• Modify address details
• Update energy consumption data
• Change contract information
• Enable/disable energy monitoring

5. add_new_house

Add new properties to your portfolio

• Complete address registration
• Set up energy consumption tracking
• Configure contract monitoring

6. delete_house

Remove properties from your portfolio

• Clean removal of house data
• Preserves other user information

🔒 Security & Privacy

• No Hardcoded Secrets: The bridge contains no API keys or sensitive data
• Environment Variables: API keys are loaded from environment variables
• HTTPS Only: All communication with cloud functions uses HTTPS
• Error Handling: Comprehensive error handling with user-friendly messages

🌍 Cloud Architecture

This bridge connects to Firebase Functions deployed in EU West (europe-west1) for:

• Low Latency: EU-based deployment for European users
• Data Privacy: GDPR-compliant data processing
• High Availability: Firebase Functions auto-scaling
• Cost Efficiency: Pay-per-use serverless architecture

📋 Example Usage in Claude

After setup, you can ask Claude:

• "Show me my energy contracts overview"
• "Check the cheapest suppliers for my house in Amsterdam"
• "Switch to OXXIO for my second property"
• "Update the energy consumption for my main house"
• "Add a new house to my portfolio"

🐛 Troubleshooting

Bridge Won't Start

• Ensure Node.js ≥18.0.0 is installed
• Check that MCP_API_KEY is set correctly
• Verify internet connection for cloud function access

Claude Desktop Connection Issues

• Restart Claude Desktop after configuration changes
• Check claude_desktop_config.json syntax is valid
• Ensure the bridge command can run in your terminal

API Errors

• Verify your API key is valid and active
• Check that cloud functions are deployed and accessible
• Ensure you're using the correct cloud endpoint URL

📦 Package Information

• Package: automatisch-overstappen-mcp-server
• License: MIT
• Node.js: ≥18.0.0 required
• Dependencies: MCP SDK, dotenv, commander

🤝 Support

For issues, questions, or feature requests, please check the error messages first - they're designed to be helpful and specific about what went wrong.

📄 License

MIT License - feel free to use this bridge for your energy management needs!