# Remote.com MCP for HRIS data. AI Agent Connect > Remote.com MCP lets your AI agent interact with your global HRIS. Instead of digging through dashboards or exporting CSVs, you can ask your agent about employee status, leave balances, contractor invoices, or payroll runs. It uses the official Remote API to pull real-time data from your company account into any MCP-compatible client like Claude or Cursor. ## Overview - **Category:** human-resources - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_rYovVDkAuvp6TxI4IQtJlxSY42bzpa5zLdN8TcDj/ai-agent-connect - **Tags:** hris, global-payroll, employer-of-record, remote-work, payroll, benefits-administration, contractor-management ## Description You can stop jumping between tabs to find basic people-ops information. This MCP connects your Remote.com account to your AI client, turning your agent into a specialized HR assistant. If you need to know who is out of the office, which contractors have pending invoices, or the status of a specific payroll run, you just ask. It handles the heavy lifting of querying the Remote API to fetch roster details, time-off requests, and expense claims. You can even use it to plan international hiring by checking which countries Remote supports and viewing local public holidays. It works with your existing company API token, meaning your agent sees exactly what you see in your Remote dashboard. Whether you are a founder checking hiring feasibility or a finance lead reconciling expenses, this MCP puts your global workforce data inside your natural language workflow. ## Tools ### get_employment Retrieves full details for a specific employment once you have the ID. ### get_employment_basic_information Fetches the v2 basic profile for a single employment. ### list_company_departments Provides a list of all departments within a specific company. ### list_contractor_invoices Fetches all invoices generated for contractor employments. ### list_countries Shows the list of countries where Remote can facilitate hiring and payments. ### list_expenses Retrieves expense claims from the system. ### list_payroll_runs Lists monthly payroll runs and shows whether they are draft, processing, or paid. ### list_timeoff Fetches time-off requests using ISO date formats. ### list_timesheets Retrieves timesheet entries for your team. ### get_leave_policy_summary Provides a summary of leave policy balances for a specific employment. ### list_companies Returns a list of all companies associated with your Remote account. ### list_country_holidays Returns the public holidays for a specific country and year. ### list_employments Lists your employees and contractors, with options to filter by status or type. ### list_payslips Returns a list of payslips for your employees. ## Prompt Examples **Prompt:** ``` How many active employees do we have, and what countries are they in? ``` **Response:** ``` You have 47 active employees across 9 countries. The largest groups are in the US (14), Germany (8), and Brazil (6). ``` **Prompt:** ``` Which contractors have invoices issued but not yet paid? ``` **Response:** ``` Three contractors have unpaid invoices totaling $18,400. Two are approved and awaiting payout, while one is still pending approval. ``` **Prompt:** ``` Which public holidays fall in Portugal in 2026? ``` **Response:** ``` In 2026, Portugal has holidays on Jan 1, Apr 3, Apr 25, May 1, Jun 4, Jun 10, Aug 15, Oct 5, Nov 1, Dec 8, and Dec 25. ``` ## Capabilities ### Roster Management Your agent can list all employees and contractors or pull specific contract terms. ### Leave Tracking The AI can check time-off requests and current leave policy balances. ### Financial Auditing Your agent can pull payslips, expense claims, and contractor invoices. ### Payroll Monitoring The AI can check the status of monthly payroll runs. ### Global Hiring Research Your agent can identify supported countries and local public holidays. ## Use Cases ### Payroll Reconciliation Ask your agent to check the status of the latest payroll run to ensure everyone was paid on time. ### Contractor Management Identify which contractors have outstanding invoices that need immediate attention. ### Leave Planning Check employee leave balances or upcoming time-off requests to manage team capacity. ### Expansion Planning Verify which countries Remote supports and check their holiday calendars before hiring new talent. ## Benefits - Eliminates the need to manually export CSVs for simple HR questions. - Provides real-time access to payroll and invoice status. - Centralizes global hiring research within a single chat interface. - Reduces time spent navigating complex HRIS dashboards. ## How It Works Connecting to your Remote data is a direct process that keeps your credentials secure. 1. Subscribe to the Remote.com MCP on Vinkius. 2. Generate a company API token in your Remote dashboard under Company Settings. 3. Connect your preferred AI client like Claude or Cursor to Vinkius. 4. Ask your agent questions about your employees, payroll, or expenses. ## Frequently Asked Questions **Is my data safe with this MCP?** Yes. The connection uses a read-only API token that you generate in your Remote account, meaning the AI can only read information and cannot make changes to your HRIS. **Which AI clients can I use?** You can use any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code. **Can I use this for testing purposes?** Yes. If you use a token starting with `ra_test_`, the MCP will interact with your Remote sandbox environment instead of production. **How do I see my company's departments?** You can simply ask your agent to list the departments for your company, and it will use the list_company_departments tool to find them. **Does this work for contractors too?** Yes. The MCP can list both employees and contractors, and it specifically includes tools for managing contractor invoices. **Where do I get my Remote API token?** Sign in to Remote, open **Company Settings → Integrations & APIs** and generate a company API token. Tokens are environment-bound: an `ra_live_` token only works against production, and an `ra_test_` token only against the sandbox. **Can this server create or change records in Remote?** No. This server only reads Remote's list and show endpoints — employments, leave, timesheets, payslips, expenses, invoices, payroll runs and reference data. Nothing is written or deleted. **Why did the API reject a filter I passed, like employment_id on timesheets?** Remote's endpoints do not all accept the same filters — for example timesheets takes only status, and expenses takes none. The instructions on each tool state exactly which filters that endpoint supports; if a filter is missing, fetch the wider list and match records by id.