@shogo Ai/sdk

odin_ai

Shogo Platform SDK - Zero-boilerplate auth and database for Shogo apps

Add to Cursor Add to VS Code Run on PlugMCP

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

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

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

Add to Cursor Add to VS Code Run on 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@1.10.0

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

Run on 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.

Launch

Server facts

Local

Transport: stdio
Version: 1.10.0
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

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

FAQ

Questions

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-10-28. Shogo Platform SDK - Zero-boilerplate auth and database for Shogo apps

From the publisher

Documentation

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
`packages/domain-stores/`	MIT	Domain store layer
`templates/runtime-template/`	MIT	Project template

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

@shogo Ai/sdk

odin_ai

Shogo Platform SDK - Zero-boilerplate auth and database for Shogo apps

Databases

Add to Cursor Add to VS Code Run on PlugMCP

GitHub npm Website

Add to Cursor Add to VS Code Run on PlugMCP

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

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

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

Add to Cursor Add to VS Code Run on 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@1.10.0

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

Run on 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.

Launch

Server facts

Local

Transport: stdio
Version: 1.10.0
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

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

FAQ

Questions

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-10-28. Shogo Platform SDK - Zero-boilerplate auth and database for Shogo apps

From the publisher

Documentation

Shogo AI

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.

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
`packages/domain-stores/`	MIT	Domain store layer
`templates/runtime-template/`	MIT	Project template

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

Add this server

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

Add this server

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