Namely MCP by usefulapi

io.usefulapi/namely · v1.0.0 · communication

Namely MCP by usefulapi is healthy: it completed an MCP handshake in 737 ms and exposes 17 tools.

Read Namely employee profiles, groups, teams, jobs and reports; update profiles, post to the feed.

Endpoint: https://namely.usefulapi.io/mcp (streamable-http)

Repository · Website · JSON · Add to my inventory

Facts

Users (last 30 days)0
HandshakeHealthy
Auth neededNone
Tool count17
Latency737 ms
Last checked (UTC)2026-10-24T11:30:15.510Z

Health history

Checked (UTC)StatusLatencyError
2026-10-24T11:30:15.510ZHealthy737

Tools (17)

namely_get_meGet the profile of the user the connected token belongs to (name, email, job title, manager, access role). Namely API: GET /profiles/me.
namely_list_profilesList employee profiles (active, pending and inactive unless filtered) with paging, sorting and filters. Returns {profiles, meta:{count}, linked}. Use format=short for a smaller record (ids, names, email, status, job title); the full record includes every custom field the token may see (compensation,
namely_get_profileGet one employee's full profile by id: personal and job data, manager, groups, teams and the custom fields the token may see (can include compensation and other sensitive HR data). Namely API: GET /profiles/{id}.
namely_list_profile_fieldsList the fields of the employee profile as configured at this company (standard and custom), with their labels, sections and the valid format of each value. Namely API: GET /profiles/fields.
namely_list_groupsList all groups (departments, office locations and other company groups). Every group belongs to one group type. Namely API: GET /groups.
namely_get_groupGet one group by id, with the profiles (members) linked to it. Namely API: GET /groups/{id}.
namely_list_group_typesList the group types (the containers of groups, such as Department or Office). Namely API: GET /group_types.
namely_list_teamsList all teams with their team categories. Namely API: GET /teams.
namely_get_teamGet one team by id, with the profiles (members) linked to it. Namely API: GET /teams/{id}.
namely_list_job_titlesList all job titles; each belongs to one job tier. Namely API: GET /job_titles.
namely_list_job_tiersList all job tiers (the levels that group job titles). Namely API: GET /job_tiers.
namely_list_eventsList events of the company home feed (announcements, birthdays, work anniversaries, new arrivals), newest first by default, with limit and after (an event id) for paging. Namely API: GET /events.
namely_list_event_commentsList the comments on a feed event. Namely API: GET /events/{event-id}/comments.
namely_get_reportRun a saved Namely report by id and return its columns and rows (live data; each row is a list in column order). Find the id in the URL of the report in Namely. Reports can contain sensitive HR data such as salary history. Namely API: GET /reports/{id}.
namely_update_profileChange standard fields of an employee profile (name, emails, start date, status, manager, job title). WRITES live HR data. Send only the fields to change. Setting user_status to pending needs a personal_email. Namely API: PUT /profiles/{id}.
namely_create_announcementPost an announcement to the company home feed, visible to every employee. Markdown; to mention a person write [Full Name](/people/<profile_id>). With is_appreciation, mentioned people are appreciated. email_all=true ALSO EMAILS every active employee at their company address (needs the permission) an
namely_create_event_commentAdd a comment to a feed event, posted as the token's user and visible to employees who see the event. Markdown; mention a person with [Full Name](/people/<profile_id>). Namely API: POST /events/{id}/comments.