@youdotcom-oss/mcp 1.3.4 → 1.3.5-next.5

package/AGENTS.md

@@ -176,6 +176,66 @@ For detailed contribution guidelines, including:
 
 See [CONTRIBUTING.md](./CONTRIBUTING.md)
 
+## Publishing
+
+### Release Process
+
+This package is published to npm via the `.github/workflows/publish-mcp.yml` workflow in the monorepo root.
+
+**Workflow Actions**:
+1. Updates version in `packages/mcp/package.json`
+2. Scans all workspace packages for dependencies on `@youdotcom-oss/mcp`
+3. Updates dependent packages with exact version (e.g., "1.4.0")
+4. Commits all version updates together
+5. Creates GitHub release in private repo
+6. Syncs to OSS repo via git subtree split
+7. Creates GitHub release in OSS repo
+8. Publishes to npm
+
+**Version Format**: Exact versions only (no `^` or `~` prefixes)
+
+```json
+{
+  "dependencies": {
+    "@youdotcom-oss/mcp": "1.3.4"
+  }
+}
+```
+
+**IMPORTANT**: If you add dependencies on other workspace packages, use exact version numbers. The publish workflow will automatically keep them in sync when new versions are released.
+
+### Version Format Convention
+
+This package follows standard Git tagging conventions:
+
+- **Git tags**: `v{version}` (e.g., `v1.3.4`, `v1.4.0-next.1`)
+- **GitHub releases**: `v{version}` (e.g., `Release v1.3.4`)
+- **package.json**: `{version}` (no "v" prefix, e.g., `1.3.4`)
+- **npm package**: `{version}` (no "v" prefix, e.g., `@youdotcom-oss/mcp@1.3.4`)
+
+**When triggering the publish workflow:**
+1. Go to: Actions → Publish mcp-server Release → Run workflow
+2. Enter version WITHOUT "v" prefix: `1.3.4` (not `v1.3.4`)
+3. The workflow automatically adds "v" for Git tags
+4. Validation checks prevent common mistakes
+
+**Example:**
+```bash
+# Workflow input
+Version: 1.3.4
+
+# Produces:
+# - Git tag: v1.3.4
+# - package.json: "version": "1.3.4"
+# - npm: @youdotcom-oss/mcp@1.3.4
+# - Release: https://github.com/.../releases/tag/v1.3.4
+```
+
+**Validation checks in workflow:**
+- Rejects input with "v" prefix
+- Verifies package.json matches release version
+- Ensures no "v" prefix in package.json
+
 ## MCP Server Patterns
 
 ### Tool Registration
@@ -300,22 +360,6 @@ bun run build
 - Use `bun test --bail` to stop after first failure
 - Check your API key rate limits at [api.you.com](https://api.you.com)
 
-#### Docker Permission Issues
-
-**Symptom**: Docker build fails with permission errors
-
-**Solution**:
-
-```bash
-# Ensure Docker daemon is running
-docker info
-
-# Build with sudo if needed (Linux)
-sudo docker build -t youdotcom-mcp-server .
-
-# Check Docker group membership (Linux)
-groups $USER
-```
 
 #### Biome/TypeScript Errors
 
@@ -591,8 +635,8 @@ This section covers local development setup, self-hosting options, and productio
 
 ```bash
 # Clone repository
-git clone https://github.com/youdotcom-oss/youdotcom-mcp-server.git
-cd youdotcom-mcp-server
+git clone https://github.com/youdotcom-oss/mcp-server.git
+cd mcp-server
 
 # Install dependencies
 bun install
@@ -618,38 +662,9 @@ echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | bun src/stdio.ts
 curl http://localhost:4000/mcp-health
 ```
 
-### Self-hosting with Docker
+### Self-hosting
 
-**Build and run:**
-
-```bash
-# Build Docker image
-docker build -t youdotcom-mcp-server .
-
-# Run container with API key
-docker run -d \
-  -p 4000:4000 \
-  --name youdotcom-mcp \
-  -e YDC_API_KEY=your-actual-api-key-here \
-  youdotcom-mcp-server
-
-# Check health
-curl http://localhost:4000/mcp-health
-```
-
-**Docker Compose:**
-
-```yaml
-version: "3.8"
-services:
-  youdotcom-mcp:
-    build: .
-    ports:
-      - "4000:4000"
-    environment:
-      - YDC_API_KEY=${YDC_API_KEY}
-    restart: unless-stopped
-```
+This package supports self-hosting in STDIO or HTTP modes (see deployment modes below).
 
 ### Deployment modes
 
@@ -659,7 +674,6 @@ services:
 | **STDIO Prod** | MCP client integration (local)       | STDIO     | `./bin/stdio.js`                |
 | **HTTP Dev**   | Local HTTP server testing            | HTTP/SSE  | `bun start`                     |
 | **HTTP Prod**  | Remote clients, web apps, production | HTTP/SSE  | `bun run build && bun bin/http` |
-| **Docker**     | Containerized deployment             | HTTP/SSE  | `docker run ...`                |
 
 ### Production deployment
 

package/README.md

@@ -277,7 +277,7 @@ If you encounter a problem, you can report it via email or GitHub:
 
 **Web support:** [You.com Support](https://you.com/support/contact-us)
 
-**GitHub Issues:** [Report bugs and feature requests](https://github.com/youdotcom-oss/youdotcom-mcp-server/issues)
+**GitHub Issues:** [Report bugs and feature requests](https://github.com/youdotcom-oss/mcp-server/issues)
 
 **Tip:** When errors occur, check your MCP client logs - they include a pre-filled mailto link with error details for easy reporting.