About Allegro MCP
Allegro MCP is an MCP server in the Commerce category: mCP server for personal Allegro account access - view orders, purchases, watched items.
Install
git clone https://github.com/Bilski311/allegro-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (8)
allegro_authenticateStart OAuth device authorization flow
Parameters not published.
allegro_check_auth_statusCheck if authenticated
Parameters not published.
allegro_complete_authenticationComplete authentication with device code
Parameters not published.
allegro_get_bought_itemsList items you've bought
Parameters not published.
allegro_get_my_infoGet your account information
Parameters not published.
allegro_get_my_ordersList your orders/purchases
Parameters not published.
allegro_get_order_detailsGet details of a specific order
Parameters not published.
allegro_get_watched_offersList offers you're watching
Parameters not published.
Ask AI
Ask AI about Allegro MCP
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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
| Tool | Description |
|---|---|
allegro_authenticate |
Start OAuth device authorization flow |
allegro_complete_authentication |
Complete authentication with device code |
allegro_check_auth_status |
Check if authenticated |
allegro_get_my_info |
Get your account information |
allegro_get_my_orders |
List your orders/purchases |
allegro_get_order_details |
Get details of a specific order |
allegro_get_watched_offers |
List offers you're watching |
allegro_get_bought_items |
List items you've bought |
Prerequisites
- Java 21+
- Allegro Developer Account with registered application
Setup
1. Register an Allegro Application
- Go to Allegro Developer Portal
- Create a new application
- Note your
Client IDandClient Secret - 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
- Call
allegro_authenticatetool - Visit the provided URL in your browser
- Authorize the application
- Call
allegro_complete_authenticationwith the device code - You're now authenticated and can use other tools
Configuration
| Property | Default | Description |
|---|---|---|
allegro.client-id |
- | Your Allegro Client ID |
allegro.client-secret |
- | Your Allegro Client Secret |
allegro.sandbox |
false |
Use Allegro sandbox environment |
server.port |
8080 |
Server port |
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.
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.