@asyntai/mcp
Connect any MCP client to your Asyntai account.
Asyntai puts an AI support agent on your website that answers visitors fromyour own content. This package gives your assistant the same 54 tools theAsyntai dashboard has: add knowledge, edit the agent's instructions, readconversations and leads, and reply to a live visitor yourself.
Do you need this?
Probably not, and that is deliberate.
Asyntai runs a hosted MCP server at https://asyntai.com/mcp. If your clientsupports remote MCP servers, which Claude, ChatGPT, Cursor and VS Code all do,add that URL directly and skip this package.
This is for clients that can only launch a local command. It bridges one to theother and handles the sign-in.
Use it
{
"mcpServers": {
"asyntai": {
"command": "npx",
"args": ["-y", "@asyntai/mcp"]
}
}
}
The first run opens a browser once so you can approve access. After that it issilent. You need an Asyntai account; the free plan works.
Commands
npx @asyntai/mcp # run the bridge
npx @asyntai/mcp logout # forget the saved sign-in
npx @asyntai/mcp --help
How it works
It is a transparent proxy. It reads JSON-RPC messages on stdin, posts them tothe hosted server with an Authorization header, and writes the replies tostdout. It does not know what the tools are or what they return, which is whynew tools on the server work here without a new release.
Sign-in is OAuth 2.1 with PKCE, the same flow Claude and ChatGPT use. No APIkey is ever entered. The endpoints are read from the server's publishedmetadata rather than hard-coded, so a route change on the server does notbreak this package.
Where the sign-in is kept
~/.asyntai/mcp-credentials.json, with owner-only permissions where theoperating system supports them. It holds an access token and a refresh tokenfor each server you connect to. logout removes them.
Revoking from the Asyntai side is atasyntai.com/mcp/connections, whichkills the tokens immediately whatever is on disk.
Options
| Variable | Meaning |
|---|---|
ASYNTAI_MCP_URL |
Point at a different server. Defaults to https://asyntai.com/mcp. |
Diagnostics go to stderr. stdout carries the protocol and nothing else.
Development
npm test
No dependencies, and none planned. Node 18 or newer.
Claude Desktop extension
The same bridge ships as a Claude Desktop extension (.mcpb). Install it fromthe Extensions directory in Claude Desktop, or build it yourself:
npx @anthropic-ai/mcpb pack
Privacy Policy
This bridge stores nothing except the OAuth tokens described above, on yourown machine. Every message goes only to the Asyntai server you connected to(by default https://asyntai.com/mcp), which processes it under theAsyntai privacy policy. No analytics,no third-party services, no telemetry from this package.
Links
MIT.
