Tuskway MCP server

Q: How do I add Tuskway MCP to Claude Code?

Run `claude mcp add --transport http plugin https://tuskway.com/mcp` in your terminal. Add `--scope user` to make it available in every project.

Q: How do I add Tuskway MCP to Cursor?

Open `~/.cursor/mcp.json` and add the server under `mcpServers`, using the Cursor config shown in the install section above.

Commit Nov 11, 2026

tuskway/plugin · javascript · MIT

Lets AI agents and software teams plan, design, and manage tickets through a shared epic notebook.

Also known as Tuskway/plugin, plugin

remote Project Management

Install GitHub ↗

Stars: 0
Tools: —
Downloads, 30 days: —
Latest version: 0.1.4
Last commit: Nov 11, 2026
License: MIT

What is Tuskway MCP?

Tuskway lets AI agents and software teams plan, design, and manage tickets through a shared epic notebook.

Summary generated from the project's README

About Tuskway MCP server

Planning, designing, and managing software tickets through a shared epic notebook is what Tuskway enables for AI agents and software teams. This tool connects to a hosted MCP server to provide nine distinct workflow skills that facilitate collaborative project management. It is designed to work across a wide variety of development environments including Claude Code, Cursor, Codex, Copilot CLI, Grok Build, OpenCode, Pi, and Gemini CLI.

Users interact with the server via OAuth sign-in within their chosen client rather than using manual access tokens. The setup involves installing the plugin directly from the repository, as it is not currently listed in the standard Claude or Cursor plugin directories. Because the server operates over streamable HTTP, it provides a centralized way for different agents to access and synchronize design and ticket data within a unified workspace.

What you can do with it

1Synchronize design documentsAn AI agent can use the built-in skills to ensure design files are aligned with the shared epic notebook.
2Integrate with coding assistantsTeams can add Tuskway capabilities to their existing workflows in Cursor or Claude Code.

Written from the project's README. Every use case is checked against a quote from it.

How to install Tuskway MCP

Formats verified 10 Nov 2026

Claude CodeCursorVS CodeCodexGemini CLI

$ claude mcp add --transport http plugin https://tuskway.com/mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "plugin": {
      "url": "https://tuskway.com/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "plugin": {
      "type": "http",
      "url": "https://tuskway.com/mcp"
    }
  }
}

~/.codex/config.toml

[mcp_servers.plugin]
url = "https://tuskway.com/mcp"

~/.gemini/settings.json

{
  "mcpServers": {
    "plugin": {
      "httpUrl": "https://tuskway.com/mcp"
    }
  }
}

No environment variables or API keys required.Setup guides:Claude Code Cursor VS Code Claude Desktop

README

View on GitHub

Tuskway plugin

One plugin folder, plugins/tuskway, for Claude Code, Cursor, Codex, Copilot CLI, Grok Build, OpenCode, and Pi. Grok Bot uses the Cursor install.

The plugin connects to the hosted MCP server at https://tuskway.com/mcp. Sign-in is OAuth in the client. The package contains no access tokens, hooks, rule files, or subagents.

Nine workflow skills are in plugins/tuskway/skills/.

Install

Install from this repository. It is not listed in the Claude, Cursor, or Codex plugin directories. The hosted server is listed in the official MCP Registry as com.tuskway/tuskway.

Agent	Install	Sign in
Claude Code	`/plugin marketplace add tuskway/plugin`, then `/plugin install tuskway@tuskway`	`/mcp`, select `plugin:tuskway:tuskway`
Cursor (team)	Dashboard → Plugins & MCPs → Team Marketplaces → Import from Repo `https://github.com/Tuskway/plugin`. Members install from Customize.	Cursor's sign-in prompt
Cursor (individual)	Customize → Add Marketplace → Import from GitHub at User scope, then Add in the Personal tab.	Cursor's sign-in prompt
Grok Bot	Use the Cursor install. Complete GitHub auth if Cursor asks to sync plugins.	Through Cursor
Codex	`codex plugin marketplace add tuskway/plugin`, then `codex plugin add tuskway@tuskway`	`codex mcp login tuskway`
Copilot CLI	`copilot plugin marketplace add tuskway/plugin`, then `copilot plugin install tuskway@tuskway`	`/mcp auth tuskway`
Grok Build	`grok plugin install tuskway/plugin`	`/mcps`, select tuskway, press `i`
OpenCode	`npx skills add tuskway/plugin --agent opencode` and `opencode mcp add tuskway --url https://tuskway.com/mcp`	`opencode mcp auth tuskway`
Pi	`pi install git:github.com/tuskway/plugin` and `pi mcp add tuskway --url https://tuskway.com/mcp`	`pi mcp login tuskway`
Gemini CLI	`gemini extensions install https://github.com/Tuskway/plugin`	Gemini's sign-in prompt

Update with the client's marketplace update command. Pi and OpenCode update by running their install commands again.

MCP

Two files name the server tuskway at https://tuskway.com/mcp.

plugins/tuskway/mcp.json is the Agent Plugins document. The server is streamable-http with type and url only. That schema rejects any other field, including auth and extensions. Codex drops a server entry that includes extensions, so this file does not declare OAuth. Sign in with the client's MCP login.

.mcp.json is { "type": "http", "url": "https://tuskway.com/mcp" }. Claude Code treats a url without type as stdio. Cursor reads .mcp.json before mcp.json. .cursor-plugin/plugin.json pins mcpServers to ./.mcp.json.

Codex requires onboardingSkill to be a ./ path to a packaged SKILL.md. Both Codex manifests set it to ./skills/setup-tuskway/SKILL.md.

The root package.json is "private": true, so npm publish does not upload this package. Pi installs the git repository and loads plugins/tuskway/skills.

server.json names the same server for the official MCP Registry: com.tuskway/tuskway over streamable HTTP at https://tuskway.com/mcp. gemini-extension.json and GEMINI.md are the Gemini CLI extension at the repository root. The Gemini CLI gallery also needs the GitHub topic gemini-cli-extension on this repository.

Check the package

node --test scripts/test-plugin.mjs
node scripts/sync.mjs --check
node scripts/validate.mjs
node scripts/package-limits.mjs
npm run build:openai-zip
node --test scripts/test-manifests.mjs scripts/test-build-claude.mjs evals/mock-tuskway.test.mjs evals/grade.test.mjs

sync.mjs --check compares manifest versions and does not rewrite them or create a tag. validate.mjs checks skill frontmatter, the local size budget, and resource links. package-limits.mjs fails on a symlink, a submodule, more than 512 files, or a non-image file over 256 KiB under plugins/tuskway. All nine skills are required, including sync-design-tuskway. evals/ runs those skills against a mock server, not https://tuskway.com.

npm run build:openai-zip writes dist/tuskway-openai-<version>.zip. The archive root holds plugin.json, mcp.json, skills/, and assets/. npm run build:openai-zip -- --folder <name> places that same root in one top-level directory and adds no sibling entries. The build checks the Agent Plugins 1.0.0 schemas, checks that each skill frontmatter name matches its folder, and fails if a file matches a credential pattern. The package does not include test credentials, reviewer instructions, apps, or .app.json.

Release

Raise version in every manifest when skills or listing data change. node scripts/sync.mjs --check fails when any manifest version differs.

Tag the merged commit and push the tag. Use the version from the manifests:

git checkout main
git pull origin main
git tag vX.Y.Z
git push origin vX.Y.Z

The tag workflow publishes a GitHub release and attaches dist/tuskway-openai-X.Y.Z.zip. If that job cannot attach the ZIP, upload the same file to the release. Do not put access tokens in the ZIP, this README, or CI logs.

If server.json changed in the release, republish it to the official MCP Registry after the tag is pushed. Authenticate with DNS for tuskway.com, then run mcp-publisher publish from the repository root so com.tuskway/tuskway matches the new version.

Before an OpenAI or Claude submission, run claude plugin validate ./plugins/tuskway when the Claude CLI is installed. The package workflow runs that command when claude is on the runner.

Claude directory

The Claude plugin directory accepts only Markdown, text, JSON, YAML, and PNG, JPEG, GIF, WebP, or ICO images. This repository keeps assets/logo.svg and skills/sync-design-tuskway/scripts/drift.mjs for the other platforms.

To publish the Claude distribution:

npm run build:claude

That writes a stripped copy to dist/claude. Push that tree to Tuskway/plugin-claude and tag the same version as the manifests.

License

MIT

Read full README

Tuskway MCP questions

How do I add Tuskway MCP to Claude Code?

Run claude mcp add --transport http plugin https://tuskway.com/mcp in your terminal. Add --scope user to make it available in every project.

How do I add Tuskway MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

What authentication method does Tuskway use?

Sign-in is handled via OAuth within the client.

Does the plugin package include access tokens?

No, the package contains no access tokens, hooks, rule files, or subagents.

Facts

Nov 14, 2026

Stars: 0
Downloads, 30 days: —
Latest version: 0.1.4
Last commit: Nov 11, 2026
License: MIT
Transport: remote
Package: —

Tuskway ↗

Community publisher

Published by an independent maintainer.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/tuskway/plugin.svg)](https://hostedmcp.org/servers/tuskway/plugin/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

About Tuskway MCP server

What you can do with it

1Synchronize design documentsAn AI agent can use the built-in skills to ensure design files are aligned with the shared epic notebook.
2Integrate with coding assistantsTeams can add Tuskway capabilities to their existing workflows in Cursor or Claude Code.

Written from the project's README. Every use case is checked against a quote from it.

Agent

Install

Claude Code

/plugin marketplace add tuskway/plugin, then /plugin install tuskway@tuskway

/mcp, select plugin:tuskway:tuskway

Cursor (team)

Dashboard → Plugins & MCPs → Team Marketplaces → Import from Repo https://github.com/Tuskway/plugin. Members install from Customize.

Cursor's sign-in prompt

Cursor (individual)

Customize → Add Marketplace → Import from GitHub at User scope, then Add in the Personal tab.

Cursor's sign-in prompt

Grok Bot

Use the Cursor install. Complete GitHub auth if Cursor asks to sync plugins.

Through Cursor

Codex

codex plugin marketplace add tuskway/plugin, then codex plugin add tuskway@tuskway

codex mcp login tuskway

Copilot CLI

copilot plugin marketplace add tuskway/plugin, then copilot plugin install tuskway@tuskway

/mcp auth tuskway

Grok Build

grok plugin install tuskway/plugin

/mcps, select tuskway, press i

OpenCode

npx skills add tuskway/plugin --agent opencode and opencode mcp add tuskway --url https://tuskway.com/mcp

opencode mcp auth tuskway

pi install git:github.com/tuskway/plugin and pi mcp add tuskway --url https://tuskway.com/mcp

pi mcp login tuskway

Gemini CLI

gemini extensions install https://github.com/Tuskway/plugin

Gemini's sign-in prompt

node --test scripts/test-plugin.mjs node scripts/sync.mjs --check node scripts/validate.mjs node scripts/package-limits.mjs npm run build:openai-zip node --test scripts/test-manifests.mjs scripts/test-build-claude.mjs evals/mock-tuskway.test.mjs evals/grade.test.mjs

Tuskway MCP questions

How do I add Tuskway MCP to Claude Code?

Run claude mcp add --transport http plugin https://tuskway.com/mcp in your terminal. Add --scope user to make it available in every project.

How do I add Tuskway MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

What authentication method does Tuskway use?

Sign-in is handled via OAuth within the client.

Does the plugin package include access tokens?

No, the package contains no access tokens, hooks, rule files, or subagents.

Tuskway MCP server

What is Tuskway MCP?

About Tuskway MCP server

What you can do with it

How to install Tuskway MCP

Install Tuskway MCP in Claude Code

Install Tuskway MCP in Cursor

Install Tuskway MCP in VS Code

Install Tuskway MCP in Codex

Install Tuskway MCP in Gemini CLI

README

Tuskway plugin

Install

MCP

Check the package

Release

Claude directory

License

Tuskway MCP questions

Tuskway MCP server

What is Tuskway MCP?

About Tuskway MCP server

What you can do with it

How to install Tuskway MCP

Install Tuskway MCP in Claude Code

Install Tuskway MCP in Cursor

Install Tuskway MCP in VS Code

Install Tuskway MCP in Codex

Install Tuskway MCP in Gemini CLI

README

Tuskway plugin

Install

MCP

Check the package

Release

Claude directory

License

Tuskway MCP questions