# Talenthr — how to use (mcp.ai)

Connect your Talenthr account and use 1 tools for human resources straight from your AI agent. Connect with your own API key. TalentHR is an intuitive, all-in-one HR tool designed to streamline HR operations for businesses.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_talenthr?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `talenthr_assign_permission`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/talenthr`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/talenthr/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/talenthr/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.
  - body: { role_id: string, permissions: object[] }

## Example prompts
- "What can I do in Talenthr?"
- "Show me a summary of my Talenthr account"

## More
- Page: https://mcp.ai/talenthr
- Agent spec (llms.txt): https://mcp.ai/talenthr/llms.txt
- Postman collection: https://mcp.ai/talenthr/postman.json