• HIERARCHY
  • LOCATIONS
  • PEOPLE
  • HUMAN

How to map organizational structure with your AI

Connect Humaans to your AI client once. From then on, your agent can walk through your company hierarchy to find people and teams.

Ask AI about this page

Short answer

How can my AI see my company hierarchy?

Your AI uses Humaans to pull lists of departments, teams, and offices. It then identifies specific employees and their reporting lines. You'll get a clear view of your organizational layout through simple chat commands.

Where your data lands.

Organizational visibility.

The AI turns raw HR data into a navigable map of your company.

HIERARCHY

Departmental maps

The AI pulls department and team lists to show how groups are organized. You get a clear view of how different functions sit within the company.

LOCATIONS

Office layouts

Your agent identifies which offices are active and where teams are based. This helps you understand the physical footprint of your workforce.

PEOPLE

Employee directories

The AI finds specific people by looking up team members and their roles. You can quickly identify who belongs to which group.

HUMAN

Manual updates

The AI only reads existing data. If you need to change a reporting line or move a team, you still have to do that in Humaans yourself.

The workflow

What your AI does when the request arrives.

The AI moves through your hierarchy step by step to find the right information.

  1. Identify the scope

    The AI first looks at the high-level structure to see which departments exist.

    list_departments

  2. Drill into teams

    Once it knows the department, it looks for the specific teams within that group.

    list_teams

  3. Locate the office

    The agent checks which physical locations these teams are tied to.

    list_offices

  4. Find the people

    Finally, it pulls the specific employee details to answer your question.

    list_employees

Try it

Copy these to start.

Use these prompts to test the connection.

Starting points

These are basic ways to start. Swap out the department or team names for your actual ones.

Humaans Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_LarqqH4EDHEPnslQdaPVgGeeelzn7f5eRT2uEUac/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Humaans capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "humaans-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_LarqqH4EDHEPnslQdaPVgGeeelzn7f5eRT2uEUac/mcp"
    }
  }
}
Copy into chat04

  • Which departments are currently in Humaans?

  • List all the teams in the Engineering department.

  • Who are the employees working out of the London office?

  • Show me all members of the Product Marketing team.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Humaans once, then ask.

You only need to link your account once. Your credentials stay encrypted and secure, and you can immediately start chatting with your data.

Connect Humaans to your AI

FAQ

How this task behaves.

  • 01

    Can the AI change an employee's manager?

    No. The AI can only read the current structure. You must make any organizational changes directly in Humaans.

  • 02

    Can the AI delete a department?

    No. This MCP is read-only. It cannot delete or modify any data in your Humaans account.

  • 03

    Does the AI know about employees not in Humaans?

    No. The AI only has access to the data it can pull through the Humaans tools.

  • 04

    Can I ask about specific office addresses?

    Yes, if that information is included in the office data provided by Humaans.

  • 05

    How does the AI know which team a person is on?

    It uses the team and employee tools to cross-reference the hierarchy.

  • More questions about Humaans? See everything the Humaans Connector can do

Connect Humaans to Claude, Cursor, ChatGPT & more