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:

{
  "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

{
  "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

npm install
npm run build
npm test