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.
Cloud-Hosted MCP Server
The 1up MCP server is hosted at mcp.1up.ai — no local installation required. Your MCP client connects over HTTPS using Streamable HTTP transport, and authentication is handled via OAuth (you'll be prompted to log in through your browser on first use).
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.
Claude Code
Add to your .claude.json or ~/.claude.json:
{ "mcpServers": { "1up": { "type": "http", "url": "https://mcp.1up.ai/mcp", "clientId": "TAWQL8mbs0eHLzaBaxV3Va5vH6qal4Wq" } } }
Claude Desktop
Add to claude_desktop_config.json:
{ "mcpServers": { "1up": { "type": "http", "url": "https://mcp.1up.ai/mcp" } } }
Cursor / Windsurf
Add to your MCP configuration:
{ "mcpServers": { "1up": { "type": "http", "url": "https://mcp.1up.ai/mcp" } } }
Migrating from Local (PyPI) Install
If you previously installed 1up-mcp locally via pip, pipx, or uvx, follow these steps to switch to the cloud-hosted server.
1. Update your MCP client configuration
Replace your existing 1up MCP server entry with the hosted version. Your old config looks like one of these:
// Old — local stdio server (remove this) { "command": "1up-mcp" } { "command": "uvx", "args": ["1up-mcp"] }Replace it with:
// New — cloud-hosted server { "type": "http", "url": "https://mcp.1up.ai/mcp" }See the configuration examples above for the full JSON structure for your specific client.
2. Uninstall the local package
# If installed with pip pip uninstall 1up-mcp # If installed with pipx pipx uninstall 1up-mcp
3. Clean up local credentials (optional)
The hosted server handles authentication via OAuth in your browser — cached local credentials are no longer needed.
rm -rf ~/.1up
Environment Variables
These are optional — credentials from 1up-mcp auth login are used by default.
Variable | Description |
| Bearer token (overrides cached credentials) |
| API base URL |
| Workspace ID to use |
Available Tools
Q&A Library (6 tools)
Q&A Library (6 tools)
Tool | Description |
| Query the knowledge base with optional filters |
| Search Q&A pairs with pagination |
| Get a specific Q&A pair by ID |
| Create a new Q&A pair |
| Update an existing Q&A pair |
| Archive a Q&A pair |
Questionnaires (11 tools)
Questionnaires (11 tools)
Tool | Description |
| Upload XLSX/DOCX/PDF/CSV questionnaire files |
| List questionnaires with status/search filters |
| Get full questionnaire details |
| Get questions with answers |
| Edit a specific answer |
| Mark an answer as approved |
| Approve multiple questions at once |
| Regenerate AI answer for a question |
| Assign a question to a team member |
| Add a comment to a question |
| Export as XLSX/DOCX/CSV |
Knowledge Base (4 tools)
Knowledge Base (4 tools)
Tool | Description |
| List items with search/source filters |
| Get KB item details |
| Upload PDF/DOCX/XLSX/CSV documents |
| Delete a KB item |
Knowledge Groups (5 tools)
Knowledge Groups (5 tools)
Tool | Description |
| List all groups |
| Get group with its documents and Q&A pairs |
| Create a new group |
| Add documents/Q&A pairs to a group |
| Remove items from a group |
| Delete a group (items are ungrouped, not deleted) |
Workspace (4 tools)
Workspace (4 tools)
Tool | Description |
| List accessible workspaces |
| Get workspace details, plan, limits, usage |
| Switch active workspace |
| Get audit events with pagination |