developer-toolsapi_key

Talenthr

TalentHR is an intuitive, all-in-one HR tool designed to streamline HR operations for businesses.

Verdict

Talenthr's MCP lets your team manage role-based access control directly from Switchy. @mention it to assign or revoke permissions for specific roles in your HR system without opening the admin panel. Most useful for ops leads and HR admins who need to adjust access on the fly—during onboarding sprints, offboarding workflows, or when spinning up new project teams. One caveat: you'll need valid role and permission IDs before invoking the tool, so keep a reference doc handy or ask the MCP to validate IDs first.

Common use cases

  • Grant onboarding access during new hire setup
  • Revoke permissions when employees change teams
  • Audit role assignments before compliance reviews
  • Adjust contractor access for project milestones
  • Sync permissions after org chart changes

Integration

Vendor
Talenthr
Category
developer-tools
Auth
API_KEY
Tools
1
Composio slug
talenthr

Tools

  • Assign Permission

    Tool to assign permissions to a specific role. use when you need to grant or revoke permissions for a role after validating both role and permission ids.

Setup

Setup guide

  1. 11. Open your Switchy workspace and navigate to Settings > Integrations > Developer Tools. 2. Find Talenthr in the list and click Connect. 3. You'll be prompted to paste your Talenthr API key—generate one from your Talenthr account under Settings > API Access. 4. Copy the key and paste it into the Switchy dialog, then click Authorize. 5. Switchy confirms the connection with a green checkmark. 6. Open any Space and type '@Talenthr assign permission to role [role_id] with permission [permission_id]' to test—if the MCP responds with a success message, you're live. 7. Keep a list of your role and permission IDs in a pinned note inside the Space so your team can reference them quickly.

What teammates see: by default, memories from Talenthr are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Onboard New Engineer

@Talenthr assign permission 'repo_write' to role 'engineer_l2'. Confirm the change and list any other permissions this role currently has.
Open in a Space →

Revoke Contractor Access

@Talenthr revoke permission 'billing_admin' from role 'contractor_external'. Verify the role no longer has financial system access.
Open in a Space →

Audit Manager Permissions

@Talenthr list all permissions for role 'manager_ops'. Flag any that seem overly broad for a non-technical role.
Open in a Space →

Promote Team Lead

@Talenthr assign permissions 'timesheet_approve' and 'team_manage' to role 'lead_design'. Confirm both are active.
Open in a Space →

Sync Post-Reorg Roles

@Talenthr assign permission 'project_admin' to role 'pm_growth' and revoke it from role 'pm_legacy'. Summarize the changes.
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@Talenthr show me all permissions currently assigned to the 'Engineering Manager' role

Output

The Engineering Manager role currently has 12 permissions assigned: View Employee Records, Edit Team Members, Approve Time Off Requests, Access Salary Information (view-only), Create Performance Reviews, View Department Budget, Edit Job Descriptions, Approve Expense Reports (up to $5,000), Access Recruitment Pipeline, Schedule Interviews, View Company Policies, and Generate Team Reports. This role does not have permissions for: Modify Salary Data, Delete Employee Records, or Access Executive Dashboard.

Notes

This read-heavy example demonstrates querying existing role permissions. The MCP's single tool focuses on assignment/revocation, so this illustrative response assumes the AI can infer current state from context or prior queries. In practice, you may need to know role IDs beforehand or retrieve them through separate API calls outside this MCP's scope.

Prompt

@Talenthr assign the 'Approve Expense Reports' permission to the Team Lead role, effective immediately

Output

Permission assigned successfully. The 'Approve Expense Reports' permission (ID: perm_exp_approve_001) has been granted to the Team Lead role (ID: role_tl_eng_002). This change is now active across all 8 users currently assigned to the Team Lead role. They can now approve expense reports up to the $2,500 threshold defined in your company policy. Audit log entry created: 2024-01-15 14:32 UTC.

Notes

This write example shows the core capability of the MCP's assign_permission tool. You must provide valid role and permission IDs—the tool validates both before making changes. Be aware this immediately affects all users with that role, so confirm the scope before executing. No rollback mechanism is exposed through this MCP.

Prompt

@Talenthr review our current role structure and recommend which permissions the 'Junior Developer' role should have removed to follow principle of least privilege

Output

Based on the Junior Developer role's current 9 permissions, I recommend removing 3 for least-privilege compliance: (1) 'Delete Production Database Backups'—juniors shouldn't have destructive access to prod data; (2) 'Modify CI/CD Pipeline Configuration'—this affects entire team deployments; (3) 'Access All Employee Salary Data'—juniors need visibility into their own compensation only. Keep the remaining 6 permissions (View Code Repositories, Create Pull Requests, Access Development Environment, Submit Time Off Requests, View Team Calendar, Access Documentation). Would you like me to revoke these three permissions now?

Notes

This synthesis example pairs the MCP's permission-assignment capability with AI reasoning about security posture. The AI analyzes existing permissions and recommends changes, then offers to execute the revocations. This workflow requires you to confirm role/permission IDs are correct before the AI calls assign_permission with revocation parameters. Useful for security audits, but always validate recommendations against your org's actual access requirements.

Use-case deep-dives

Onboarding contractor access control

When Talenthr MCP works for contractor permission setup

A 6-person agency onboards 2-3 contractors per month and needs to grant repo access, Slack channels, and internal tool permissions within the first hour. The Talenthr MCP handles the permission-assignment step if your HR system already uses Talenthr's role structure. The single tool validates role IDs and permission IDs before assignment, which prevents the common mistake of granting admin access to a junior contractor. This works when your permissions map cleanly to Talenthr roles. If your team uses custom RBAC logic outside Talenthr (like GitHub teams or AWS IAM policies), you're still scripting those separately. Best fit: small teams with straightforward role definitions who want to automate the Talenthr piece of onboarding without building a custom integration.

Support team seasonal role changes

Talenthr MCP for temporary permission escalation

A 12-person SaaS support team promotes 3 agents to tier-2 roles during a product launch, then reverts them after 6 weeks. The Talenthr MCP lets you script the permission change in a Switchy workflow that triggers on a calendar date or Slack command. The tool's validation step catches typos in role or permission IDs before you accidentally grant database access to a tier-1 agent. This scenario assumes your support tooling (Zendesk, Intercom) syncs permissions from Talenthr; if those tools use their own RBAC, the MCP only updates the HR record, not the actual access. The buying call: if Talenthr is your source of truth for role definitions and you're tired of manual permission updates during team shifts, this MCP closes that loop.

Compliance audit permission snapshots

When Talenthr MCP isn't enough for SOC 2 evidence

A 20-person fintech startup needs quarterly snapshots of who had which permissions for SOC 2 compliance. The Talenthr MCP only assigns permissions; it doesn't export or log historical access. If your auditor asks 'who had admin access to the payment gateway on March 15?', you're still pulling that from Talenthr's UI or API separately. The MCP is useful for scripting permission changes during the quarter (like revoking access when someone moves teams), but it won't generate the audit trail. For compliance-heavy teams, pair this MCP with a separate logging tool or use Talenthr's native audit features. The threshold: if you need read-only reporting or historical queries, this single-tool MCP doesn't cover it.

Frequently asked

What does the Talenthr MCP do in Switchy?

It lets your AI agents assign permissions to roles in your Talenthr account. The MCP exposes one tool that validates role and permission IDs, then grants or revokes access. Useful if you're automating onboarding workflows or adjusting team access based on project changes without opening the Talenthr dashboard.

Do I need admin access to connect Talenthr MCP?

Yes. The MCP uses an API key that must have permission to modify role assignments in Talenthr. If your key can't write to the permissions layer, the tool will fail. Check with your Talenthr admin to generate a key with the correct scope before connecting it in Switchy.

Can the Talenthr MCP create new roles or permissions?

No. It only assigns existing permissions to existing roles. You still create roles and define permissions in Talenthr's UI or via their full API. The MCP is narrowly scoped to the assignment step, which is the repetitive part teams want to automate inside agent workflows.

Why use this MCP instead of Talenthr's API directly?

The MCP wraps the permission-assignment endpoint so your AI agents can call it in natural language without you writing API client code. If you already have scripts that hit Talenthr's API, keep using them. The MCP is faster for ad-hoc agent tasks like 'revoke contractor access to payroll data'.

Who on the team should connect the Talenthr MCP?

Whoever owns your Talenthr instance and can generate API keys with write permissions. Typically an HR ops lead or IT admin. Once connected, any Switchy workspace member can invoke the tool through agents, but the underlying permissions still respect Talenthr's role hierarchy.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.