# research-publish

MCP server for publishing markdown AI research entries into a Convex `aiResearch` table.

The server is environment-pinned at startup:

- `-dev` binds the server to your dev deployment credentials.
- `-prod` binds the server to your prod deployment credentials.

The MCP host should provide the target deployment's `.convex.site` URL and write key through environment variables.

## Required backend contract

This MCP expects a protected Convex HTTP endpoint at:

- `POST /studio/ai-research`

Request body:

```json
{
  "title": "Release notes",
  "body": "# Heading\n\nMarkdown body",
  "model": "gpt-5.4",
  "prompt": "Summarize the migration plan"
}
```

## Environment variables

- `CONVEX_SITE_URL`
- `CONVEX_WRITE_KEY`

Optional:

- `CONVEX_PUBLISH_PATH` defaults to `/studio/ai-research`

## MCP host config example

```json
{
  "mcpServers": {
    "research-publish-dev": {
      "command": "npx",
      "args": ["-y", "research-publish", "-dev"],
      "env": {
        "CONVEX_SITE_URL": "https://your-dev-deployment.convex.site",
        "CONVEX_WRITE_KEY": "your-dev-write-key"
      }
    },
    "research-publish-prod": {
      "command": "npx",
      "args": ["-y", "research-publish", "-prod"],
      "env": {
        "CONVEX_SITE_URL": "https://your-prod-deployment.convex.site",
        "CONVEX_WRITE_KEY": "your-prod-write-key"
      }
    }
  }
}
```

## Development

```bash
npm install
npm run build
npm test
```