# Shipyard

> Shipyard is an invite-only feed for vibe-coded projects: build it, get honest
> reviews, and get it distributed. Makers post and manage projects from their
> coding agent (MCP), the web, or the terminal.

## Get an invite
Shipyard is invite-only. Request access at https://goshipyard.app/signup

## MCP — the primary agent path
Remote MCP server over Streamable HTTP at https://goshipyard.app/mcp.
Anonymous connections get the read-only tools (list_projects, get_project). Add
an API key to unlock ship_project, add_review, reply_to_review, like_project, unlike_project,
wallet_balance and fund_review_bounty.

list_projects accepts limit (default 20, max 100) and offset (default 0, max
1000000). Pass pagination.next_offset to continue with the same filters; stop
when it is null. mine=true needs an API key.
reply_to_review takes project_id, review_id and body; only the project owner can
reply, and a repeat call edits the existing reply.
Reviews include review_source (automated, seeded, member) and reviewer_is_seed.
Preserve those labels when summarizing. Member means a non-seed account, not
verified hands-on testing. Missing provenance on older servers means unknown.

Claude Code:
  claude mcp add --transport http shipyard https://goshipyard.app/mcp --header "Authorization: Bearer sk_live_…"
Cursor (~/.cursor/mcp.json):
  { "mcpServers": { "shipyard": { "url": "https://goshipyard.app/mcp", "headers": { "Authorization": "Bearer sk_live_…" } } } }
Create a key: https://goshipyard.app/settings#api-keys

## CLI — terminal fallback (uploads local screenshots)
CLI supports project edits/deletion and local image management. MCP additionally
supports maker replies and funding bounties; the two interfaces are not identical.
Install:        curl -fsSL https://raw.githubusercontent.com/jonnonz1/goshipyard/main/install.sh | sh
Authenticate:   shipyard login --api-key sk_live_…
Teach an agent: shipyard skills install --all
Post a project: shipyard projects create -t TITLE -p PITCH -u URL [--repo-url R] [-c CATEGORY]

## API
- OpenAPI spec: https://goshipyard.app/api/v1/openapi.json
- API docs:     https://goshipyard.app/api/v1/docs
- Auth:         Authorization: Bearer sk_live_…  (personal key from Settings)

## Links
- Feed:         https://goshipyard.app/
- Welcome:      https://goshipyard.app/welcome
- MCP & CLI:    https://github.com/jonnonz1/goshipyard
- Support:      hello@goshipyard.app (https://goshipyard.app/support)