Prototype · Preview: every server in the official registry, synced every 30 minutes. Reviews and accounts come in a later step.
PopNx MCPMCP servers for people who use AI · explained in plain words

Kolay IK MCP by usefulapi

by m190version 1.1.3i★ –iRuns in the cloud
Registry nameio.usefulapi/kolay-ik

Install

Overview

Description from the maker (original English)

Read employees, leave and payroll; create leave, time records and events in Kolay IK.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Install

Pick the AI app you use, then copy the settings.

Before you install

You need

Which app do you use?

Pick your app above. We remember it, so next time the button says “Install in …”.

Works in Claude on the web, desktop and mobile:

  1. Open Settings → Connectors
  2. Press Add custom connector
  3. Paste the address below and press Add
  4. If it asks you to sign in, sign in with the maker
SettingsConnectors1+ Add2https://…3
https://kolay-ik.usefulapi.io/mcp

Run this in your terminal

claude mcp add --transport http kolay-ik https://kolay-ik.usefulapi.io/mcp

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "kolay-ik": {
      "url": "https://kolay-ik.usefulapi.io/mcp"
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "kolay-ik": {
      "type": "http",
      "url": "https://kolay-ik.usefulapi.io/mcp"
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

ChatGPT connects only to servers on the internet:

  1. Open ChatGPT on the web → Settings → Connectors (Apps)
  2. Press Create or Add (some plans need Developer mode under Advanced first)
  3. Paste the address below, give it a name and save
  4. If it asks you to sign in, sign in with the maker
SettingsConnectors1+ Create2https://…3
https://kolay-ik.usefulapi.io/mcp

Menu names can differ slightly by plan and over time.

Your choice stays on this device in a cookie; no account needed.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Tool names and descriptions exactly as the server reported them on Nov 6, 2026. The maker wrote them, not us; we show them as plain text.

  • kolayik_get_me

    The Kolay IK user the API token belongs to: id, name, email, work email. A cheap check that the connection works. GET /v2/profile/me.

  • kolayik_list_people

    List employees (id, first and last name), 60 per page. By default only active employees; set status to terminated for people who left. Search by name with q. Filter by hire date (active people) or termination date (terminated people). The reply has total, currentPage and lastPage

  • kolayik_get_person

    Full profile of one employee: contact data, employment dates, contract, units, compensation and custom data fields. National id numbers and bank numbers are removed. GET /v2/person/view/{id}.

  • kolayik_get_person_summary

    Short profile of one employee: name, contact data, current units (company, location, department, position) and manager. GET /v2/person/view-summary/{id}.

  • kolayik_get_person_leave_balances

    Leave entitlement of one employee per leave type: earned, used, carried over and unused days. GET /v2/person/leave-status/{id}.

  • kolayik_list_person_trainings

    Trainings assigned to one employee. GET /v2/person/list-trainings/{id}.

  • kolayik_list_person_fields

    The custom data fields a person can have (fieldToken, type, category). Use the fieldToken in kolayik_update_person and kolayik_create_person. GET /v2/person/show-available-data-fields.

  • kolayik_list_units

    The organization tree: unit types (company, branch, department, position ...) and their items with ids. GET /v2/unit/show-unit-tree.

  • kolayik_list_approval_processes

    The approval chains configured in the account (leave, expense and similar), with their steps and approvers. Filter by name or by a person in the steps. GET /v2/approval-process/list.

  • kolayik_list_leaves

    List leave (time off) records, newest data first as the vendor orders them. Filter by status, a date range or one person. Each record has the leave type, dates, person, replacement, status (approved/waiting/rejected) and used days. GET /v2/leave/list.

  • kolayik_get_leave

    One leave record with type, dates, return date, comment, person, replacement person, status and used days. GET /v2/leave/view/{id}.

  • kolayik_create_leave

    WRITE: records leave for an employee and deducts the used days from their balance. The vendor may approve it immediately, and it is visible to the employee and their manager. Find the leave type id in an existing leave record (kolayik_list_leaves) or the person's balances (kolayi

  • kolayik_list_timelogs

    List time records (work hours, overtime) with person, start and end, minutes used, status and type. Filter by person, type, status and date range. The reply has searchCount, totalCount, page and limit. POST /v2/timelog/list (a read).

  • kolayik_get_timelog

    One time record by id. GET /v2/timelog/view/{id}.

  • kolayik_create_timelog

    WRITE: adds a time record (work hours or overtime) for an employee. With status approved it counts immediately (overtime may flow into payroll); with waiting it enters the approval process. Not idempotent: a second call creates a second record. POST /v2/timelog/create.

  • kolayik_delete_timelog

    WRITE (destructive): permanently deletes one time record. This cannot be undone. DELETE /v2/timelog/delete/{id}.

  • kolayik_list_transactions

    List employee transactions (expenses, advance payments, bonuses, overtime pay, deductions) with amount, currency, status, paid flag and items. Filter by person, type, status, paid and date range. POST /v2/transaction/list (a read).

  • kolayik_get_transaction

    One transaction (expense, advance, bonus ...) with its items. GET /v2/transaction/view/{id}.

  • kolayik_list_expense_categories

    Expense categories of the account (for example taxi, meals), optionally filtered by title or enabled state. GET /v2/expense/list-categories.

  • kolayik_list_payrolls

    Payroll runs of a year: id, period, number of employees, payslips created, errors and total employer cost. Needs a token with the payroll:list scope. Use the id with kolayik_get_payroll_sheet. GET /v2/payroll/list.

  • kolayik_get_payroll_sheet

    The full payroll sheet (carsaf bordro) of one payroll run: every employee's gross, net, tax and insurance columns. This is sensitive salary data of all employees (or the filtered ones). Needs a token with the payroll-sheet:view scope. Filter by name, status, salary period, insura

  • kolayik_list_events

    List company calendar events (meetings, holidays) with title, start, end and comment. Filter by text and date range. The reply has searchCount, totalCount, page and limit. GET /v2/event/list.

  • kolayik_get_event

    One calendar event. GET /v2/event/view/{id}.

  • kolayik_create_event

    WRITE: adds an event to the company calendar, visible to the employees who see it. Not idempotent. POST /v2/event/create.

  • kolayik_update_event

    WRITE: changes the title, times or comment of a calendar event (the vendor requires title, start and end). PUT /v2/event/update/{id}.

  • kolayik_delete_event

    WRITE (destructive): permanently deletes one calendar event. This cannot be undone. DELETE /v2/event/delete/{id}.

  • kolayik_list_trainings

    List the trainings defined in the account. Filter by title text. The reply has searchCount, totalCount, page and limit. GET /v2/training/list.

  • kolayik_get_training

    One training with its details. GET /v2/training/view/{id}.

  • kolayik_create_person

    WRITE: adds a new employee (only first and last name are required). Creates a real HR record that may send the person an invitation, depending on the account settings. Not idempotent: calling it twice creates a duplicate. Further data goes in data_fields (see kolayik_list_person_

  • kolayik_update_person

    WRITE: changes basic data of one employee; only the fields you pass change. Pass null for an optional field to clear it. Further data goes in data_fields (see kolayik_list_person_fields). Changes the HR record immediately. PUT /v2/person/update.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 6, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified against the domain usefulapi.io (the registry checks domain ownership)

  • … Not checked yet

    Still maintained

    We have not read this repo from GitHub yet

  • … Not checked yet

    Has a licence

    We have not read this repo from GitHub yet

  • ✓ Pass

    Endpoint responds

    Responded in 29 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 30 tool descriptions and found no hidden instructions to the AI

Compared with others in Otheri

  • More stars than 0% of the other 32466 servers in this category
  • Published to the registry more recently than 97% of the other 32466 servers in this category
  • Basic checks equal to or better than 100% of the other 32466 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Kolay IK MCP by usefulapi safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed –, and the latest version (1.1.3) reached the registry yesterday.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, HotCodePush

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

by formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Runs on your computer★ 440MITUpdated 14 months ago
Install

Remote Desktop Commander

by desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Runs in the cloud★ 211Updated yesterday
Install

HotCodePush

by hotcodepush-team

Manage over-the-air (OTA) updates for React Native, Expo, Capacitor and Cordova apps.

Runs in the cloudUpdated today
Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Kolay IK MCP by usefulapi

Use your Kolay IK account from Claude, Cursor, or any MCP client. Read employees, leave, time records, expenses, payroll and calendar events, and create leave or time records, change events and employee records. Hosted, no local install: connect with your own credentials.

Live endpoint: https://kolay-ik.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://kolay-ik.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http kolay-ik https://kolay-ik.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
{

"mcpServers": { "kolay-ik": { "url": "https://kolay-ik.usefulapi.io/mcp" } } }

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Kolay IK credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/kolay-ik/

On first connect you provide your Kolay IK API token, created in Kolay IK under Ayarlar → Geliştirici Ayarları → API Token Oluştur. The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
kolayik_get_mereadGet the token's user
kolayik_list_peoplereadList people
kolayik_get_personreadGet a person
kolayik_get_person_summaryreadGet a person summary
kolayik_get_person_leave_balancesreadGet leave balances
kolayik_list_person_trainingsreadList a person's trainings
kolayik_list_person_fieldsreadList person data fields
kolayik_list_unitsreadList organization units
kolayik_list_approval_processesreadList approval processes
kolayik_list_leavesreadList leave records
kolayik_get_leavereadGet a leave record
kolayik_create_leavewriteCreate a leave record
kolayik_list_timelogsreadList timelogs
kolayik_get_timelogreadGet a timelog
kolayik_create_timelogwriteCreate a timelog
kolayik_delete_timelogwriteDelete a timelog
kolayik_list_transactionsreadList transactions
kolayik_get_transactionreadGet a transaction
kolayik_list_expense_categoriesreadList expense categories
kolayik_list_payrollsreadList payroll periods
kolayik_get_payroll_sheetreadGet a payroll sheet
kolayik_list_eventsreadList calendar events
kolayik_get_eventreadGet a calendar event
kolayik_create_eventwriteCreate a calendar event
kolayik_update_eventwriteUpdate a calendar event
kolayik_delete_eventwriteDelete a calendar event
kolayik_list_trainingsreadList trainings
kolayik_get_trainingreadGet a training
kolayik_create_personwriteCreate a person
kolayik_update_personwriteUpdate a person
kolayik_usage_statusmetaUsage status (free-tier meter)
kolayik_request_featuremetaRequest a missing feature
kolayik_upgrademetaUpgrade to Pro or Pro+
kolayik_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

\*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to support@usefulapi.io.

Pro covers this server only. Subscribe with kolayik_upgrade (it returns a Stripe Checkout link). Cancel any time with kolayik_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running kolayik_upgrade before then undoes the cancel. Or write to support@usefulapi.io.

License

MIT — see LICENSE. Documentation only; the server is hosted.

Ask PopNx