Ask your agent in plain language. Each of these maps to a real tool on the server.
optimize_routes
Start the route optimization engine for a given date or date range. Configurable options include route balancing, start mode, depot trips, clustering, and selective planning with specific orders/drivers. Planning runs asynchronously; the returned **planningId** can be used to check status or stop planning.
update_driver_parameters
Update driver parameters for a specific date, including enabling/disabling drivers, adjusting working hours, assigning vehicles, setting load capacities, and changing start/end locations. Supports both single and bulk updates. **Warning:** Updating driver parameters for a date unschedules any existing routes for that driver on that date.
search_orders
Search for orders across a date range with optional filtering by status. Supports cursor-based pagination for large result sets. Can also look up specific orders by number/ID and include scheduling information.
get_routes
Retrieve planned routes for a specific date. Returns an ordered list of stops per driver route with scheduled times, travel details, and distances. Optionally filter by driver or vehicle, and include route polylines for map rendering.
create_order
Create a single order (delivery, pickup, or task) in OptimoRoute. Supports address geocoding for resolving addresses to coordinates. Use this for creating individual orders with full location validation. For bulk operations, use the **Bulk Create/Update Orders** tool instead.
get_planning_status
Check the status and progress of an asynchronous route optimization run. Also supports stopping a running optimization. Use the **planningId** returned from the Optimize Routes tool.
update_driver_positions
Push driver GPS positions into OptimoRoute from an external source. Accepts timestamped latitude/longitude coordinates with optional speed, heading, and accuracy for one or more drivers.
get_scheduling_info
Look up the scheduling status and details of an individual order, including assigned driver, stop number, scheduled service time, and travel distance/time from the previous stop. For bulk lookups, use the **Search Orders** tool with includeScheduleInformation.
delete_orders
Delete one or more orders from OptimoRoute. Can delete specific orders by number/ID, or delete all orders for a given date. Use **forceDelete** to remove orders that are part of linked pickup-delivery pairs.
update_completion_details
Update the completion status and details of an order. Use this to programmatically mark orders as completed, failed, cancelled, or update timestamps and notes.
get_completion_details
Retrieve completion status and proof of delivery data for one or more orders. Includes order status, service timestamps, driver info, GPS positions, tracking URL, and proof of delivery (signatures, photos, barcodes, notes, custom forms).
get_orders
Retrieve one or more orders by their order number or system ID. Returns the full order data including location, scheduling parameters, custom fields, and notification settings.
bulk_create_update_orders
Create or update multiple orders in a single request. Each order can specify its own operation type (CREATE, UPDATE, SYNC, MERGE). Address geocoding is **not** available in bulk; use coordinates or existing location identifiers instead.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.
Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.
Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.
Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues.
Create, read, update, and delete issues across projects. Search issues using JQL queries. Manage projects, boards, sprints, and epics for agile workflows. Log work time, add comments and attachments, and transition issues through workflow statuses. Create and manage project versions/releases, issue links, filters, and dashboards. Query users, groups, and permissions.
Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.
Create, update, search, and delete delivery and field service orders. Optimize multi-stop routes for drivers across configurable date ranges with options for route balancing, clustering, and depot trips. Retrieve planned routes with stop sequences, scheduled times, travel distances, and polylines. Manage driver parameters including working hours, vehicles, load capacities, and start/end locations. Track driver GPS positions and monitor order completion status. Access proof of delivery data including signatures, photos, barcode scans, and notes. Send customer notifications via email or SMS with order tracking URLs.
Common questions about connecting Optimoroute to AI agents with Metorial.
