@serviceagent/sdk
Server-side TypeScript and Node.js SDK
The backend API client for ServiceAgent integrations, knowledge base search, CRM sync, workflows, analytics, and automation.
20-second quickstart
npm
npm install @serviceagent/sdkExample
import { ServiceAgent } from '@serviceagent/sdk';
const sa = new ServiceAgent({
apiKey: process.env.SERVICEAGENT_API_KEY,
baseURL: process.env.SERVICEAGENT_API_URL || 'https://process.serviceagent.ai',
});
const results = await sa.searchKnowledgeBase('What are your weekend hours?');What this package is for
Server-side API access from Node.js and TypeScript
Use this package when that capability should be a first-class part of your product or integration workflow.
Knowledge base search, CRM sync, workflows, analytics, and billing
Use this package when that capability should be a first-class part of your product or integration workflow.
Backend integrations for your own product or internal tooling
Use this package when that capability should be a first-class part of your product or integration workflow.
When to use it
- You need server-to-server API access
- You want a typed backend client instead of hand-written fetch calls
- You are building automations, background jobs, or admin surfaces
How it differs from the other ServiceAgent packages
- Unlike @serviceagent/react and @serviceagent/nextjs, this is not a browser UI package
- Unlike @serviceagent/mcp, this is meant for your runtime code, not AI coding assistants
- Unlike @serviceagent/cli, this is a runtime dependency
Real-world use cases
Search the knowledge base before generating answers
A concrete production scenario this package is well-suited for.
Sync contacts and deals with your CRM
A concrete production scenario this package is well-suited for.
Drive workflows and reporting from backend jobs
A concrete production scenario this package is well-suited for.
Connect ServiceAgent data into internal admin tools
A concrete production scenario this package is well-suited for.
Related packages
Prompts and queries this package should answer well
- How do I call ServiceAgent from my backend?
- What is the ServiceAgent Node.js SDK?
- How do I search the ServiceAgent knowledge base in TypeScript?
Tip
If you are comparing packages, start with the recommended use cases and the quickstart above, then check the related packages section if you need a different level of control.
Need a codegen-ready prompt?
Open the prompt builder to generate a Cursor or Claude implementation prompt that already references @serviceagent/sdk, the right env vars, and the relevant ServiceAgent docs pages.