For mobile developers (Flutter)
Finding the right API endpoint
Finding the right API endpoint
You ask:
I need to implement the booking creation screen. What endpoint should I call and what’s the request format?MCP returns: The full
POST /v1/api/bookings spec with request body, required fields, headers, and response format.Understanding authentication
Understanding authentication
You ask:
How does the auth flow work? Login, token refresh, and logout.MCP returns: Complete auth endpoints (
/auth/login, /auth/refresh-token, /auth/logout) with JWT handling, token format, and expiry behavior.Handling errors
Handling errors
You ask:
What error codes can the payment endpoint return?MCP returns: The
ErrorResponse schema with all possible errorCode values (PAYMENT_ERROR, INSUFFICIENT_FUNDS, STRIPE_CONNECT_NOT_CONFIGURED, etc.) and their HTTP status codes.Implementing the booking lifecycle
Implementing the booking lifecycle
You ask:
What are all the booking statuses and how do transitions work?MCP returns: The full state machine:
EN_ATTENTE_PAIEMENT → RESERVATION_PAYEE → EN_ATTENTE → ACCEPTEE → EN_COURS_DE_LIVRAISON → LIVREE with error states and cancellation paths.QR code scanning
QR code scanning
You ask:
How do deposit and delivery QR codes work?MCP returns: The QR code generation, validation, and consumption endpoints with the full deposit/delivery flow.
For web developers (Backend)
Understanding the architecture
Understanding the architecture
You ask:
Explain the hexagonal architecture and module structure.MCP returns: Full breakdown of bounded contexts (compte, annonces, reservation, finances, etc.), port/adapter pattern, and inter-module communication via Domain Events.
Adding a new endpoint
Adding a new endpoint
You ask:
I need to add a new endpoint to the reservation module. What’s the convention?MCP returns: The hexagonal layer structure — controller in
infrastructure/controller/, use case interface in domain/port/in/, service in application/service/, with naming conventions and examples.Database schema
Database schema
You ask:
What’s the structure of the reservation and transaction tables?MCP returns: Table schemas, relationships, key columns, and how they map to domain entities.
Stripe integration
Stripe integration
You ask:
How does the Stripe Connect payment flow work? Platform fees, escrow, transfers?MCP returns: The complete payment flow — 15% platform fee, immediate capture with deferred transfer, Connected Accounts for carriers, and webhook handling.
For marketing & content teams
Understanding the product
Understanding the product
You ask:
Explain ColisMove’s core user journey from posting an announcement to delivery completion.MCP returns: The end-to-end flow — carrier posts announcement, sender books, payment in escrow, deposit with QR code, delivery with QR code, carrier gets paid.
Writing feature descriptions
Writing feature descriptions
You ask:
What security features does ColisMove have? KYC, payment protection, etc.MCP returns: KYC verification via Didit, Stripe escrow payments, QR code validation for deposit/delivery, role-based access control, dispute resolution system.
Preparing FAQ content
Preparing FAQ content
You ask:
What happens if a delivery fails or there’s a dispute?MCP returns: The dispute creation flow, admin resolution process, refund mechanisms, and cancellation policies with business rules.
Competitive differentiators
Competitive differentiators
You ask:
What are ColisMove’s technical differentiators for a press release?MCP returns: Peer-to-peer model (like BlaBlaCar for parcels), real-time tracking, secure QR code handoffs, instant carrier payouts via Stripe Connect, multi-language support.
For new team members
Onboarding questions
Onboarding questions
You ask:
I just joined the team. Give me an overview of the ColisMove platform — tech stack, architecture, and main features.MCP returns: Complete project context — Java 21 + Spring Boot, hexagonal architecture, PostgreSQL, Stripe Connect, 12 bounded contexts, and the core business flows.
Understanding roles and permissions
Understanding roles and permissions
You ask:
What user roles exist and what can each role do?MCP returns:
ROLE_CLIENT (basic user), ROLE_VERIFIED_USER (KYC approved, can create announcements), ROLE_ADMIN, ROLE_SUPERADMIN with their respective permissions.Tips for better results
Be specific
“How does booking cancellation work?” gets better results than “Tell me about bookings.”
Mention the context
“I’m building the Flutter payment screen” helps the AI tailor its response to your needs.
Ask follow-ups
Start broad, then drill down: “What endpoints exist for payments?” → “Show me the checkout creation request format.”
Ask in any language
The MCP works in French and English. Ask in whichever language you’re comfortable with.