@sarasyn/mcp-server

Public npm package — connect your Sarasyn learner profile to Claude Desktop, Cursor, or any MCP client.

📖 Documentation → https://sarasyn.ai/docs

Quick start

npx -y @sarasyn/mcp-server

See the Getting Started and MCP Credentials guides for setup.

Install

npm install -g @sarasyn/mcp-server

Or use via npx (no global install — recommended for Claude Desktop):

npx -y @sarasyn/mcp-server

Prerequisites

1. A Sarasyn account
2. Completed organization questionnaire (Settings → My Preferences)
3. An API key (sary_live_…) from Settings → API Keys
4. Your organization ID

Details: MCP Credentials guide

Claude Desktop config (easiest)

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "sarasyn": {
      "command": "npx",
      "args": ["-y", "@sarasyn/mcp-server"],
      "env": {
        "SARASYN_API_KEY": "sary_live_YOUR_KEY",
        "SARASYN_ORG_ID": "your-org-id"
      }
    }
  }
}

Full walkthrough: Claude Desktop Setup

Restart Claude Desktop. Tools available:

• sarasyn_mcp/get_learner_profile
• sarasyn_mcp/personalize_output

Tool reference: MCP Tools Reference

Environment variables

| Variable | Required | Description | |----------|----------|-------------| | SARASYN_API_KEY | Yes | sary_live_… from dashboard | | SARASYN_ORG_ID | Yes | Organization ID | | SARASYN_STREAM_URL | No | Default: …/personalizeOutputStream | | SARASYN_API_BASE | No | Default: …/sarasyApi/v1 |

HTTP API (without MCP)

Use the streaming HTTP API from any language — no npm package required.

• HTTP Streaming API guide
• REST API reference

POST https://us-central1-minerva-insights.cloudfunctions.net/personalizeOutputStream
Authorization: Bearer sary_live_...

Documentation

All integration guides, troubleshooting, and API reference:

https://sarasyn.ai/docs

License

MIT