MCP Server

SciTeX Hub ships with an MCP (Model Context Protocol) server that lets AI agents — Claude, Cursor, and others — interact with the platform autonomously. AI agents can search literature, manage citations, query project files, and submit jobs without manual intervention.

Available Tools

Category	Count	Description
`cloud`	14	Git operations: clone, push, pull, create pull requests, create and list issues
`api`	9	Scholar search, CrossRef lookup, BibTeX enrichment, citation management

Run scitex-hub mcp list-tools for the full list of tools with descriptions.

Setup for Claude Desktop

Add the following to your Claude Desktop configuration (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "scitex-hub": {
      "command": "scitex-hub",
      "args": ["mcp", "start"]
    }
  }
}

Setup for Claude Code

Add the following to your project .mcp.json (or the global ~/.claude/.mcp.json):

{
  "mcpServers": {
    "scitex-hub": {
      "command": "scitex-hub",
      "args": ["mcp", "start"]
    }
  }
}

Environment Source File (`ENV_SRC`)

To pass credentials and configuration to the MCP server without hardcoding values in the JSON config, use the SCITEX_HUB_ENV_SRC environment variable. Set it to the path of a shell .src file that exports the required variables:

# ~/.scitex_hub.src
export SCITEX_HUB_API_BASE_URL=https://scitex.example.com
export SCITEX_HUB_API_TOKEN=your-token-here

Then reference it in your MCP config:

{
  "mcpServers": {
    "scitex-hub": {
      "command": "scitex-hub",
      "args": ["mcp", "start"],
      "env": {
        "SCITEX_HUB_ENV_SRC": "/home/user/.scitex_hub.src"
      }
    }
  }
}

The server will source the .src file at startup and make all exported variables available to the MCP tools.

CLI Commands

scitex-hub mcp start             # Start the MCP server (stdio transport)
scitex-hub mcp doctor            # Diagnose setup and connectivity
scitex-hub mcp installation      # Print client configuration instructions
scitex-hub mcp list-tools        # List all available tools with descriptions