{"catalogVersion":"0.3.1","server":"ryd partner MCP server","tools":[{"name":"ryd_whoami","title":"Who am I","description":"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. Call this first.","family":"common","personas":["everyone"],"scope":"profile","access":"read","entitlements":{},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Who am I connected as?","Which company does this connection act for?"],"docs":"/ai-at-ryd/overview#how-it-works"},{"name":"ryd_list_capabilities","title":"List capabilities","description":"Lists the ryd tools available to this connection, grouped by family, with example questions. Use it when the user asks what you can do with ryd.","family":"common","personas":["everyone"],"scope":"profile","access":"read","entitlements":{},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["What can you do with my ryd data?"],"docs":"/ai-at-ryd/capabilities"},{"name":"ryd_search_docs","title":"Search ryd documentation","description":"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). Returns page paths, titles and excerpts. Use for \"how do I…\" questions about ryd. The documentation is in English and matched by keywords: search with English keywords (e.g. \"IP allowlist\", \"GDPR data processing agreement\"), translating the user's question if needed.","family":"docs","personas":["everyone"],"scope":"docs:read","access":"read","entitlements":{},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["How do I authenticate against the fleet APIs?","Where are webhook payloads documented?"],"docs":"/ai-at-ryd/capabilities#docs"},{"name":"ryd_get_data_protection_pdf","title":"Get the ryd data protection and GDPR PDF","description":"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). Use when the user wants this information as a PDF or file, e.g. for vendor due diligence. Give the user the link: the ryd portal creates the PDF after sign-in. For questions about the content itself, use ryd_search_docs.","family":"docs","personas":["everyone"],"scope":"docs:read","access":"read","entitlements":{},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Send me ryd's GDPR documentation as a PDF.","Ich brauche die DSGVO-Informationen von ryd als PDF."],"docs":"/ai-at-ryd/capabilities#docs"},{"name":"fleet_overview","title":"Fleet overview","description":"Summary of the fleet as shown on the portal fleet home: onboarding state and key counts.","family":"fleet","personas":["fleet_partner"],"scope":"fleet:read","access":"read","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Give me an overview of my fleet."],"docs":"/ai-at-ryd/capabilities#fleet"},{"name":"fleet_list_vehicles","title":"List vehicles","description":"Lists the fleet's vehicles with license plate, make, model, fuel type and assigned drivers (contact data masked). Supports a free-text search and paging.","family":"fleet","personas":["fleet_partner"],"scope":"fleet:read","access":"read","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["List all vehicles with \"M-AB\" in the plate.","How many electric vehicles do we have?"],"docs":"/ai-at-ryd/capabilities#fleet"},{"name":"fleet_get_vehicle","title":"Get vehicle","description":"Details of one vehicle of the fleet by its vehicle id, including assigned drivers (contact data masked).","family":"fleet","personas":["fleet_partner"],"scope":"fleet:read","access":"read","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Show me the details of vehicle 64f…"],"docs":"/ai-at-ryd/capabilities#fleet"},{"name":"fleet_list_drivers","title":"List drivers","description":"Lists the fleet's drivers with name, license plate and status. E-mail and phone are masked.","family":"fleet","personas":["fleet_partner"],"scope":"fleet:read","access":"read","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Which drivers are assigned to plate M-AB 123?"],"docs":"/ai-at-ryd/capabilities#fleet"},{"name":"fleet_list_transactions","title":"List fleet transactions","description":"Lists fuel, charging and wash transactions of the fleet in a date window (at most 90 days), optionally for given license plates. Use for spend and volume questions.","family":"fleet","personas":["fleet_partner","api_partner"],"scope":"fleet:read","access":"read","entitlements":{"anyOf":[{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"]},{"requiredPartnerTypes":["API_PARTNER"],"requiresFleetApis":true}]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Show last month's fuel transactions.","What did vehicle M-AB 123 spend in September?"],"docs":"/ai-at-ryd/capabilities#fleet"},{"name":"fleet_get_transaction","title":"Get fleet transaction","description":"Details of one transaction (order) by its order UUID: state history, station, product and amounts.","family":"fleet","personas":["fleet_partner"],"scope":"fleet:read","access":"read","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["What happened with order 3f2c…?"],"docs":"/ai-at-ryd/capabilities#fleet"},{"name":"fleet_list_invoices","title":"List fleet invoices","description":"Lists the fleet's invoices (number, date, amount, status) in an optional date range. Invoice PDFs come as ryd://invoices/… addresses to download with ryd_download_file.","family":"fleet","personas":["fleet_partner"],"scope":"fleet:read","access":"read","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["List our invoices from September."],"docs":"/ai-at-ryd/capabilities#fleet"},{"name":"fleet_get_invoice_for_order","title":"Invoice for an order","description":"Finds the invoice that contains a given order.","family":"fleet","personas":["fleet_partner"],"scope":"fleet:read","access":"read","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Which invoice contains order 3f2c…?"],"docs":"/ai-at-ryd/capabilities#fleet"},{"name":"fleet_list_sub_fleets","title":"List sub-fleets","description":"Lists the sub-fleets of a corporation partner with their status.","family":"fleet","personas":["fleet_partner","api_partner"],"scope":"fleet:read","access":"read","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER","API_PARTNER"],"requiresFleetApis":true},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Which sub-fleets do we have?"],"docs":"/ai-at-ryd/capabilities#fleet"},{"name":"ryd_download_file","title":"Download a file","description":"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. Returns the file's text (PDF text or CSV) so you can answer questions about it, and a ryd portal download link: give the user that link to download the file — it opens the file in the ryd portal after sign-in. The file itself is only embedded with delivery \"file\" or for assistants known to support embedded files.","family":"common","personas":["fleet_partner","api_partner"],"scope":"profile","access":"download","entitlements":{},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Download the export I requested.","Get the PDF of invoice INV-2026-0042."],"docs":"/ai-at-ryd/capabilities#files"},{"name":"fleet_request_export","title":"Request a fleet export","description":"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. Returns a job id; check it with fleet_get_export.","family":"exports","personas":["fleet_partner"],"scope":"fleet:export","access":"export","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"],"requiresPaidFleetPlanOrFeature":"exportCenterEnabled"},"phase":1,"stability":"preview","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"examples":["Export all invoices of September as one PDF.","Create a transaction export for Q3."],"docs":"/ai-at-ryd/capabilities#files"},{"name":"fleet_get_export","title":"Export status","description":"Status of an export job. When it is COMPLETED, the result includes a ryd portal download link to give the user, and a ryd://exports/… address to read the file with ryd_download_file.","family":"exports","personas":["fleet_partner"],"scope":"fleet:export","access":"read","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"],"requiresPaidFleetPlanOrFeature":"exportCenterEnabled"},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Is my export ready?"],"docs":"/ai-at-ryd/capabilities#files"},{"name":"reports_list","title":"List reports","description":"Lists the reports ryd provides to your company. Each report has a ryd portal download link to give the user, and a ryd://reports/… address to read it with ryd_download_file.","family":"reports","personas":["api_partner"],"scope":"reports:read","access":"read","entitlements":{"requiredPartnerTypes":["API_PARTNER"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Which reports are available for us?"],"docs":"/ai-at-ryd/capabilities#files"},{"name":"orders_search","title":"Search orders","description":"Lists your company's orders (as owner or as station partner) in a time window of at most 90 days, newest first. Use for \"how many orders\" and \"show orders between\" questions.","family":"orders","personas":["api_partner"],"scope":"orders:read","access":"read","entitlements":{"requiredPartnerTypes":["API_PARTNER"],"requiresDataWarehouseId":true},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["How many orders did we have yesterday?","Show orders from 1 to 7 October."],"docs":"/ai-at-ryd/capabilities#orders"},{"name":"orders_recent","title":"Recent orders","description":"The most recent orders of your company in the current environment.","family":"orders","personas":["api_partner"],"scope":"orders:read","access":"read","entitlements":{"requiredPartnerTypes":["API_PARTNER"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Show our last 10 orders."],"docs":"/ai-at-ryd/capabilities#orders"},{"name":"orders_get","title":"Get order","description":"Details of one order by its UUID: state history, station, products, amounts and payment. Use to explain why an order failed.","family":"orders","personas":["api_partner"],"scope":"orders:read","access":"read","entitlements":{"requiredPartnerTypes":["API_PARTNER"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Why did order 7a1e… fail?"],"docs":"/ai-at-ryd/capabilities#orders"},{"name":"webhooks_list_configurations","title":"Webhook configurations","description":"Lists your webhook configurations: endpoints, subscribed event types and status. Secrets and auth headers are never returned.","family":"webhooks","personas":["api_partner"],"scope":"webhooks:read","access":"read","entitlements":{"requiredPartnerTypes":["API_PARTNER"],"requiredRoles":["api_credentials_admin"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Which webhook endpoints do we have configured?"],"docs":"/ai-at-ryd/capabilities#webhooks"},{"name":"monitoring_api_requests","title":"API request metrics","description":"How many requests your integration sent to the ryd APIs in a period, how many failed, and the error rate. Use for \"is our integration healthy\" questions.","family":"monitoring","personas":["api_partner"],"scope":"monitoring:read","access":"read","entitlements":{"requiredPartnerTypes":["API_PARTNER"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["What was our API error rate last week?"],"docs":"/ai-at-ryd/capabilities#monitoring"},{"name":"monitoring_order_failures","title":"Order failure statistics","description":"Statistics of failed orders in a period, grouped by failure state. Use with orders_get to explain single failures.","family":"monitoring","personas":["api_partner"],"scope":"monitoring:read","access":"read","entitlements":{"requiredPartnerTypes":["API_PARTNER"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Why did orders fail most often this month?"],"docs":"/ai-at-ryd/capabilities#monitoring"},{"name":"stations_search","title":"Search stations","description":"Searches fuel, charging and car-wash stations (places) by brand, city, ZIP, street or country, optionally only stations that support ryd payment. Returns up to 25 places with their shops.","family":"stations","personas":["fleet_partner","api_partner"],"scope":"stations:read","access":"read","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER","API_PARTNER"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Which Aral stations in Munich support ryd?","Find car washes in 80331."],"docs":"/ai-at-ryd/capabilities#stations"},{"name":"prices_list","title":"List prices","description":"The ryd list prices for fuel products on a day, as shown on the portal list-price page. Only for companies billed on list prices.","family":"prices","personas":["fleet_partner","api_partner"],"scope":"prices:read","access":"read","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER","API_PARTNER"],"requiresListPrice":true},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["What is today's diesel list price?"],"docs":"/ai-at-ryd/capabilities#prices"},{"name":"fleet_get_sub_fleet","title":"Get sub-fleet","description":"Details of one sub-fleet of a corporation partner: name, status and counts.","family":"fleet","personas":["fleet_partner","api_partner"],"scope":"fleet:read","access":"read","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER","API_PARTNER"],"requiresFleetApis":true},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Show the details of sub-fleet Nord."],"docs":"/ai-at-ryd/capabilities#fleet"},{"name":"fleet_list_sub_fleet_drivers","title":"List sub-fleet drivers","description":"Drivers of one sub-fleet with their status. E-mail and phone are masked.","family":"fleet","personas":["fleet_partner","api_partner"],"scope":"fleet:read","access":"read","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER","API_PARTNER"],"requiresFleetApis":true},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Which drivers belong to sub-fleet Nord?"],"docs":"/ai-at-ryd/capabilities#fleet"},{"name":"orders_state_events","title":"Order state events","description":"The state changes of one order over time (created, authorised, fuelling, completed, failed …), from the API gateway logs. Use with orders_get to explain what happened.","family":"orders","personas":["api_partner"],"scope":"orders:read","access":"read","entitlements":{"requiredPartnerTypes":["API_PARTNER"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Show the state history of order 7a1e…."],"docs":"/ai-at-ryd/capabilities#orders"},{"name":"monitoring_created_orders","title":"Created orders","description":"How many orders your integration created in a period, as a total and over time.","family":"monitoring","personas":["api_partner"],"scope":"monitoring:read","access":"read","entitlements":{"requiredPartnerTypes":["API_PARTNER"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["How many orders did we create last week?"],"docs":"/ai-at-ryd/capabilities#monitoring"},{"name":"monitoring_error_logs","title":"Order error messages","description":"Error messages logged for one order, to explain a failure. Messages are shortened to 500 characters; stack traces are never returned.","family":"monitoring","personas":["api_partner"],"scope":"monitoring:read","access":"read","entitlements":{"requiredPartnerTypes":["API_PARTNER"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Which errors were logged for order 7a1e…?"],"docs":"/ai-at-ryd/capabilities#monitoring"},{"name":"webhooks_list_deliveries","title":"Webhook deliveries","description":"Webhook deliveries to your endpoints in a period (at most 31 days): time, event, HTTP status and error. Request and response bodies are never returned.","family":"webhooks","personas":["api_partner"],"scope":"webhooks:read","access":"read","entitlements":{"requiredPartnerTypes":["API_PARTNER"],"requiredRoles":["api_credentials_admin"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Did any webhook deliveries fail yesterday?"],"docs":"/ai-at-ryd/capabilities#webhooks"},{"name":"reports_get","title":"Read a report","description":"The text content of a report from reports_list. For binary reports use ryd_download_file with the report address.","family":"reports","personas":["api_partner"],"scope":"reports:read","access":"read","entitlements":{"requiredPartnerTypes":["API_PARTNER"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Summarise the latest monthly report."],"docs":"/ai-at-ryd/capabilities#files"},{"name":"documents_list","title":"List shared documents","description":"Documents ryd shared with your company in the portal (contracts, price sheets, guides). Returns titles, dates and a portal link; open the document in the portal.","family":"documents","personas":["fleet_partner","api_partner"],"scope":"documents:read","access":"read","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER","API_PARTNER"],"requiresPartnerFeature":"showDocuments"},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Which documents has ryd shared with us?"],"docs":"/ai-at-ryd/capabilities#documents"},{"name":"fleet_create_driver","title":"Create a driver","description":"Creates a driver in your fleet and optionally assigns vehicles. The driver receives the ryd invitation e-mail. Two steps: the first call returns a preview and a confirmationId; show the preview to the user, and only after they explicitly agree call again with the same arguments plus confirmationId.","family":"fleet","personas":["fleet_partner"],"scope":"fleet:write","access":"write","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"],"requiresPartnerFeature":"aiWriteActionsEnabled"},"phase":1,"stability":"preview","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"examples":["Create driver Max Muster, max@acme.de, and give him vehicle M-AC 101."],"docs":"/ai-at-ryd/capabilities#changes"},{"name":"fleet_update_driver","title":"Update a driver","description":"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). Blocking a driver is done in the ryd portal. Two steps: the first call returns a preview and a confirmationId; show the preview to the user, and only after they explicitly agree call again with the same arguments plus confirmationId.","family":"fleet","personas":["fleet_partner"],"scope":"fleet:write","access":"write","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"],"requiresPartnerFeature":"aiWriteActionsEnabled"},"phase":1,"stability":"preview","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"examples":["Correct the last name of driver acc-1 to Müller.","Give driver acc-1 the vehicles veh-1 and veh-2."],"docs":"/ai-at-ryd/capabilities#changes"},{"name":"fleet_archive_driver","title":"Archive a driver","description":"Archives a driver: they can no longer pay and disappear from the active driver list. This cannot be undone through the assistant. Two steps: the first call returns a preview and a confirmationId; show the preview to the user, and only after they explicitly agree call again with the same arguments plus confirmationId.","family":"fleet","personas":["fleet_partner"],"scope":"fleet:write","access":"write","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"],"requiresPartnerFeature":"aiWriteActionsEnabled"},"phase":1,"stability":"preview","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"examples":["Archive driver acc-1, he left the company."],"docs":"/ai-at-ryd/capabilities#changes"},{"name":"fleet_create_vehicle","title":"Add a vehicle","description":"Adds a vehicle to your fleet. Assign it to drivers afterwards with fleet_assign_vehicle. Two steps: the first call returns a preview and a confirmationId; show the preview to the user, and only after they explicitly agree call again with the same arguments plus confirmationId.","family":"fleet","personas":["fleet_partner"],"scope":"fleet:write","access":"write","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"],"requiresPartnerFeature":"aiWriteActionsEnabled"},"phase":1,"stability":"preview","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"examples":["Add the electric VW ID.4 with plate M-AC 105."],"docs":"/ai-at-ryd/capabilities#changes"},{"name":"fleet_update_vehicle","title":"Update a vehicle","description":"Changes a vehicle's plate, nickname, odometer, inspection date or status (active, inactive, archived). Only the fields you send change. Two steps: the first call returns a preview and a confirmationId; show the preview to the user, and only after they explicitly agree call again with the same arguments plus confirmationId.","family":"fleet","personas":["fleet_partner"],"scope":"fleet:write","access":"write","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"],"requiresPartnerFeature":"aiWriteActionsEnabled"},"phase":1,"stability":"preview","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"examples":["Set the odometer of M-AC 101 to 42 000 km.","Deactivate vehicle veh-2."],"docs":"/ai-at-ryd/capabilities#changes"},{"name":"fleet_assign_vehicle","title":"Assign a vehicle to a driver","description":"Lets a driver of your fleet pay for one more vehicle of your fleet. The driver keeps their other vehicles. Two steps: the first call returns a preview and a confirmationId; show the preview to the user, and only after they explicitly agree call again with the same arguments plus confirmationId.","family":"fleet","personas":["fleet_partner"],"scope":"fleet:write","access":"write","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"],"requiresPartnerFeature":"aiWriteActionsEnabled"},"phase":1,"stability":"preview","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"examples":["Assign M-AC 102 to Ada Driver."],"docs":"/ai-at-ryd/capabilities#changes"},{"name":"fleet_unassign_vehicle","title":"Remove a vehicle from a driver","description":"Removes one vehicle from a driver's list; the driver can no longer pay for it. Two steps: the first call returns a preview and a confirmationId; show the preview to the user, and only after they explicitly agree call again with the same arguments plus confirmationId.","family":"fleet","personas":["fleet_partner"],"scope":"fleet:write","access":"write","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"],"requiresPartnerFeature":"aiWriteActionsEnabled"},"phase":1,"stability":"preview","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"examples":["Take vehicle M-AC 101 away from Ada Driver."],"docs":"/ai-at-ryd/capabilities#changes"},{"name":"webhooks_update_configuration","title":"Update a webhook configuration","description":"Switches a webhook configuration on or off, or changes the event types it subscribes to. Endpoint URLs and credentials are changed in the portal only. Two steps: the first call returns a preview and a confirmationId; show the preview to the user, and only after they explicitly agree call again with the same arguments plus confirmationId.","family":"webhooks","personas":["api_partner"],"scope":"webhooks:write","access":"write","entitlements":{"requiredPartnerTypes":["API_PARTNER"],"requiredRoles":["api_credentials_admin"],"requiresPartnerFeature":"aiWriteActionsEnabled"},"phase":1,"stability":"preview","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"examples":["Pause our webhook configuration wh-1.","Subscribe wh-1 to order.failed as well."],"docs":"/ai-at-ryd/capabilities#changes"},{"name":"webhooks_send_test","title":"Send a test webhook","description":"Sends a test event from a saved webhook configuration to your endpoint and reports the HTTP result. Your endpoint receives a real request with synthetic data. Two steps: the first call returns a preview and a confirmationId; show the preview to the user, and only after they explicitly agree call again with the same arguments plus confirmationId.","family":"webhooks","personas":["api_partner"],"scope":"webhooks:write","access":"write","entitlements":{"requiredPartnerTypes":["API_PARTNER"],"requiredRoles":["api_credentials_admin"],"requiresPartnerFeature":"aiWriteActionsEnabled"},"phase":1,"stability":"preview","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"examples":["Send a test order.completed webhook to our endpoint."],"docs":"/ai-at-ryd/capabilities#changes"},{"name":"pay_find_stations","title":"Find stations to pay at","description":"Finds fuel stations near a position where the driver can pay with ryd at the pump. Returns up to 10 stations with the stationId the other pay tools need.","family":"pay","personas":["api_partner"],"scope":"pay:read","access":"read","entitlements":{"requiredPartnerTypes":["API_PARTNER"],"requiresPartnerFeature":"aiPayEnabled"},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"examples":["Find a ryd station near me.","Where can I get diesel nearby?"],"docs":"/ai-at-ryd/capabilities#pay"},{"name":"pay_get_station","title":"Pumps and products of a station","description":"Lists a station's pumps with their status, products, prices and the minimum, maximum and suggested amounts to reserve. Use it to confirm the pump the driver is standing at.","family":"pay","personas":["api_partner"],"scope":"pay:read","access":"read","entitlements":{"requiredPartnerTypes":["API_PARTNER"],"requiresPartnerFeature":"aiPayEnabled"},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"examples":["Which pumps are free here?","Is pump 3 available and what does diesel cost?"],"docs":"/ai-at-ryd/capabilities#pay"},{"name":"pay_create_order","title":"Release a pump and reserve the amount","description":"Creates the fuelling order for the pump and reserves (tops up) maxAmount on the driver's preferred payment method, which releases the pump. Ask the driver for the amount (pay_get_station lists the pump's suggested amounts) and, when the pump offers several fuels, for the product. Only the fuel actually taken is charged; the rest of the reservation is released automatically. Refused while the driver still has an open order at this station. Two steps: the first call returns a preview and a confirmationId; read the preview to the driver, and only after they clearly agree call again with the same arguments plus confirmationId.","family":"pay","personas":["api_partner"],"scope":"pay:write","access":"write","entitlements":{"requiredPartnerTypes":["API_PARTNER"],"requiresPartnerFeature":"aiPayEnabled"},"phase":1,"stability":"preview","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"examples":["Pump 3, diesel, up to 50 euros.","Unlock pump 2 for 80 euros."],"docs":"/ai-at-ryd/capabilities#pay"},{"name":"pay_get_order","title":"Fuelling and payment status","description":"Shows the state of a fuelling order: authorizing, pump released, fuelling, completed with the final amount, or failed. Poll it after pay_create_order until finished is true (respect pollAfterMs).","family":"pay","personas":["api_partner"],"scope":"pay:read","access":"read","entitlements":{"requiredPartnerTypes":["API_PARTNER"],"requiresPartnerFeature":"aiPayEnabled"},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"examples":["Is my payment done?","How much did I pay?"],"docs":"/ai-at-ryd/capabilities#pay"},{"name":"pay_cancel_order","title":"Cancel a fuelling order","description":"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. rydpay refuses other states. Two steps: the first call returns a preview and a confirmationId; read the preview to the driver, and only after they clearly agree call again with the same arguments plus confirmationId.","family":"pay","personas":["api_partner"],"scope":"pay:write","access":"write","entitlements":{"requiredPartnerTypes":["API_PARTNER"],"requiresPartnerFeature":"aiPayEnabled"},"phase":1,"stability":"preview","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"examples":["Cancel, I changed my mind."],"docs":"/ai-at-ryd/capabilities#pay"},{"name":"fleet_import_drivers","title":"Import drivers from a file","description":"Creates many drivers from a CSV or Excel file the user gave you. Pass the file unchanged: ryd reads it, matches the columns (first name, last name, e-mail, license plates, optional country and language), checks every row and stores the import. Drivers are then created one by one in the background; follow progress with fleet_get_driver_import. Plates link only vehicles already in the fleet. Drivers whose e-mail is already in the fleet are skipped. At most 250 rows per file. Two steps: the first call returns ryd's preview of the file (column mapping, valid and invalid rows) and a confirmationId; show it to the user, and only after they agree call again with the same arguments plus confirmationId.","family":"fleet","personas":["fleet_partner"],"scope":"fleet:write","access":"write","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"],"requiresPartnerFeature":"aiWriteActionsEnabled"},"phase":1,"stability":"preview","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"examples":["Import the drivers in this Excel file.","Here is our driver list as CSV, please add them to the fleet."],"docs":"/ai-at-ryd/capabilities#changes"},{"name":"fleet_get_driver_import","title":"Driver import progress","description":"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. Call again while status is RUNNING; a stalled import can be resumed with fleet_resume_driver_import.","family":"fleet","personas":["fleet_partner"],"scope":"fleet:read","access":"read","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["How far is the driver import?","Which rows of the import failed?"],"docs":"/ai-at-ryd/capabilities#changes"},{"name":"fleet_list_driver_imports","title":"List driver imports","description":"The latest driver imports of your fleet, from the portal or from an AI assistant, newest first.","family":"fleet","personas":["fleet_partner"],"scope":"fleet:read","access":"read","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["Show my last driver imports."],"docs":"/ai-at-ryd/capabilities#changes"},{"name":"fleet_resume_driver_import","title":"Retry or resume a driver import","description":"Runs the failed rows of a driver import again (after the user fixed the cause, e.g. a vehicle was added), or resumes an import that stalled. Rows already created are never created twice. Two steps: the first call returns a preview and a confirmationId; show it to the user, and only after they agree call again with the same arguments plus confirmationId.","family":"fleet","personas":["fleet_partner"],"scope":"fleet:write","access":"write","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"],"requiresPartnerFeature":"aiWriteActionsEnabled"},"phase":1,"stability":"preview","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"examples":["Retry the failed rows of my last import."],"docs":"/ai-at-ryd/capabilities#changes"},{"name":"fleet_get_driver_spending_limits","title":"Show driver spending limits","description":"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.","family":"fleet","personas":["fleet_partner"],"scope":"fleet:read","access":"read","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["How much has driver acc-1 spent this week, and what is their limit?"],"docs":"/ai-at-ryd/capabilities#fleet"},{"name":"fleet_update_driver_spending_limits","title":"Change driver spending limits","description":"Sets one driver's own spending limits for the given periods; periods not named keep their value. No limit may be higher than the fleet's billing-cycle limit, and a shorter period cannot have a higher limit than a longer one. A later change of the whole fleet's driver limits replaces these values. Two steps: the first call returns a preview and a confirmationId; show the preview to the user, and only after they explicitly agree call again with the same arguments plus confirmationId.","family":"fleet","personas":["fleet_partner"],"scope":"fleet:write","access":"write","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"],"requiresPartnerFeature":"aiWriteActionsEnabled"},"phase":1,"stability":"preview","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"examples":["Set the weekly limit of driver acc-1 to 400 euros.","Raise the daily limit of acc-1 to 150 and the weekly limit to 500."],"docs":"/ai-at-ryd/capabilities#changes"},{"name":"fleet_get_payment_options","title":"Show how the fleet pays","description":"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. Use it before explaining payments or pay at the pump to a fleet.","family":"fleet","personas":["fleet_partner"],"scope":"fleet:read","access":"read","entitlements":{"requiredPartnerTypes":["FLEET_PARTNER"],"requiredRoles":["fleet_Admin","fleet_Manager"]},"phase":1,"stability":"preview","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"examples":["How do our drivers pay?","Can our drivers use Tap to Pay?"],"docs":"/ai-at-ryd/capabilities#fleet"}],"prompts":[{"name":"fleet_monthly_review","title":"Monthly fleet review","description":"Review one month of fleet spending: totals, top vehicles, unusual transactions and open invoices.","arguments":["month"],"requiresTools":["fleet_list_transactions","fleet_list_invoices"]},{"name":"investigate_order","title":"Investigate an order","description":"Explain why an order failed or got stuck, and what the partner or driver can do.","arguments":["orderUuid"],"requiresTools":["orders_get"]},{"name":"webhook_health_check","title":"Webhook health check","description":"Check webhook configurations and recent deliveries for failures.","arguments":["since"],"requiresTools":["webhooks_list_configurations","webhooks_list_deliveries"]},{"name":"onboarding_help","title":"Integration help","description":"Find the right ryd documentation for an integration topic and summarise the steps.","arguments":["topic"],"requiresTools":["ryd_search_docs"]}],"resources":[{"uriTemplate":"ryd://exports/{jobId}","scope":"fleet:export","description":"An Export Center file of your fleet"},{"uriTemplate":"ryd://invoices/{attachmentId}","scope":"fleet:read","description":"An invoice PDF of your fleet"},{"uriTemplate":"ryd://reports/{reportId}","scope":"reports:read","description":"A report ryd provides to your company"},{"uriTemplate":"ryd://docs/{path}","scope":"docs:read","description":"A partner documentation page"}]}