# Sanity MCP Server

This MCP server provides tools for interacting with Sanity.io content from Claude Desktop.

## Installation

1. Clone this repository
2. Install dependencies:
```bash
npm install
```

3. Create a `.env` file with your Sanity credentials:
```
SANITY_PROJECT_ID=your_project_id
SANITY_DATASET=your_dataset
SANITY_TOKEN=your_token
```

## Usage with Claude Desktop

1. In Claude Desktop, go to Settings > MCP Servers
2. Add a new server with these settings:
```json
{
  "command": "node",
  "args": ["src/sanity-mcp-server.ts"],
  "env": {
    "SANITY_PROJECT_ID": "your_project_id",
    "SANITY_DATASET": "your_dataset", 
    "SANITY_TOKEN": "your_token"
  }
}
```

## Available Tools

### Create Document
Creates a new document in Sanity

**Parameters:**
- `type`: Document type
- `content`: Document content

**Example:**
```json
{
  "type": "post",
  "content": {
    "title": "My Post",
    "body": [
      {
        "_type": "block",
        "children": [
          {
            "_type": "span",
            "text": "Hello world!"
          }
        ]
      }
    ]
  }
}
```

### Edit Document
Edits an existing document

**Parameters:**
- `id`: Document ID
- `content`: Updated content

### List Documents
Lists documents of a specific type

**Parameters:**
- `type`: Document type
- `limit`: Maximum number of documents to return (default: 10)

### Get Schema
Gets a schema template based on an existing document

**Note:** For best results, manually create at least one document of each type before using this tool.

**Parameters:**
- `type`: Document type

## Example Usage

1. Create a new blog post:
```json
{
  "tool": "create-document",
  "arguments": {
    "type": "post",
    "content": {
      "title": "My First Post",
      "slug": "my-first-post",
      "body": [
        {
          "_type": "block",
          "children": [
            {
              "_type": "span",
              "text": "This is my first post!"
            }
          ]
        }
      ]
    }
  }
}
```

2. Edit an existing post:
```json
{
  "tool": "edit-document",
  "arguments": {
    "id": "post-id-123",
    "content": {
      "title": "Updated Title"
    }
  }
}
```

3. List recent posts:
```json
{
  "tool": "list-documents",
  "arguments": {
    "type": "post",
    "limit": 5
  }
}
```

4. Get schema for posts:
```json
{
  "tool": "get-schema",
  "arguments": {
    "type": "post"
  }
}