Remote Retrieval MCP server

Connect Remote Retrieval to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Remote Retrieval MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the list orders tool in Remote Retrieval
  • Use the create return order tool in Remote Retrieval
  • Use the get company details tool in Remote Retrieval
  • Use the get order details tool in Remote Retrieval
  • Use the get device prices tool in Remote Retrieval
  • Use the get current user tool in Remote Retrieval

Supported Tools

list_orders

List Orders

Retrieve equipment return orders with pagination support. Returns order details including payment status, shipping status, employee and company information, and shipment tracking. Supports cursor-based pagination (25 orders per page).

create_return_order

Create Return Order

Create one or more equipment return orders for remote employees. Supports returning laptops, monitors, cell phones, and tablets. Orders can be either "Return To Company" (with optional data destruction services) or "Recycle with Data Destruction". When using "Return To Company", you can optionally add data destruction with return to company, or data destruction with forwarding to a new employee.

get_company_details

Get Company Details

Retrieve the registered company profile information associated with the authenticated API key. Returns the company name, email, full address, and account creation date.

get_order_details

Get Order Details

Retrieve detailed information for a specific equipment return order by its order ID. Returns employee and company details, device type, and full shipment tracking status for both outbound (box to employee) and return (device to company) shipments.

get_device_prices

Get Device Prices

Retrieve real-time pricing for all supported equipment return types. Monitor prices are split into standard (17–23 inches) and Monitor_27 (24–27 inches) categories.

get_current_user

Get Current User

Validate the connected API key and retrieve the associated user email address.

create_orders_from_csv

Create Orders from CSV

Create equipment return orders by uploading CSV content in the Remote Retrieval order template format.

Connect Remote Retrieval to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Remote Retrieval in Metorial. In your Metorial portal, enable the Remote Retrieval MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Remote Retrieval tools.

Run Remote Retrieval through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Remote Retrieval and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Remote Retrieval tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Remote Retrieval

Notion

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.

GitHub

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.

Microsoft Outlook

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.

Linear

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.

Airtable

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.

Jira

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.

Technical notes for Remote Retrieval

Manage IT equipment return and recovery logistics for remote employees. Create single or bulk orders to retrieve laptops, monitors, tablets, and cell phones via prepaid shipping boxes. Track order status through the full lifecycle — from shipping label creation to device delivery. Supports "Return To Company" and "Recycle with Data Destruction" order types, with optional data destruction services. Retrieve device pricing, order details, payment status, shipment tracking, and company profile information. Create bulk orders from CSV content and check the connected user's email address.

Frequently asked questions

Common questions about connecting Remote Retrieval to AI agents with Metorial.

  1. How many tools does the Remote Retrieval MCP server have?
    The Remote Retrieval MCP server exposes 7 tools, including List Orders, Create Return Order, Get Company Details. Each one is governed and traced through Metorial.
  2. Remote Retrieval exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Remote Retrieval MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Remote Retrieval and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Remote Retrieval MCP server yourself or use the hosted gateway.

Connect Remote Retrieval to production AI agents

See how Metorial gives your team governed access to Remote Retrieval, with tracing and security controls built in.