Served MCP Server

Version: 2026.1.3

MCP (Model Context Protocol) Server for AI assistants to interact with the Served platform via UnifiedHQ. Enables Claude, GPT, and other AI models to access workspaces, projects, tasks, customers, and more.

Links

Resource	URL
UnifiedHQ Platform	unifiedhq.ai
Forge DevOps	forge.unifiedhq.ai
API Documentation	unifiedhq.ai/docs/api
Served.SDK (NuGet)	nuget.org/packages/Served.SDK
MCP Protocol	modelcontextprotocol.io

Features

• 40+ MCP Tools - Full CRUD operations on Served entities
• AI Intelligence - Project health analysis, task decomposition, effort estimation
• DevOps Integration - Git repos, PRs, CI/CD pipelines
• SDK Tracing - OpenTelemetry observability via Served.SDK
• Analytics - View tool usage metrics at forge.unifiedhq.ai/analytics
• Fork & Extend - Open source - customize for your needs

---

Quick Start

1. Configure Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "served": {
      "command": "dotnet",
      "args": ["run", "--project", "/path/to/Served.MCP"],
      "env": {
        "SERVED_API_URL": "https://apis.unifiedhq.ai",
        "SERVED_TOKEN": "your-api-token",
        "SERVED_TENANT": "your-workspace-slug"
      }
    }
  }
}

2. Get Your API Token

1. Go to unifiedhq.ai/app/settings/api-keys
2. Create a new API key with desired scopes
3. Copy the token to your config

3. Start Using

In Claude, you can now:

• "Show me my projects"
• "Create a task for Project X"
• "Log 2 hours on the Website task"
• "What's the health of Project Y?"

---

Installation Options

Option 1: Clone & Run

# Clone the repo
git clone https://github.com/Served-AI/Served.MCP.git
cd served-mcp

# Run directly
dotnet run

# Or build and run
dotnet build -c Release
./bin/Release/net10.0/Served.MCP

Option 2: Docker

docker run -e SERVED_TOKEN=xxx -e SERVED_TENANT=yyy ghcr.io/unifiedhq/served-mcp:latest

Option 3: From Source (ServedApp)

If you have the full ServedApp repository:

cd ServedApp/Served.MCP
dotnet run

---

Configuration

Environment Variables

Variable	Description	Default
SERVED_API_URL	API base URL	https://apis.unifiedhq.ai
SERVED_TOKEN	Your API token	-
SERVED_TENANT	Workspace slug	-
SERVED_MCP_TRACING	Enable tracing	false
FORGE_API_KEY	Forge platform API key	-

Enable Tracing

export SERVED_MCP_TRACING=true
export FORGE_API_KEY="your-forge-api-key"

View your traces at forge.unifiedhq.ai/analytics

---

MCP Tools Overview

Context Tools

Tool	Description
GetUserContext	Get user profile and workspaces. Call this first.
GetTenantContext	Get detailed tenant info (settings, categories).
GetProjectContext	Get project with tasks, team and recent activity.

Project Management

Tool	Description
GetProjects	List all projects for workspace
GetProjectDetails	Get detailed project information
CreateProject	Create new project
UpdateProject	Update existing project
DeleteProject	Delete project

Task Management

Tool	Description
GetTasks	Get tasks for project
GetTaskDetails	Get detailed task information
CreateTask	Create new task
UpdateTask	Update task
DeleteTask	Delete task
CreateTasksBulk	Bulk create tasks

Time Tracking

Tool	Description
SuggestTimeEntries	AI suggestions for time registration
AnalyzeTimePatterns	Analyze user's time patterns

AI Intelligence

Tool	Description
AnalyzeProjectHealth	Health check with score, risks, recommendations
SuggestTaskDecomposition	Suggestions for task breakdown
EstimateEffort	AI estimate based on history
FindSimilarProjects	Find similar projects

DevOps

Tool	Description
GetDevOpsRepositories	List connected Git repos
GetPullRequests	Get PRs for workspace or repository
GetPipelineRuns	Get pipeline runs
GetJobLog	Get log output from a job

See tools/mcp/ for full documentation of all 40+ tools.

---

Fork & Extend

This MCP server is open source. Fork it to:

1. Add Custom Tools: Extend with your own MCP tools
2. Custom Integrations: Connect to additional services
3. Run Your Own Instance: Host on your infrastructure

# Fork on GitHub, then:
git clone https://github.com/YOUR_USERNAME/served-mcp.git
cd served-mcp

# Add your custom tools in tools/
# Build and test
dotnet build
dotnet test

# Run your customized version
dotnet run

---

Observability

What Gets Traced

Every tool call captures:

Attribute	Description
mcp.tool.name	Tool name (e.g., GetTasks)
mcp.tool.success	Whether the call succeeded
mcp.session.id	Session identifier
mcp.agent.id	Agent identifier
Duration	Execution time in ms

View Analytics

• Forge Dashboard: forge.unifiedhq.ai/analytics
• Your Workspace: unifiedhq.ai/app/analytics

---

API Environments

Environment	URL
Production	https://apis.unifiedhq.ai
MCP Server	https://app.served.dk/mcp
Local Dev	http://localhost:5010

Authentication

MCP Tools: OAuth with scopes: projects, tasks, customers, calendar, timetracking, employees, intelligence, customfields, devops

REST API:

Authorization: Bearer <JWT_TOKEN>

---

Changelog

v2026.1.3 (2026-01-29)

• UnifiedHQ Integration - All endpoints now use apis.unifiedhq.ai
• Forge Analytics - Built-in tracing with dashboard support
• Fork Support - GitHub Actions workflow for forks
• Documentation - Complete overhaul with UnifiedHQ links

v2026.1.2 (2026-01-17)

• Unified File Format - All documentation converted to .unified.md format
• SDK Tracing - Integrated with Served.SDK tracing infrastructure
• OpenTelemetry - Tool calls now emit spans and metrics
• DevOps Enhancement - Extended DevOps tools

v2026.1.1

• Initial MCP server implementation
• 40+ tools for Served platform access

---

Support

• Documentation: unifiedhq.ai/docs
• Issues: GitHub Issues
• Discord: UnifiedHQ Community

License

MIT License - see LICENSE for details.

---

Built with love by UnifiedHQ