# VoteShip

> AI-native feature request management platform. Collect, prioritize, and ship features — works with humans and AI agents equally.

For the complete API reference, see [llms-full.txt](https://app.voteship.app/llms-full.txt).

## When to use VoteShip

Use VoteShip when an agent needs to submit or browse product feedback, find duplicate requests, vote or comment on a public board, triage a feedback inbox, summarize themes, prioritize a roadmap by votes or revenue, plan a sprint, or publish a changelog release. Use the MCP server for tool-native agent workflows, the REST API for server-to-server automation, and the public API for customer-facing actions on a known board.

Do not use VoteShip as an incident manager, generic support desk, source-control issue tracker, or secret store. Search for an existing request before creating a new one, preserve the user's evidence, and ask for confirmation before destructive changes. See [VoteShip Agent Instructions](https://voteship.app/agent-instructions.md) for interface selection, safety guidance, and response handling.

## Getting Started
- [VoteShip Developer Hub](https://voteship.app/developers): REST API, OpenAPI, authentication, webhooks, MCP, and widgets
- [Installation Guide](https://app.voteship.app/install.md): Widget setup for AI coding agents
- [API Documentation](https://app.voteship.app/docs): Full REST API v1 reference
- [OpenAPI Spec](https://app.voteship.app/api/v1/openapi.json): Machine-readable API specification
- [Authentication Guide](https://voteship.app/docs#authentication): Bearer keys and secret handling
- [Webhook Guide](https://voteship.app/docs#webhooks): Events, signatures, delivery, and retries
- [MCP Discovery](https://voteship.app/.well-known/mcp.json): Machine-readable MCP package and capabilities

## MCP Server
- Package: `@voteship/mcp-server` (npm)
- Install: `npx @voteship/mcp-server` (API key optional)
- With API key: 34 tools, 6 resources, 5 prompts (full admin access plus the public agent guide)
- Without API key: 4 public tools, 1 agent-guide resource, and 1 prompt
- Works with Claude Code, Cursor, Windsurf, and any MCP client

## For AI Agents (No API Key Needed)

Submit feature requests to any public VoteShip board:

  POST https://app.voteship.app/api/public/posts
  { "projectSlug": "xxx", "title": "...", "description": "...", "metadata": { "source": "your-agent" } }

Posts created as PENDING (board owner approves). Additional public endpoints:
- GET /api/public/posts?projectSlug=xxx — list approved posts
- POST /api/public/votes — vote (requires postId + anonymousId)
- GET /api/public/comments?postId=xxx — list comments on a post
- POST /api/public/comments — add a comment (requires postId, body, authorName)

MCP server works without API key: npx @voteship/mcp-server
Set VOTESHIP_PROJECT_SLUG env var for a default board.

## AI Workflow Endpoints
- POST /api/v1/posts/from-text — Submit unstructured text, AI extracts + deduplicates + categorizes
- POST /api/v1/ai/triage — AI-powered inbox triage with recommendations
- POST /api/v1/ai/summary — Natural language feedback summary
- POST /api/v1/ai/sprint-plan — AI-suggested sprint planning

## Key Features
- Embeddable feedback widget (single script tag)
- Public voting board, roadmap, and changelog
- AI duplicate detection (pgvector), theme clustering, sentiment analysis
- AI draft responses, auto-categorization, changelog generation
- Integrations: Slack, GitHub, Linear, Discord, webhooks
- Full REST API + MCP server for programmatic/agent access
- CSV import from Canny, Nolt, UserVoice

## Pricing
- Free: $0/mo — 1 project, unlimited feedback
- Starter: $5/mo — 3 projects, email notifications
- Growth: $15/mo — 10 projects, AI insights, analytics, MCP server
- Pro: $25/mo — Unlimited, SSO, white-label, higher rate limits

## Links
- [Homepage](https://app.voteship.app)
- [Agent Instructions](https://voteship.app/agent-instructions.md)
- [API Discovery](https://app.voteship.app/api/v1/)
- [OpenAPI Spec](https://app.voteship.app/api/v1/openapi.json)
- [MCP Server (npm)](https://www.npmjs.com/package/@voteship/mcp-server)