SmartHR MCP. Query your entire HR database via conversation.
SmartHR connects your organization's sensitive employee database directly to any AI client. You can query roster details, organizational structure, payroll records, and even dependent information using plain language. It lets you access deep HR data without ever switching tabs or logging into the SmartHR portal.
Give Claude and any AI agent real-world access
Retrieves the full list of current staff members along with their basic metadata.
Lists all official departments and job positions, helping you understand how roles fit together organizationally.
Fetches detailed information about a specific person, including their employment status or registered dependents.
Securely queries both active and historical payroll ledgers for compliance checks and reporting.
Provides a list of all registered business establishments or branch offices the company operates.
Ask an AI about this
Waiting for input…
What AI agents can do with SmartHR MCP with 8 Tools
Use these tools to gather everything from department lists and job roles to detailed personnel profiles and current payroll records.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using SmartHR MCPList Crews
Retrieves a full roster of all current employees in the system.
Get Crew Details
Pulls comprehensive data for one specific employee using their internal ID.
List Departments
Lists every organizational department defined within the company structure.
List Positions
Provides a list of all official job titles or roles available in the organization.
List Employment Types
Shows all recognized employment statuses (e.g., full-time, contract).
List Payrolls
Generates a list of recorded payroll records for various employees.
List Establishments
Lists all registered business locations or office branches the company operates.
List Crew Dependents
Fetches details about dependents linked to a specific employee profile.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on each call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with SmartHR, then connect any of our 5,200+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,200+ others, all in one place
- Add new capabilities to your AI anytime you want
- Connections are secured and governed automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog weekly
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by SmartHR. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS CLOUD
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on each call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Dealing with siloed HR information is exhausting.
Right now, finding basic employee data means opening the SmartHR portal, navigating through departments, and clicking into individual profiles. If you need a report on all contract workers in the London office who started last quarter, you end up jumping between roster views, position lists, payroll ledgers, and establishment maps. You're spending more time managing tabs than analyzing data.
With this MCP connected through Vinkius, that process disappears. Instead of 15 clicks across four different screens, you simply ask your AI agent: 'Show me all contract workers in the London office who started last quarter.' It combines list_establishments, list_employment_types, and list_crews instantly, giving you a clean answer.
The SmartHR MCP gives you instant access to full employee records.
Manual auditing used to require running separate reports for payroll (list_payrolls) and dependents (list_crew_dependents), which often showed conflicting or incomplete data. You'd spend hours cross-checking IDs just to piece together a picture of an employee's whole situation.
Now, you ask your agent to pull the full profile. It handles combining get_crew_details with list_crew_dependents automatically, giving you one single source of truth without needing to run multiple reports or manually match records.
What SmartHR MCP does for your AI
Your AI agent interacts with your company's human capital records through natural conversation. Instead of navigating complex web portals just to find out a department structure or someone’s employment type, you ask the question and get the answer instantly. This MCP reads your internal database directly.
Whether you need an overview of all employees, want to check payroll histories, or track specific job roles across multiple locations, everything is accessible from one place. It takes the friction out of managing sensitive organizational data, letting you focus on the insights rather than the clicks. Vinkius hosts this catalog so your AI agent can access powerful tools like this without needing dozens of separate subscriptions.
It’s designed for deep querying: check employee rosters using list_crews to get a full headcount, or use list_departments and list_positions together if you need to map out internal hierarchies. You'll find it significantly faster than any manual process.
019d7609-6aa4-7150-8de2-914d00768935 How to set up SmartHR MCP
The bottom line is you talk to your AI client like talking to an HR partner, and it pulls data straight from SmartHR without any manual steps on your end.
Subscribe to this MCP and provide your SmartHR Access Token and Subdomain credentials.
Connect your preferred AI client (like Claude, Cursor, etc.) to the Vinkius catalog via the MCP connection.
Ask your agent a natural language question; it uses the available tools to query your employee database and deliver the summarized answer.
Who uses SmartHR MCP
This MCP is for anyone who deals with internal company structure or employee records regularly. It’s perfect for the HR manager tired of switching between payroll sheets and org charts, or the department lead needing quick access to job role counts across multiple sites.
Auditing compensation using list_payrolls or checking an employee's dependents via list_crew_dependents in a single chat session.
Requesting the agent to fetch a list of active job positions using list_positions and cross-referencing them with current team members.
Checking office locations using list_establishments or verifying which departments are housed in specific buildings.
Benefits of connecting SmartHR MCP
Stop switching tabs. Instead of clicking through multiple screens to find out who reports to whom, ask the agent directly for organizational structure details by listing departments and positions.
Audit payroll records instantly. You can use list_payrolls to check historical compensation data without having to export a file or query the finance system manually.
Get deep employee context fast. Need to know about an individual? The get_crew_details tool pulls all primary information, including dependents listed by list_crew_dependents, in one go.
Map your company footprint easily. Use list_establishments if you need to confirm which office locations are active or how many branches the business has set up.
Handle compliance checks better. By accessing both list_employment_types and get_crew_details, you can verify employee status alongside their basic profile data.
SmartHR MCP use cases
Auditing a team's compensation
The HR Manager needs to check if all employees in the Sales department are on the correct pay scale. They ask the agent to cross-reference list_departments, list_positions, and then query list_payrolls for anomalies.
Onboarding a new team member
A Department Lead asks the AI agent who reports into their newly created division. The agent uses list_positions to confirm the role exists and then pulls relevant crew data using list_crews for immediate visibility.
Checking compliance for international staff
A Security Team member needs to know if an employee has registered dependents while also checking if that employee lives at a specific branch. They query get_crew_details and list_establishments together.
SmartHR MCP tradeoffs
What to watch out for, and the recommended way to handle each one.
Manual web navigation
The user opens the SmartHR dashboard, clicks on 'Employees,' then filters by 'Department A.' Next, they click 'Payroll' and manually search for names. It takes 15 clicks.
Just ask your agent: 'List all employees in Department A and show their payroll status.' The MCP runs the necessary checks using list_crews, list_departments, and list_payrolls automatically.
Using outdated tools
Trying to guess if an employee is full-time or contractor just by looking at their profile description. These descriptions aren't standardized.
Use the list_employment_types tool first. Then, ask your agent to retrieve specific details using get_crew_details and filter by the correct employment type.
When to use SmartHR MCP
You should use this MCP if your primary need is data retrieval from internal HR systems. If you need to know 'who,' 'what department,' or 'how much money' related to an employee, this is your tool. Don't use it if you need to change records—this MCP can only read and report on existing data. For instance, if the goal is to submit a new expense claim or hire someone, you need a different application that allows write access. This MCP is purely for reading organizational truth.
Frequently asked questions about SmartHR MCP
Can I use SmartHR MCP to find out how many employees work at a specific branch? +
Yes. You can combine list_establishments with list_crews by asking your agent for the employee count associated with a given location code.
Does SmartHR MCP show me salary information? +
It shows payroll records using list_payrolls, which means you can audit compensation scaling and view historical pay data. However, it doesn't give general salary estimates.
How do I find out an employee's job role or title? +
The MCP uses list_positions to show all official roles available in the company. You can then cross-reference this with get_crew_details for specific employees.
Is SmartHR MCP secure enough for sensitive payroll data? +
Yes, it is designed to securely query your internal database through natural language interfaces, keeping the interaction within your controlled AI client environment.