Allegro MCP

Allegro MCP Server

A Model Context Protocol (MCP) server for integrating with your personal Allegro account. Access your orders, purchases, watched items, and more through AI assistants like Claude.

Features

• OAuth Device Flow Authentication - Secure authentication with your Allegro account
• View Orders - See your purchase history and order details
• Watched Offers - Check items you're watching
• User Info - Get your account information

Available MCP Tools

Prerequisites

• Java 21+
• Allegro Developer Account with registered application

Setup

1. Register an Allegro Application

1. Go to Allegro Developer Portal
2. Create a new application
3. Note your Client ID and Client Secret
4. Set redirect URI to https://allegro.pl (for device flow)

2. Configure Environment Variables

export ALLEGRO_CLIENT_ID=your_client_id
export ALLEGRO_CLIENT_SECRET=your_client_secret

3. Build and Run

./gradlew bootRun

The MCP server will be available at http://localhost:8080/mcp

Usage with Claude Code

Add to your Claude Code MCP configuration:

{
  "mcpServers": {
    "allegro": {
      "command": "curl",
      "args": ["-N", "http://localhost:8080/mcp/sse"]
    }
  }
}

Or run in stdio mode (coming soon).

Authentication Flow

1. Call allegro_authenticate tool
2. Visit the provided URL in your browser
3. Authorize the application
4. Call allegro_complete_authentication with the device code
5. You're now authenticated and can use other tools

Configuration

Development

Build

./gradlew build

Test

./gradlew test

License

MIT License - see LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Disclaimer

This is an unofficial project and is not affiliated with Allegro. Use at your own risk.