How do I install @shogo Ai/sdk?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does @shogo Ai/sdk need an API key?

No required environment variable is listed on this record.

What transport does @shogo Ai/sdk use?

@shogo Ai/sdk runs locally over stdio.

When was @shogo Ai/sdk last checked?

Last checked 2026-11-12. Shogo Platform SDK - Zero-boilerplate auth and database for Shogo apps

Serveur MCP @shogo Ai/sdk

Alimenter votre agent

Ajouter ce serveur

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Exécuter sur PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @shogo-ai/[email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add shogo-ai-sdk -- npx -y @shogo-ai/sdk@2.5.4

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "shogo-ai-sdk": {4      "command": "npx",5      "args": [6        "-y",7        "@shogo-ai/[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Exécuter sur PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Lancer

Server facts

Local

Transport: stdio
Version: 2.5.4
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Shogo AI

Shogo is an open-source platform for building AI agents that do real work: reading from your systems, taking actions, and running workflows end to end. TypeScript throughout. Self-host it or use Shogo Cloud.

Website · Launch Studio · Documentation

Shogo combines a Hono API, Expo-based clients, agent runtimes, project runtimes, and a developer SDK into one platform for building and operating agentic products.

License: the SDK and client libraries you actually integrate (@shogo-ai/*, plus the mobile/desktop clients) are MIT. The server components behind Shogo Cloud (apps/api/, packages/agent-runtime/, packages/shared-runtime/) are AGPL-3.0-or-later — a moat against hosted resellers, not a restriction on your own use, modification, or self-hosting. Full breakdown in Open Source Model below and docs/LICENSING.md.

There's no one-command quickstart yet. Running Shogo locally means cloning the repo, installing with Bun, starting Postgres/Redis/MinIO in Docker, and running migrations — realistically a few minutes, not 60 seconds. The real steps are in Local development below.

Open Source Model

Shogo uses a split-license model. AGPL-3.0-or-later guards the cloud-service surface a competitor would need to ship a hosted clone; everything else is MIT so adoption is friction-free.

AGPL-3.0-or-later: apps/api/, packages/agent-runtime/, packages/shared-runtime/
MIT: the @shogo-ai/* libraries, apps/mobile/, apps/desktop/, packages/shared-app/, packages/shared-ui/, packages/ui-kit/, packages/domain-stores/, templates/runtime-template/
CC BY 4.0: apps/docs/, docs/
Proprietary: terraform/, k8s/, deploy-examples/, .github/workflows/ (see INFRASTRUCTURE-LICENSE.md)
The hosted Shogo Cloud offering is proprietary

See docs/LICENSING.md for the full strategy and rationale, plus LICENSE, NOTICE, INFRASTRUCTURE-LICENSE.md, and TRADEMARK.md.

Repository Layout

License is shown inline so the AGPL/MIT boundary is visible at a glance.

Path	License	Purpose
`apps/api/`	AGPL	Hono API server, auth, billing, runtime orchestration
`apps/mobile/`	MIT	Expo app for web, iOS, and Android
`apps/desktop/`	MIT	Local desktop distribution
`apps/docs/`	CC BY 4.0	Documentation site
`packages/sdk/`	MIT	Client SDK; back-compat shims for moved subpaths
`packages/core/`	MIT	Logger, OTEL instrumentation, stream-buffer, chat-message
`packages/agent/`	MIT	Agent loop, model router, hooks, pi-ai adapter
`packages/db/`	MIT	Prisma adapter helpers (PG / SQLite / libSQL)
`packages/email/`	MIT	Transactional email (SES / SMTP / OCI)
`packages/voice/`	MIT	ElevenLabs + Twilio voice infra; React + RN UI
`packages/cli/`	MIT	`validateManifest` / `runDeploy` / `pkg` helpers
`packages/shogo-worker/`	MIT	`shogo-worker` self-host CLI
`packages/model-catalog/`	MIT	Thin re-export shim (workspace-only)
`packages/agent-runtime/`	AGPL	Agent gateway, tools, integrations
`packages/shared-runtime/`	AGPL	Server-side glue (s3-sync, server framework)
`packages/shared-app/`	MIT	Shared app/domain logic
`packages/shared-ui/`	MIT	Shared UI components
`packages/ui-kit/`	MIT	Theme and routing helpers

Quick Start

Local development

Prerequisites:

Install dependencies.

bun install

Create your local env file.

cp .env.example .env.local

Start local infrastructure.

bun run docker:infra

Run database migrations.

bun run db:migrate:deploy

Build the workspace packages (first run / fresh checkout only).

bun run build:packages

Start the app.

bun run dev:all

Open http://localhost:8081.

Self-Hosting

Shogo can be self-hosted locally or on your own infrastructure. For setup details, required environment variables, storage, and deployment notes, see docs/SELF_HOSTING.md.

Local desktop/offline usage is documented in apps/desktop/README.md.

Packages

Published to npm (MIT, lockstep release on the sdk-v* tag):

Package	Description
`@shogo-ai/sdk`	Client SDK — auth, db client, LLM gateway, voice client
`@shogo-ai/core`	Logger, OTEL instrumentation, stream-buffer, chat-message
`@shogo-ai/agent`	Agent loop, model catalog/router, hooks, pi-ai adapter
`@shogo-ai/db`	Prisma adapter helpers (PG / SQLite / libSQL)
`@shogo-ai/email`	Transactional email — SES / SMTP / OCI
`@shogo-ai/voice`	ElevenLabs + Twilio voice; React + React Native UI
`@shogo-ai/cli`	`validateManifest` / `runDeploy` / `pkg` helpers

Old @shogo-ai/sdk/<subpath> imports keep working through deprecated re-export shims; see packages/sdk/MIGRATION.md.

Workspace-only (AGPL):

Package	Description
`@shogo/api`	API server and platform orchestration
`@shogo/agent-runtime`	Agent runtime and tool gateway
`@shogo/shared-runtime`	Server-side glue used only by the AGPL surface above

Workspace-only (MIT):

Package	Description
`@shogo/mobile`	Primary client app
`shogo`	Desktop packaging layer
`@shogo/shared-app`	Shared app/domain logic
`@shogo/shared-ui`	Shared UI components
`@shogo/ui-kit`	Theme and routing helpers
`@shogo/domain-stores`	Domain store layer

Commands

Command	Description
`bun run dev:all`	Start API and web app
`bun run dev:backend`	Start API only
`bun run docker:infra`	Start Postgres, Redis, and MinIO
`bun run db:migrate:deploy`	Apply migrations
`bun run build`	Build the monorepo
`bun run build:packages`	Build all 7 published `@shogo-ai/*` packages
`bun run build:sdk` / `:core` / `:agent` / `:db` / `:email` / `:voice` / `:cli`	Build a single package
`bun run test`	Run tests
`bun run typecheck`	Run TypeScript checks
`bun run lint`	Run linters

Community

CONTRIBUTING.md for contribution guidelines
CLA.md for contributor licensing terms
SECURITY.md for responsible disclosure
TRADEMARK.md for branding and name usage

Documentation

Getting Started -- quickstart guide
docs/GETTING_STARTED.md
docs/ARCHITECTURE.md
docs/SELF_HOSTING.md
packages/sdk/README.md

Ajouter ce serveur

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install @shogo Ai/sdk?

Does @shogo Ai/sdk need an API key?

What transport does @shogo Ai/sdk use?

When was @shogo Ai/sdk last checked?

Documentation

Shogo AI

Open Source Model

Repository Layout

Quick Start

Local development

Self-Hosting

Packages

Commands

Links

Community

Documentation