Hello myself Prathyusha. When I decided to apply to StackOne, I did not send
a resume first. I built something with their platform first.
This is the story of building an AI agent using StackOne MCP.
What I Built
An AI agent that onboards a new employee across
4 enterprise platforms automatically — using
StackOne MCP as the single integration gateway.
One command does everything:
npm run onboard --
example employee name: Priya Sharma
Output:
Step 1: Fetching candidate... ✓ Priya Sharma
Step 2: Creating BambooHR record... ✓ Employee #115
Step 3: Creating Notion page... ✓ Checklist created
Step 4: Sending Slack message... ✓ Team notified
Onboarding complete in seconds.
Audit trail written to audit-log.json.
The Problem It Solves
Most companies onboard employees manually:
- HR types data into BambooHR by hand.
- Someone creates a Notion doc from scratch.
- Manager writes a Slack welcome manually.
- IT gets notified separately.
That is 2 to 4 hours of manual work per new hire.
This agent does all of it in seconds.
What is StackOne MCP?
- MCP stands for Model Context Protocol.
- It is an open standard that lets AI agents
- connect to external tools in a structured way.
Without StackOne:
Agent → custom code → BambooHR
Agent → different code → Notion
Agent → another code → Slack
With StackOne MCP:
Agent → ONE endpoint → BambooHR
→ Notion
→ Slack
One API key. One endpoint. 260+ integrations.
Auth, retries, and audit logging handled
automatically by StackOne's Falcon engine.
The Architecture
CLI input
↓
src/index.ts — reads candidate name
↓
src/agent.ts — orchestrates 4 steps
↓
src/stackone.ts — MCP client
↓
api.stackone.com/mcp
↓ ↓ ↓
BambooHR Notion Slack
↓
audit-log.json
Built in TypeScript. 9 files. Clean structure.
Supports multiple candidates in one command:
npm run onboard -- john sarah alex priya
Tech Stack
Language → TypeScript
Runtime → Node.js + tsx
Gateway → StackOne MCP server
HRIS → BambooHR
Docs → Notion
Messaging → Slack
Audit → JSON file
3 Real Errors I Hit
These taught me the most about StackOne MCP.
─────────────────────────────────────────
Error 1 — Missing Accept Header
Not Acceptable: Client must accept both
application/json and text/event-stream
Why: StackOne MCP uses streaming protocol.
Must declare support for both formats.
Fix: Add this header to every request:
"Accept": "application/json, text/event-stream"
─────────────────────────────────────────
Error 2 — Silent BambooHR Redirect
No error thrown. Agent said success.
Employee never appeared in BambooHR.
The response was returning:
"location": "https://www.bamboohr.com"
Instead of:
"location": "https://api.bamboohr.com/
.../mytestorg/.../employees/115"
Why: Wrong BambooHR account connected
in StackOne. Requests went to wrong instance.
Fix: Delete wrong account in StackOne.
Re-link with correct subdomain: mytestorg.
─────────────────────────────────────────
Error 3 — Wrong Slack Tool Name
MCP error -32602: Tool slack_post_message
not found
Why: StackOne names tools differently
from the underlying provider APIs.
Fix: Called tools/list to see all Slack tools.
Correct name was slack_send_message.
Field name was channel_id not channel.
Pro tip: Always use tools/list before
assuming tool names. Saves hours of guessing.
─────────────────────────────────────────
What I Learned About StackOne MCP
- Always accept text/event-stream in headers.
- Each integration has its own Account ID.
- Use tools/list to find exact tool names.
- All tools wrap fields inside body object.
- Wrong account = silent redirect, not error.
- StackOne Logs shows every API call made.
Results
BambooHR → Employee #115 created ✓
Notion → Onboarding page with Day 1 checklist ✓
Slack → Welcome message in #onboarding-alerts ✓
Audit → 4 timestamped entries logged ✓
Final Thought
StackOne MCP made connecting to 4 enterprise
platforms easier than connecting to one platform
the traditional way.
One API key replaced four SDKs.
One endpoint replaced four auth systems.
One integration replaced months of work.
Full code on GitHub:
github.com/prathyushak828/stackone-onboarding-agent
If you are building AI agents that need to touch
enterprise SaaS — StackOne MCP is worth your time.
Top comments (0)