Vibecoding with Moss

{
  "mcpServers": {
    "moss": {
      "command": "npx",
      "args": ["-y", "@moss-tools/mcp-server"],
      "env": {
        "MOSS_PROJECT_ID": "your-project-id",
        "MOSS_PROJECT_KEY": "your-project-key"
      }
    }
  }
}

You are helping me build an application that uses Moss for real-time semantic search.

## About Moss
Moss is a semantic search runtime for conversational AI with sub-10ms local queries, instant index
updates, same SDK for browser, on-device, and cloud. No separate search infrastructure needed.

## Documentation
- Quickstart:    https://docs.moss.dev/docs/start/quickstart
- Core concepts: https://docs.moss.dev/docs/start/core-concepts
- SDK reference: https://docs.moss.dev/docs/reference/sdk
- API reference: https://docs.moss.dev/api-reference/v1
- MCP server:    https://docs.moss.dev/docs/integrations/mcp-server
- Full doc index (LLM-friendly): https://docs.moss.dev/llms.txt

## Setup
- JS package: @moss-dev/moss  |  Python package: moss
- Credentials: MOSS_PROJECT_ID and MOSS_PROJECT_KEY from https://portal.usemoss.dev

## Key concepts
- createIndex / loadIndex / query is the core flow - see the quickstart for full examples
- Hybrid search: pass alpha (0.0 = keyword, 1.0 = semantic, default 0.8) to query()
- Mutations (createIndex, addDocs, deleteDocs) are async jobs; SDK polls until completion
- Embedding models: moss-minilm (fast, default), moss-mediumlm (higher accuracy), custom (bring your own vectors)
- Metadata filtering on local indexes: $eq, $ne, $in, $gt, $lt, $and, $or operators

## Common errors
- Unauthorized: missing or wrong MOSS_PROJECT_ID / MOSS_PROJECT_KEY
- Index not found: call createIndex() before loading or querying
- Index not loaded: call loadIndex() before query() - query() throws if the index isn't loaded locally
- Missing embeddings runtime: use moss-minilm or moss-mediumlm unless supplying custom vectors