# Remote Retrieval — how to use (mcp.ai)

Connect your Remote Retrieval account and use 7 tools for IT operations straight from your AI agent. Connect with your own API key. Remote Retrieval automates the logistics of managing equipment returns, providing efficient tracking and management of laptop and monitor returns.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_remote_retrieval?ms=1787291280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `remote_retrieval_create_order`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/remote_retrieval`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/remote_retrieval/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/remote_retrieval/create/order` — Tool to create IT asset retrieval orders for remote employees. Use when you need to schedule pickup of laptops, monitors, cell phones, or tablets from employees. Supports both return-to-company and re
  - body: { orders: object[] }
- `POST https://api.mcp.ai/api/remote_retrieval/get/all/orders` — Tool to retrieve a paginated list of all orders. Use when you need to list orders with optional filters like status or dates. Call after authentication.
  - body: { page?: integer, status?: string, to_date?: string, per_page?: integer, from_date?: string }
- `POST https://api.mcp.ai/api/remote_retrieval/get/company/details` — Tool to retrieve detailed information for a company. Use after confirming a valid company_id.
  - body: { company_id: string, expand_contacts?: boolean, industry_filter?: string, include_financials?: boolean }
- `POST https://api.mcp.ai/api/remote_retrieval/get/device/prices` — Tool to retrieve real-time pricing data for all supported devices. Use when you need current prices for Laptop, Monitor (17-23 inch), Monitor_27 (24-27 inch), Tablet, or Cell Phone.
- `POST https://api.mcp.ai/api/remote_retrieval/get/order/details` — Tool to retrieve specific order details by order ID. Use when you need detailed information about an order including employee info, company info, and shipment status (device_type, send_status, return_
  - body: { oid: string }
- `POST https://api.mcp.ai/api/remote_retrieval/list/pending/orders` — Tool to retrieve list of all pending orders. Use when you need to check orders awaiting payment completion. Results are paginated up to 25 per page.
  - body: { page?: integer }
- `POST https://api.mcp.ai/api/remote_retrieval/validate/user` — Tool to validate the provided API key. Use when you need to confirm the API key's validity.

## Example prompts
- "What can I do in Remote Retrieval?"
- "Show me a summary of my Remote Retrieval account"

## More
- Page: https://mcp.ai/remote_retrieval
- Agent spec (llms.txt): https://mcp.ai/remote_retrieval/llms.txt
- Postman collection: https://mcp.ai/remote_retrieval/postman.json