1up MCP Server

MCP (Model Context Protocol) server for the 1up knowledge management platform. Enables AI coding assistants to interact with your 1up workspace — manage questionnaires, Q&A libraries, knowledge bases, and more — directly from the terminal.

Installation

# With pip
pip install 1up-mcp

# With pipx (isolated install, recommended for CLI tools)
pipx install 1up-mcp

# With uvx (zero-install, runs directly)
uvx 1up-mcp auth login

Requires Python 3.10+

Authentication

1up-mcp auth login       # Opens browser for SSO login
1up-mcp auth status      # Show current auth status
1up-mcp auth logout      # Remove cached credentials

Credentials are cached locally in ~/.1up/credentials.json and automatically refreshed.

Configuration

Claude Code

Add to your .claude.json or ~/.claude.json:

{
  "mcpServers": {
    "1up": {
      "command": "1up-mcp"
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "1up": {
      "command": "uvx",
      "args": ["1up-mcp"]
    }
  }
}

Cursor / Windsurf

Add to your MCP configuration:

{
  "mcpServers": {
    "1up": {
      "command": "1up-mcp"
    }
  }
}

Environment Variables

These are optional — credentials from 1up-mcp auth login are used by default.

Available Tools

Available Resources

16 read-only resources for workspace context, questionnaire data, Q&A library, knowledge base items (with source text tracing), and knowledge groups.

Development

# Clone and install in dev mode
git clone https://gitlab.com/1upai/mcp_server.git
cd mcp_server
python3.10 -m venv .venv
source .venv/bin/activate
pip install -e .

# Run directly
python -m oneup_mcp

License

Proprietary. Copyright (c) 2025-2026 1up.ai. All rights reserved. See LICENSE for details.