• CONTACT
  • STRUCTURE
  • ROSTERS
  • HUMAN

How to query workforce directory data with your AI

Connect Factorial to your AI client to pull live employee details and organizational structures. You can ask about specific people or team setups through a single chat window.

Ask AI about this page

Short answer

How can I query my workforce directory with AI?

Your AI uses Factorial to pull employee profiles, contact info, and team hierarchies. You can ask for specific people or list entire departments to get the info you need. Here is how the data moves from Factorial to your chat.

Data outcomes

Where your information lands

The AI pulls specific records from Factorial to answer your questions.

CONTACT

Instant contact info

The AI finds specific contact details for any person in your directory. You get the phone numbers or emails you need without opening HR software.

STRUCTURE

Team organization

Ask about how teams are built or who reports to whom. The AI maps out the organizational hierarchy for you.

ROSTERS

Employee lists

Get a full list of people in a specific department or team. This helps you see exactly who is in a group at once.

HUMAN

Manual edits required

The AI only reads existing data. If you need to change a job title or update a phone number, you must do that inside Factorial.

The workflow

What your AI does when the request arrives.

Your agent translates your questions into specific data requests.

  1. Find employees

    The AI searches the directory to identify the specific people you are asking about.

    list_employees

  2. Get profile info

    Once the person is found, the AI pulls their specific contact and professional details.

    get_employee_details

  3. Check team lists

    The AI looks up how company teams are organized to answer questions about departments.

    list_company_teams

  4. Deliver data

    The AI presents the requested employee or team information directly in your chat window.

    get_employee_details

Try it

Copy these to start.

Use these prompts to test the connection.

Starting points

These are opening lines. Swap out the names and department titles for the actual people or teams in your Factorial account.

Factorial Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_TyON9Jn6V1WzfAjzuwlRSDq13vVfh9YiK3NRqFg8/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 — Factorial capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "factorial-alternative-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_TyON9Jn6V1WzfAjzuwlRSDq13vVfh9YiK3NRqFg8/mcp"
    }
  }
}
Copy into chat04

  • Who is the manager for the Marketing team?

  • Show me the contact information for Sarah Jenkins.

  • List all employees currently in the Engineering department.

  • Which teams are part of the Operations division?

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

Start here

Connect Factorial once, then ask.

Click the link to authorize the connection. Your login stays encrypted on our side, and you can immediately start chatting with your directory.

Connect Factorial to your AI

FAQ

How this task behaves

  • 01

    Can the AI change employee information?

    No. The AI only reads data. Any changes to employee records must be made inside Factorial.

  • 02

    Can the AI delete employees?

    No. This MCP is read-only and has no tools to delete or modify any records.

  • 03

    Can I ask about team hierarchies?

    Yes. The AI can look up how teams are organized and who reports to whom.

  • 04

    Does the AI see all employee data?

    The AI only accesses the data points provided by the directory tools. It cannot see files or documents not included in the profiles.

  • 05

    Can I use this to add new hires?

    No. The AI can only query existing data. You must add new employees through Factorial.

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

Connect Factorial to Claude, Cursor, ChatGPT & more