How do I use research-publish?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@research-publish publish my latest AI experiment notes to the research database" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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