# VoteShip Agent Toolkit

Official open-source agent integrations for [VoteShip](https://voteship.app),
the feature request, voting board, roadmap, and changelog platform.

## Connect Claude Code

```bash
claude mcp add --transport http --scope user voteship https://voteship.app/mcp
```

## Connect Codex

```bash
codex mcp add voteship --url https://voteship.app/mcp
```

The hosted MCP endpoint exposes public tools, resources, a workflow prompt, and
an interactive board without credentials. For authenticated project
administration, run the local [`@voteship/mcp-server`](./packages/mcp-server)
package with a VoteShip project secret in the MCP host environment.

## Install VoteShip on a website

```bash
npx -y @voteship/cli init --project-key pk_your_public_key
npx -y @voteship/cli verify --url https://your-site.example
```

The [`@voteship/cli`](./packages/cli) installer supports common Next.js, React,
Vue, Vite, SvelteKit, Angular, and plain HTML projects. It is idempotent and
supports `--dry-run` and `--json` for agent workflows.

## Development

```bash
corepack enable
pnpm install
pnpm test
pnpm typecheck
pnpm build
```

## Security

Report suspected vulnerabilities privately to `support@voteship.app`. Do not
include VoteShip project secrets in issues, logs, or screenshots.

## License

MIT