Server address
https://ryd-portal-mcp-313879492178.europe-west3.run.app/mcpRemote MCP server over Streamable HTTP with OAuth 2.1. You sign in with your ryd portal account, including your second factor, and choose which company and which permissions the assistant gets. There is no API key to copy.
Before you start
Who can use it
Users of companies that work with ryd as fleet partner or API partner and have a ryd portal account. ryd switches the AI connector on per company; ask your ryd contact.
What the assistant may do
Exactly what your portal account may do, in one company. Changes such as creating a driver are shown to you first and run only after you confirm.
Disconnect at any time
In the ryd portal under AI at ryd, connected assistants. Disabling your portal user ends the access within a minute.
Connect your assistant
Claude
- Settings, Connectors, add custom connector.
- Paste the server address.
- Sign in to the ryd portal and confirm.
ChatGPT
- Settings, Apps and connectors (developer mode or workspace admin).
- Create a connector with the server address, OAuth.
- Sign in to the ryd portal and confirm.
Microsoft Copilot Studio
- Agent, Tools, add an MCP server.
- Server address, OAuth 2.0 with the client id and secret your company admin creates in the ryd portal.
- Sign in and confirm.
Other MCP clients
Any client that supports remote MCP with OAuth 2.1 and PKCE: Langdock, Mistral Le Chat, Gemini Enterprise, n8n, Cursor, VS Code. Discovery: /.well-known/oauth-protected-resource.
Try asking
- Give me an overview of my fleet.
- Show last month's fuel transactions.
- Why did order 7a1e… fail?
- Why did orders fail most often this month?
- Did any webhook deliveries fail yesterday?
What it can do
The tools your assistant sees depend on your company type, your portal roles and the permissions you grant. Machine-readable list: /.well-known/ryd-mcp-catalog.json.
Getting started
- Who am Iread
Returns the signed-in ryd portal user this connection acts for: name, e-mail, the company (user group) and its display name, partner types, roles, environment, and which capability families are available.
- List capabilitiesread
Lists the ryd tools available to this connection, grouped by family, with example questions.
- Download a filefile
Opens a file another ryd tool pointed to: an export (ryd://exports/…), an invoice PDF (ryd://invoices/…) or a report (ryd://reports/…), up to 25 MB.
Documentation
- Search ryd documentationread
Searches the partner documentation of the ryd portal (integration guides, webhook guide, fleet guides, AI assistant guide, security and compliance: ryd IP addresses to allowlist, GDPR and data protection).
- Get the ryd data protection and GDPR PDFread
Returns the ryd portal link that downloads ryd's data protection and GDPR document as a PDF: hosting and infrastructure, the service providers with locations and certifications, and GDPR (data processing agreement, sub-processors, data retention, AI access).
Fleet
- Fleet overviewread
Summary of the fleet as shown on the portal fleet home: onboarding state and key counts.
- List vehiclesread
Lists the fleet's vehicles with license plate, make, model, fuel type and assigned drivers (contact data masked).
- Get vehicleread
Details of one vehicle of the fleet by its vehicle id, including assigned drivers (contact data masked).
- List driversread
Lists the fleet's drivers with name, license plate and status.
- List fleet transactionsread
Lists fuel, charging and wash transactions of the fleet in a date window (at most 90 days), optionally for given license plates.
- Get fleet transactionread
Details of one transaction (order) by its order UUID: state history, station, product and amounts.
- List fleet invoicesread
Lists the fleet's invoices (number, date, amount, status) in an optional date range.
- Invoice for an orderread
Finds the invoice that contains a given order.
- List sub-fleetsread
Lists the sub-fleets of a corporation partner with their status.
- Get sub-fleetread
Details of one sub-fleet of a corporation partner: name, status and counts.
- List sub-fleet driversread
Drivers of one sub-fleet with their status.
- Create a driverchange, asks first
Creates a driver in your fleet and optionally assigns vehicles.
- Update a driverchange, asks first
Changes a driver's first and last name and, optionally, the complete list of vehicles the driver may pay for (the list replaces the current one).
- Archive a driverchange, asks first
Archives a driver: they can no longer pay and disappear from the active driver list.
- Add a vehiclechange, asks first
Adds a vehicle to your fleet.
- Update a vehiclechange, asks first
Changes a vehicle's plate, nickname, odometer, inspection date or status (active, inactive, archived).
- Assign a vehicle to a driverchange, asks first
Lets a driver of your fleet pay for one more vehicle of your fleet.
- Remove a vehicle from a driverchange, asks first
Removes one vehicle from a driver's list; the driver can no longer pay for it.
- Import drivers from a filechange, asks first
Creates many drivers from a CSV or Excel file the user gave you.
- Driver import progressread
Progress of one driver import: status, counts, progress per step (validate, check existing, match vehicles, create, verify) and the rows that failed or were skipped with the reason.
- List driver importsread
The latest driver imports of your fleet, from the portal or from an AI assistant, newest first.
- Retry or resume a driver importchange, asks first
Runs the failed rows of a driver import again (after the user fixed the cause, e.g.
- Show driver spending limitsread
Shows one driver's own spending limits per period (hour, day, week, month), what the driver spent in each current period and what is left, and the fleet's billing-cycle limit, which is the highest value a driver limit may have.
- Change driver spending limitschange, asks first
Sets one driver's own spending limits for the given periods; periods not named keep their value.
- Show how the fleet paysread
Shows how the fleet's drivers pay: by invoice to the fleet (POSTPAY_BY_PARTNER), with NFC Tap to Pay (ryd virtual card at the terminal), and/or with the driver's own payment methods, read from the fleet's ryd configuration.
Exports
- Request a fleet exportexport
Starts an export in the ryd Export Center: merged invoices (MERGE_PDF, MERGE_CSV, MERGE_EXCEL) or transactions (XLSX) for a date range of at most one year.
- Export statusread
Status of an export job.
Reports
- List reportsread
Lists the reports ryd provides to your company.
- Read a reportread
The text content of a report from reports_list.
Orders
- Search ordersread
Lists your company's orders (as owner or as station partner) in a time window of at most 90 days, newest first.
- Recent ordersread
The most recent orders of your company in the current environment.
- Get orderread
Details of one order by its UUID: state history, station, products, amounts and payment.
- Order state eventsread
The state changes of one order over time (created, authorised, fuelling, completed, failed …), from the API gateway logs.
Webhooks
- Webhook configurationsread
Lists your webhook configurations: endpoints, subscribed event types and status.
- Webhook deliveriesread
Webhook deliveries to your endpoints in a period (at most 31 days): time, event, HTTP status and error.
- Update a webhook configurationchange, asks first
Switches a webhook configuration on or off, or changes the event types it subscribes to.
- Send a test webhookchange, asks first
Sends a test event from a saved webhook configuration to your endpoint and reports the HTTP result.
Monitoring
- API request metricsread
How many requests your integration sent to the ryd APIs in a period, how many failed, and the error rate.
- Order failure statisticsread
Statistics of failed orders in a period, grouped by failure state.
- Created ordersread
How many orders your integration created in a period, as a total and over time.
- Order error messagesread
Error messages logged for one order, to explain a failure.
Stations
- Search stationsread
Searches fuel, charging and car-wash stations (places) by brand, city, ZIP, street or country, optionally only stations that support ryd payment.
Prices
- List pricesread
The ryd list prices for fuel products on a day, as shown on the portal list-price page.
Documents
- List shared documentsread
Documents ryd shared with your company in the portal (contracts, price sheets, guides).
Pay at the pump
- Find stations to pay atread
Finds fuel stations near a position where the driver can pay with ryd at the pump.
- Pumps and products of a stationread
Lists a station's pumps with their status, products, prices and the minimum, maximum and suggested amounts to reserve.
- Release a pump and reserve the amountchange, asks first
Creates the fuelling order for the pump and reserves (tops up) maxAmount on the driver's preferred payment method, which releases the pump.
- Fuelling and payment statusread
Shows the state of a fuelling order: authorizing, pump released, fuelling, completed with the final amount, or failed.
- Cancel a fuelling orderchange, asks first
Cancels an order before fuelling started (state CREATED, or PRODUCT_PENDING when the pump is released but the nozzle not lifted); the reservation is released.
Security and data protection
- Every request runs as your portal user in one company and sees only that company's data.
- Processing and storage at ryd stay in the European Union.
- Driver e-mail addresses and phone numbers are masked.
- Every request is recorded in your company's AI activity log in the ryd portal.
- Your assistant's vendor processes the answers it receives under your contract with that vendor.