@serviceagent/mcp

@serviceagent/mcp

MCP (Model Context Protocol) server for ServiceAgent. Lets Cursor, Claude Desktop, Windsurf, and other AI coding tools provision and manage ServiceAgent resources directly.

Setup

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "serviceagent": {
      "command": "npx",
      "args": ["@serviceagent/mcp"],
      "env": {
        "SERVICEAGENT_API_KEY": "your_api_key",
        "SERVICEAGENT_TOKEN": "your_jwt_token"
      }
    }
  }
}

Claude Desktop

Add to Claude Desktop settings:

{
  "mcpServers": {
    "serviceagent": {
      "command": "npx",
      "args": ["@serviceagent/mcp"],
      "env": {
        "SERVICEAGENT_API_KEY": "your_api_key",
        "SERVICEAGENT_TOKEN": "your_jwt_token"
      }
    }
  }
}

Available Tools

Tool	Description
create_project	Provision a new demo workspace with a chat widget (no account needed)
get_api_key	Exchange install token for API key, or list existing keys (list requires JWT)
add_widget	Get embed code for the AI chat widget
add_calendar	Get embed code for the calendar booking widget
add_voice_agent	Get setup code for a real-time voice agent
configure_knowledge_base	Seed the AI knowledge base from a URL (SERVICEAGENT_TOKEN required)
list_webhooks	List configured webhook endpoints (SERVICEAGENT_TOKEN required)
create_webhook	Create a webhook to receive events (SERVICEAGENT_TOKEN required)
magic_onboarding	Auto-configure everything from a website URL (SERVICEAGENT_TOKEN required)
get_docs	Search ServiceAgent documentation

Environment Variables

Variable	Required	Description
SERVICEAGENT_API_KEY	For API-key-compatible tools	API key from dashboard
SERVICEAGENT_API_URL	No	API base URL (defaults to https://process.serviceagent.ai)
SERVICEAGENT_TOKEN	For JWT-protected tools	JWT token from POST /v1/auth/login

Auth Model

• No auth needed: create_project, most of add_widget, add_calendar, add_voice_agent, get_docs
• API key works: any future platform/API-key-compatible management routes
• JWT required today: get_api_key with action=list, configure_knowledge_base, list_webhooks, create_webhook, magic_onboarding

The MCP server now fails clearly when a tool requires SERVICEAGENT_TOKEN and it is not configured.

Example Prompts

With this MCP server connected, you can ask your AI assistant:

• "Add a ServiceAgent chat widget to my Next.js app"
• "Set up calendar booking for my website"
• "Create a webhook to listen for new appointments"
• "Configure the AI knowledge base from https://mysite.com"
• "How do I add voice calling to my React app?"

License

MIT