1up-mcp 0.1.0

MCP server for the 1up knowledge management platform — connect AI assistants to your 1up workspace

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.

Variable	Description
ONEUP_AUTH_TOKEN	Bearer token (overrides cached credentials)
ONEUP_API_URL	API base URL
ONEUP_WORKSPACE_ID	Workspace ID to use

Available Tools

Q&A Library (6 tools)

Tool	Description
ask_question	Query the knowledge base with optional filters
search_qa_library	Search Q&A pairs with pagination
get_qa_pair	Get a specific Q&A pair by ID
create_qa_pair	Create a new Q&A pair
update_qa_pair	Update an existing Q&A pair
delete_qa_pair	Archive a Q&A pair

Questionnaires (11 tools)

Tool	Description
upload_questionnaire	Upload XLSX/DOCX/PDF/CSV questionnaire files
list_questionnaires	List questionnaires with status/search filters
get_questionnaire	Get full questionnaire details
get_questionnaire_questions	Get questions with answers
update_questionnaire_answer	Edit a specific answer
approve_question	Mark an answer as approved
bulk_approve_questions	Approve multiple questions at once
regenerate_answer	Regenerate AI answer for a question
assign_question	Assign a question to a team member
add_question_comment	Add a comment to a question
request_questionnaire_export	Export as XLSX/DOCX/CSV

Knowledge Base (4 tools)

Tool	Description
list_kb_items	List items with search/source filters
get_kb_item	Get KB item details
upload_kb_document	Upload PDF/DOCX/XLSX/CSV documents
delete_kb_item	Delete a KB item

Knowledge Groups (5 tools)

Tool	Description
list_knowledge_groups	List all groups
get_knowledge_group	Get group with its documents and Q&A pairs
create_knowledge_group	Create a new group
add_items_to_knowledge_group	Add documents/Q&A pairs to a group
remove_items_from_knowledge_group	Remove items from a group
delete_knowledge_group	Delete a group (items are ungrouped, not deleted)

Workspace (4 tools)

Tool	Description
list_workspaces	List accessible workspaces
get_workspace_info	Get workspace details, plan, limits, usage
switch_workspace	Switch active workspace
get_audit_events	Get audit events with pagination

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.