How to Use the Humaans MCP in Cursor

Q: Does this MCP server support all Humaans endpoints?

It provides 10 specific tools including getme and listpublicholidays. These cover the core directory and time-off data you need for your daily tasks.

Write code with live Humaans data in Cursor. This MCP server lets your agent pull real-time org structure and employee records while you build.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Humaans MCP to Cursor

Create your Vinkius account to connect Humaans to Cursor and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Humaans with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Agent-driven Humaans lookups in Cursor

Let your agent handle the busywork by using `list_teams` and `list_roles` to verify organizational metadata. The AI injects these live responses directly into your codebase. Stop stubbing out HR data. You’ll be working with the same definitions your company uses for internal routing and access control.

Pull employee context into Cursor

Need to reference an employee record for a script you are writing? Call `get_employee` to bring specific personnel info into your current context. The AI reads the response and updates your code accordingly. It’s a direct line to your HRIS state without manual copy-pasting.

Track time off for project planning

Use `list_leaves` to see who is available before you commit to a deadline. Your Cursor agent can analyze the schedule and warn you about upcoming absences. It keeps your development cycle grounded in reality. You’ll have the full picture of team availability right inside your editor.

Setup guide

Set up Humaans MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Humaans MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Humaans transactions." If the MCP tools are loaded correctly, Cursor will call the Humaans tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "humaans-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Humaans. 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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Humaans now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Humaans MCP in Cursor

Create a .cursor/mcp.json file in your project root. Add the Humaans server definition there so your agent can call the tools during your coding session.

Absolutely. Once the server is registered, you can ask the agent to fetch lists of departments or employees and it will display that data in your chat window.

Yes. This server communicates securely with the Humaans API and does not cache your sensitive employee contact details on disk. It only passes data to your active agent session.

Yes, you can commit your .cursor/mcp.json file to your repository. This ensures everyone on your team has the same access to HRIS tools.

It provides 10 specific tools including `get_me` and `list_public_holidays`. These cover the core directory and time-off data you need for your daily tasks.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript