# Shuffl > Product and integration guides for Shuffl. Use the built-in assistant, or connect your own agent over MCP, the API, the SDK or the CLI. These guides describe the product and contain no workspace data. MCP OAuth connections are available (consent in the browser, one workspace per connection) with knowledge tools plus the actions chosen at consent. API keys with the MCP permission get one MCP tool per endpoint permission they hold. Every tool is checked like the API. The SDK and CLI install from npm as @shuffl/sdk and @shuffl/cli. API writes need exact grants and follow the documented review, confirmation and retry rules. Human documentation: https://shuffl-rebuild.vercel.app/docs Every guide in one file: https://shuffl-rebuild.vercel.app/llms-full.txt Setting up a workspace for someone? Follow [Set up a workspace with your agent](https://shuffl-rebuild.vercel.app/docs/markdown/agent-setup). ## Guides - [Companies and workspaces](https://shuffl-rebuild.vercel.app/docs/markdown/companies-and-workspaces): Keep one workspace for most companies, or add separate spaces for regions, subsidiaries and teams. Human page: https://shuffl-rebuild.vercel.app/docs/companies-and-workspaces - [Set up your workspace](https://shuffl-rebuild.vercel.app/docs/markdown/getting-started): Name your company, set up its first workspace and pick up where you left off. Human page: https://shuffl-rebuild.vercel.app/docs/getting-started - [Connect Slack](https://shuffl-rebuild.vercel.app/docs/markdown/slack): Connect the Shuffl app to Slack, approve new permissions, and know what works on the web without it. Human page: https://shuffl-rebuild.vercel.app/docs/slack - [Invite and enable employees](https://shuffl-rebuild.vercel.app/docs/markdown/employee-access): Invite people or let them join, check they arrived as the right person, and enable employee access. Human page: https://shuffl-rebuild.vercel.app/docs/employee-access - [Find a recovery step](https://shuffl-rebuild.vercel.app/docs/markdown/troubleshooting): Fix common sign-in, setup, knowledge, access and HR sharing problems. Human page: https://shuffl-rebuild.vercel.app/docs/troubleshooting - [Ask Mello](https://shuffl-rebuild.vercel.app/docs/markdown/ask-mello): Ask about work in Chat or Slack, read the sources behind an answer, and get help from HR without leaving the conversation. Human page: https://shuffl-rebuild.vercel.app/docs/ask-mello - [Your profile](https://shuffl-rebuild.vercel.app/docs/markdown/your-profile): Fill in your profile, choose who sees what, and let coworkers find the right person to ask. Human page: https://shuffl-rebuild.vercel.app/docs/your-profile - [Find your way around](https://shuffl-rebuild.vercel.app/docs/markdown/around-shuffl): Where things are on Home, in the menu and on a phone, and the settings that are yours alone. Human page: https://shuffl-rebuild.vercel.app/docs/around-shuffl - [Review and publish knowledge](https://shuffl-rebuild.vercel.app/docs/markdown/knowledge): Turn a policy into a published source with an audience and dates, so Mello can answer from it and cite it. Human page: https://shuffl-rebuild.vercel.app/docs/knowledge - [Manage connected sources](https://shuffl-rebuild.vercel.app/docs/markdown/connected-sources): Connect Google Drive, Notion, Confluence, SharePoint, Dropbox, Box, Guru or BambooHR, and keep imported sources fresh. Human page: https://shuffl-rebuild.vercel.app/docs/connected-sources - [People and the org chart](https://shuffl-rebuild.vercel.app/docs/markdown/people): Find anyone, read the org chart, see who knows whom, and keep the directory right. Human page: https://shuffl-rebuild.vercel.app/docs/people - [Share a request with HR](https://shuffl-rebuild.vercel.app/docs/markdown/hr-requests): Choose who answers HR requests, review what you share before it is sent, and work the queue in Needs you. Human page: https://shuffl-rebuild.vercel.app/docs/hr-requests - [Onboard new hires](https://shuffl-rebuild.vercel.app/docs/markdown/onboarding): Give every new hire a buddy, an introduction, check-ins through their first 90 days and nudges for their manager. Human page: https://shuffl-rebuild.vercel.app/docs/onboarding - [Introduce coworkers with Connections](https://shuffl-rebuild.vercel.app/docs/markdown/connections): Introduce coworkers in Slack on a schedule, choose who gets matched, and see how rounds went. Human page: https://shuffl-rebuild.vercel.app/docs/connections - [Ask one confidential question at a time with Pulse](https://shuffl-rebuild.vercel.app/docs/markdown/pulse): One short question at a time, on Home or in Slack, who sees the answers, and how administrators run it. Human page: https://shuffl-rebuild.vercel.app/docs/pulse - [Praise and badges](https://shuffl-rebuild.vercel.app/docs/markdown/praise): How Shuffl reads your praise channel in Slack, what you see and control, badges people earn, and how administrators set it up. Human page: https://shuffl-rebuild.vercel.app/docs/praise - [Communities](https://shuffl-rebuild.vercel.app/docs/markdown/communities): Groups for interests, places, skills and resource groups, each linked to a Slack channel. Human page: https://shuffl-rebuild.vercel.app/docs/communities - [Celebrate work anniversaries and birthdays](https://shuffl-rebuild.vercel.app/docs/markdown/celebrations): Work anniversaries and birthdays in Slack, what each person decides, and how administrators set it up. Human page: https://shuffl-rebuild.vercel.app/docs/celebrations - [Impact and the HR digest](https://shuffl-rebuild.vercel.app/docs/markdown/impact): See what Mello handled, how much time it saved, and get the numbers by email or Slack on a schedule. Human page: https://shuffl-rebuild.vercel.app/docs/impact - [Workspace settings](https://shuffl-rebuild.vercel.app/docs/markdown/settings): Workspace name and logo, members, roles, API keys, activity, data export and a link to Company settings. Human page: https://shuffl-rebuild.vercel.app/docs/settings - [Billing](https://shuffl-rebuild.vercel.app/docs/markdown/billing): Shuffl is free for every workspace; where the company’s billing state lives, and what to do if an older plan needs attention. Human page: https://shuffl-rebuild.vercel.app/docs/billing - [Use Shuffl with your agent](https://shuffl-rebuild.vercel.app/docs/markdown/agent-quick-start): Use the built-in assistant, or connect your own agent over MCP, the API, the SDK or the CLI. Human page: https://shuffl-rebuild.vercel.app/docs/agent-quick-start - [Set up a workspace with your agent](https://shuffl-rebuild.vercel.app/docs/markdown/agent-setup): Hand workspace setup to Claude Code or another MCP agent: what it does, in what order, and what stays with you. Human page: https://shuffl-rebuild.vercel.app/docs/agent-setup - [Use the SDK and HTTP API](https://shuffl-rebuild.vercel.app/docs/markdown/sdk): Install the TypeScript client from npm, select exact permissions and verify reads before writes. Human page: https://shuffl-rebuild.vercel.app/docs/sdk - [Use the Shuffl CLI](https://shuffl-rebuild.vercel.app/docs/markdown/cli): Run Shuffl operations from scripts without a model, with JSON output and the same endpoint permissions as the SDK. Human page: https://shuffl-rebuild.vercel.app/docs/cli - [Connect an MCP client](https://shuffl-rebuild.vercel.app/docs/markdown/mcp): Connect an agent to the Shuffl MCP server over Streamable HTTP with OAuth or an API key. An API key’s permissions choose its tools, reads and writes alike. Human page: https://shuffl-rebuild.vercel.app/docs/mcp - [API endpoint permissions](https://shuffl-rebuild.vercel.app/docs/markdown/api-permissions): Choose Read and Write grants and look up the permission ID for every supported API operation. Human page: https://shuffl-rebuild.vercel.app/docs/api-permissions ## API reference - [OpenAPI](https://shuffl-rebuild.vercel.app/api/v1/openapi.json): Public methods, paths, inputs, outputs and permission metadata. No workspace data. ## Blog - [How do you answer benefits questions in Slack?](https://shuffl-rebuild.vercel.app/blog/answer-benefits-questions-in-slack): Give general benefits questions one Slack channel, answer them in threads from your current plan guide, and move anything about one person to a private message. In one survey, 79% of employees asked HR for help at least once a month. A plan guide worth linking and a clear rule on what stays private do most of the work. - [243 agent threads in a week: how I rebuilt Shuffl from my phone](https://shuffl-rebuild.vercel.app/blog/how-we-rebuilt-shuffl): Since September 21, 243 Claude Projects threads have built and shipped Shuffl while I dictated from my phone, with up to 127 commits a day. The agents run CI in their own containers, merge and release. When a job needs a login, an agent on my Mac does it with computer use. Here is the setup and how to copy it. - [I rebuilt my 9-year-old startup from scratch, on my phone, in 10 days](https://shuffl-rebuild.vercel.app/blog/the-new-shuffl): Shuffl started in 2017 as a way to get coworkers to meet. We were about to shut it down. Instead I rebuilt all of it, every feature, the website and the logo, in a week and a half on my phone with AI coding agents. It’s that cheap to build and run now, so it’s free. - [Should AI answer your employees' HR questions?](https://shuffl-rebuild.vercel.app/blog/should-ai-answer-hr-questions): Yes, for questions your written policies already answer, as long as every answer cites the approved policy and anything personal goes to a person. Employees don't want AI on its own. Fewer than 10% want AI-only help with benefits, but many are happy with AI and people working together. - [Shuffl 3.0: Service Platform Updates](https://shuffl-rebuild.vercel.app/blog/shuffl-v3-apr-q2-release): Shuffl V3 Product Release centered around engagement and complete control and visibility to manage the Shuffl Program. - [GeekWire Startup Spotlight](https://shuffl-rebuild.vercel.app/blog/geekwire-startup-spotlight): We’re deeply honored to share Shuffl’s story on GeekWire. We treasure the privilege to spread joy and help teams adjust to the new way we work and learn. - [Slack Featured, Staff Pick](https://shuffl-rebuild.vercel.app/blog/slack-featured-staff-pick): Shuffl has been picked by Slack to be featured for a few weeks on their App Directory. - [December 2020 Product Updates](https://shuffl-rebuild.vercel.app/blog/december-2020-product-updates): We are excited to share this month’s product updates (Shuffl v2.2). - [Leadership Spotlight: Student Communities | Meet Other Students](https://shuffl-rebuild.vercel.app/blog/leadership-spotlight-student-communities-meet-other-students): In continuation of our Leadership Spotlight series, we are proud to share stories from our customer leaders on their impact to help their teams stay connected. - [November 2020 Product Updates](https://shuffl-rebuild.vercel.app/blog/shuffl-november-20-product-updates): We are thrilled to be releasing features throughout the week designed to improve shuffl management for Shuffl Admins. - [Leadership Spotlight: Global Enterprise Team](https://shuffl-rebuild.vercel.app/blog/leadership-spotlight-a-global-enterprise-team): We’re proud to shuffl with incredible teams and communities from all around the world. - [Featured on Slack and Product Release Preview](https://shuffl-rebuild.vercel.app/blog/featured-on-slack-and-product-release-preview): Slack’s apps are a brilliant part of the platform that hundreds of thousands of teams use every day. - [Our Customer Impact](https://shuffl-rebuild.vercel.app/blog/slack-marketplace): When the global pandemic emerged, many had an idea of its potential impact and severity. Though, few anticipated its ability to so swiftly change the way we work and connect. - [Shuffl 2.0: Service Platform Updates](https://shuffl-rebuild.vercel.app/blog/shuffl-2): I’m thrilled to announce the below updates to our service functions that span across Shuffl! - [COVID-19: Staying Together, Even Apart](https://shuffl-rebuild.vercel.app/blog/covid-19): These are unique and rapidly changing times we face together. As we all know, the COVID-19 pandemic requires us to adapt constantly. ## Changelog - [October 2, 2026: Pulse actions and who knows what](https://shuffl-rebuild.vercel.app/changelog#2026-10-02): Plan what you’ll do about a Pulse result, ask Mello who knows about a topic, and praise a coworker without leaving Shuffl. - [September 28, 2026: Companies and workspaces](https://shuffl-rebuild.vercel.app/changelog#2026-09-28): Keep your company’s sign-in and administration together, with separate workspaces when you need them. - [September 25, 2026: Home, Praise and Celebrations](https://shuffl-rebuild.vercel.app/changelog#2026-09-25): Employees get a Home page, praise and profiles have more room, and HR can run birthdays, work anniversaries and eNPS from Shuffl. ## Comparisons - [Shuffl + Rippling](https://shuffl-rebuild.vercel.app/compare/rippling): Rippling runs HR, payroll and IT. Shuffl syncs your people from Rippling and adds HR answers, intros, celebrations and praise in Slack. - [Shuffl + HiBob](https://shuffl-rebuild.vercel.app/compare/hibob): HiBob is your HR system. Shuffl syncs people from HiBob and brings HR answers, intros and hand-offs to HR into Slack. - [Shuffl vs Leena AI](https://shuffl-rebuild.vercel.app/compare/leena-ai): Leena AI is an assistant and ticketing tool for HR, IT and finance. Shuffl pairs HR answers with intros, celebrations, pulse and praise in Slack. - [Shuffl vs Moveworks](https://shuffl-rebuild.vercel.app/compare/moveworks): Moveworks is an AI assistant for IT and HR support, now part of ServiceNow. Shuffl pairs HR answers with the culture side: intros, celebrations, pulse and praise. - [Shuffl + Guru](https://shuffl-rebuild.vercel.app/compare/guru): Guru is a company knowledge base. Connect it to Shuffl and Mello answers HR questions from your Guru cards, hands the rest to HR, and runs culture programs too. - [Shuffl vs Glean](https://shuffl-rebuild.vercel.app/compare/glean): Glean searches and answers across all your company’s apps. Shuffl answers HR questions from approved sources, hands the rest to HR, and runs intros, pulse and praise. - [Shuffl vs Slack AI](https://shuffl-rebuild.vercel.app/compare/slack-ai): Slack AI answers from Slack history and connected apps. Shuffl adds HR answers from approved policies, private HR hand-offs, and intros, celebrations, pulse and praise. - [Shuffl vs Donut](https://shuffl-rebuild.vercel.app/compare/donut): Donut runs intros, onboarding journeys, celebrations and shoutouts in Slack. Shuffl does those and also answers HR questions and hands the rest to HR. - [Shuffl vs Bonusly](https://shuffl-rebuild.vercel.app/compare/bonusly): Bonusly is recognition and rewards. Shuffl includes praise and badges alongside HR answers, intros, onboarding, celebrations and pulse. - [Shuffl + Culture Amp](https://shuffl-rebuild.vercel.app/compare/culture-amp): Culture Amp runs engagement surveys and performance. Shuffl adds one-tap pulse questions, HR answers, intros, celebrations and praise in Slack. - [Shuffl + Lattice](https://shuffl-rebuild.vercel.app/compare/lattice): Lattice runs performance, goals and engagement. Shuffl covers the day to day in Slack: HR answers with hand-offs, intros, onboarding, celebrations and praise. - [Shuffl vs Workleap](https://shuffl-rebuild.vercel.app/compare/workleap): Workleap, formerly Officevibe, is surveys, recognition and performance for managers. Shuffl covers HR answers with hand-offs, intros, onboarding, celebrations and praise. ## HR glossary - [Employee Net Promoter Score](https://shuffl-rebuild.vercel.app/glossary/employee-net-promoter-score): Employee Net Promoter Score (eNPS) measures how likely employees are to recommend their company as a place to work, on a scale from −100 to +100. - [Employee turnover rate](https://shuffl-rebuild.vercel.app/glossary/employee-turnover-rate): Employee turnover rate is the percentage of employees who leave an organization during a set period, usually a month, quarter or year. - [Attrition rate](https://shuffl-rebuild.vercel.app/glossary/attrition-rate): Attrition rate is the percentage of employees who leave and are not replaced, which shrinks the workforce over time. - [Employee retention rate](https://shuffl-rebuild.vercel.app/glossary/employee-retention-rate): Employee retention rate is the percentage of employees who stay with an organization through a set period. - [Absenteeism rate](https://shuffl-rebuild.vercel.app/glossary/absenteeism-rate): Absenteeism rate is the share of scheduled work time lost to unplanned absences. - [Time to fill](https://shuffl-rebuild.vercel.app/glossary/time-to-fill): Time to fill is the number of days between opening a job and a candidate accepting the offer. - [Time to hire](https://shuffl-rebuild.vercel.app/glossary/time-to-hire): Time to hire is the number of days between a candidate entering your hiring pipeline and accepting your offer. - [Cost per hire](https://shuffl-rebuild.vercel.app/glossary/cost-per-hire): Cost per hire is the average amount an organization spends to fill one position. - [Offer acceptance rate](https://shuffl-rebuild.vercel.app/glossary/offer-acceptance-rate): Offer acceptance rate is the percentage of job offers that candidates accept. - [Compa-ratio](https://shuffl-rebuild.vercel.app/glossary/compa-ratio): Compa-ratio is an employee’s salary divided by the midpoint of their pay range, showing where they sit in that range. - [Applicant tracking system](https://shuffl-rebuild.vercel.app/glossary/applicant-tracking-system): An applicant tracking system (ATS) is software that manages job postings, applications and candidates through the hiring process. - [Workforce planning](https://shuffl-rebuild.vercel.app/glossary/workforce-planning): Workforce planning is the process of forecasting the people and skills an organization will need and planning how to get them. - [Onboarding](https://shuffl-rebuild.vercel.app/glossary/onboarding): Onboarding is the process of welcoming new hires and helping them become productive, confident members of the organization. - [Preboarding](https://shuffl-rebuild.vercel.app/glossary/preboarding): Preboarding is what happens between a candidate accepting an offer and their first day of work. - [Onboarding buddy](https://shuffl-rebuild.vercel.app/glossary/onboarding-buddy): An onboarding buddy is an experienced employee paired with a new hire to answer everyday questions and help them settle in. - [Offboarding](https://shuffl-rebuild.vercel.app/glossary/offboarding): Offboarding is the process of handling an employee’s departure, from access removal and handover to the final paycheck. - [Employee engagement](https://shuffl-rebuild.vercel.app/glossary/employee-engagement): Employee engagement is how committed and involved employees are in their work and their organization. - [Employee experience](https://shuffl-rebuild.vercel.app/glossary/employee-experience): Employee experience (EX) is the sum of everything employees see, do and feel at work, across the whole employee lifecycle. - [Pulse survey](https://shuffl-rebuild.vercel.app/glossary/pulse-survey): A pulse survey is a short, frequent employee survey that tracks how people feel over time. - [Stay interview](https://shuffl-rebuild.vercel.app/glossary/stay-interview): A stay interview is a conversation with a current employee about what keeps them at the company and what might make them leave. - [Exit interview](https://shuffl-rebuild.vercel.app/glossary/exit-interview): An exit interview is a conversation or survey with a departing employee about their reasons for leaving and their experience at the company. - [Employee recognition](https://shuffl-rebuild.vercel.app/glossary/employee-recognition): Employee recognition is acknowledging employees for their work, effort and milestones. - [Work anniversary](https://shuffl-rebuild.vercel.app/glossary/work-anniversary): A work anniversary is the yearly date marking how long an employee has been with their organization. - [Psychological safety](https://shuffl-rebuild.vercel.app/glossary/psychological-safety): Psychological safety is a shared belief within a team that it is safe to speak up, ask questions and admit mistakes. - [Employee resource group](https://shuffl-rebuild.vercel.app/glossary/employee-resource-group): An employee resource group (ERG) is a voluntary, employee-led group built around a shared identity, background or interest. - [Belonging](https://shuffl-rebuild.vercel.app/glossary/belonging): Belonging is employees’ sense that they are accepted, valued and connected to the people they work with. - [Burnout](https://shuffl-rebuild.vercel.app/glossary/burnout): Burnout is a state of exhaustion, cynicism and reduced effectiveness caused by long-term, unmanaged stress at work. - [Quiet quitting](https://shuffl-rebuild.vercel.app/glossary/quiet-quitting): Quiet quitting describes employees who do the work their role requires and nothing beyond it. - [One-on-one meeting](https://shuffl-rebuild.vercel.app/glossary/one-on-one-meeting): A one-on-one meeting is a recurring private conversation between a manager and a direct report. - [Performance review](https://shuffl-rebuild.vercel.app/glossary/performance-review): A performance review is a formal evaluation of an employee’s work over a set period, usually by their manager. - [360-degree feedback](https://shuffl-rebuild.vercel.app/glossary/360-degree-feedback): 360-degree feedback is a review method that collects feedback on an employee from their manager, peers, direct reports and themselves. - [Performance improvement plan](https://shuffl-rebuild.vercel.app/glossary/performance-improvement-plan): A performance improvement plan (PIP) is a formal document that sets specific goals and a deadline for an employee whose performance is below expectations. - [Objectives and key results](https://shuffl-rebuild.vercel.app/glossary/okrs): OKRs (objectives and key results) are a goal-setting method that pairs a qualitative objective with measurable key results. - [Total compensation](https://shuffl-rebuild.vercel.app/glossary/total-compensation): Total compensation is the full value of an employee’s pay and benefits, including salary, bonuses, equity and employer-paid benefits. - [Pay transparency](https://shuffl-rebuild.vercel.app/glossary/pay-transparency): Pay transparency is openness about how much people are paid and how pay decisions are made, including sharing salary ranges. - [Employee benefits](https://shuffl-rebuild.vercel.app/glossary/employee-benefits): Employee benefits are the non-wage compensation an employer provides, like health insurance, retirement plans and paid time off. - [Open enrollment](https://shuffl-rebuild.vercel.app/glossary/open-enrollment): Open enrollment is the annual period when employees can enroll in, change or cancel their benefits. - [Paid time off](https://shuffl-rebuild.vercel.app/glossary/paid-time-off): Paid time off (PTO) is time away from work that an employee is paid for, including vacation, sick days and personal days. - [At-will employment](https://shuffl-rebuild.vercel.app/glossary/at-will-employment): At-will employment means an employer or employee can end the employment relationship at any time, for any legal reason, without notice. - [Exempt employee](https://shuffl-rebuild.vercel.app/glossary/exempt-employee): An exempt employee is one who is not entitled to overtime pay under US wage and hour law, based on their salary and job duties. - [Human resources information system](https://shuffl-rebuild.vercel.app/glossary/hris): A human resources information system (HRIS) is software that stores employee records and runs core HR processes. - [People operations](https://shuffl-rebuild.vercel.app/glossary/people-operations): People operations is a modern term for human resources that treats employees as internal customers and uses data to improve their experience. - [HR business partner](https://shuffl-rebuild.vercel.app/glossary/hr-business-partner): An HR business partner (HRBP) is an HR professional who works directly with a business unit’s leaders on people strategy. - [Employee handbook](https://shuffl-rebuild.vercel.app/glossary/employee-handbook): An employee handbook is a document that explains a company’s policies, benefits and expectations for employees. - [HR knowledge base](https://shuffl-rebuild.vercel.app/glossary/hr-knowledge-base): An HR knowledge base is a searchable collection of policies, guides and answers that employees use to help themselves. - [HR help desk](https://shuffl-rebuild.vercel.app/glossary/hr-help-desk): An HR help desk is a system for receiving, routing and resolving employee questions and requests to HR.