Skip to main content
Glama

portfolio-mcp-server

An MCP (Model Context Protocol) server that connects AI tools — Claude Desktop, Cursor, GitHub Copilot — directly to your universal-portfolio instance.

What it does

Exposes all 32 portfolio tools over stdio so any MCP-compatible AI client can:

  • Read your profile, projects, skills, certifications, education, experience, and testimonials

  • Create, update, and delete any portfolio item (with a write-enabled API key)

Related MCP server: Portfolio MCP Server


Setup

1. Install dependencies

npm install

2. Configure environment

cp .env.example .env

Edit .env:

# URL of your running portfolio (local or deployed)
PORTFOLIO_URL=https://your-portfolio-domain.com

# API key from portfolio admin → Settings → API Keys
# Enable "can_write" on the key for write tool access
MCP_API_KEY=your_api_key_here

3. Test manually

npm start

For development with auto-reload:

npm run dev

The server communicates over stdio — it won't print anything until an MCP client connects. Startup messages appear on stderr.


Connect to Claude Desktop

Edit ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "portfolio": {
      "command": "npx",
      "args": ["tsx", "/path/to/portfolio-mcp-server/src/index.ts"],
      "env": {
        "PORTFOLIO_URL": "https://your-portfolio-domain.com",
        "MCP_API_KEY": "your_api_key_here"
      }
    }
  }
}

Restart Claude Desktop. You'll see portfolio listed under MCP tools.


Connect to Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "portfolio": {
      "command": "npx",
      "args": ["tsx", "/path/to/portfolio-mcp-server/src/index.ts"],
      "env": {
        "PORTFOLIO_URL": "https://your-portfolio-domain.com",
        "MCP_API_KEY": "your_api_key_here"
      }
    }
  }
}

Connect to VS Code

Requires VS Code 1.99+ with the GitHub Copilot extension.

Create or edit .vscode/mcp.json in your workspace (or add to your user settings.json under "mcp"):

{
  "servers": {
    "portfolio": {
      "type": "stdio",
      "command": "npx",
      "args": ["tsx", "/path/to/portfolio-mcp-server/src/index.ts"],
      "env": {
        "PORTFOLIO_URL": "https://your-portfolio-domain.com",
        "MCP_API_KEY": "your_api_key_here"
      }
    }
  }
}

Open the Copilot Chat panel, switch to Agent mode, and the portfolio server will appear under available tools.


Connect to GitHub Copilot CLI

Edit ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "portfolio": {
      "type": "stdio",
      "command": "npx",
      "args": ["tsx", "/path/to/portfolio-mcp-server/src/index.ts"],
      "env": {
        "PORTFOLIO_URL": "https://your-portfolio-domain.com",
        "MCP_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available Tools (32 total)

Read tools — any API key

Tool

Description

get_profile

Profile info, bio, social links

list_projects

Published projects (filter by category/skill, paginated)

get_project

Single project by ID or slug

list_skills

All skills (filter by category, paginated)

get_skill

Single skill by ID or name

list_certifications

All certifications

get_certification

Single certification by ID

list_education

Education history

get_education

Single education entry by ID

list_experience

Work experience

get_experience

Single experience entry by ID

list_testimonials

Testimonials (filter featured)

get_testimonial

Single testimonial by ID

Write tools — API key with can_write = true

Tool

Description

update_profile

Update name, bio, email, social links, etc.

create_project

Create a new project

update_project

Update project by ID (including body_html)

delete_project

Delete project by ID

create_skill

Create a new skill

update_skill

Update skill by ID

delete_skill

Delete skill by ID

create_certification

Create a new certification

update_certification

Update certification by ID

delete_certification

Delete certification by ID

create_education

Create an education entry

update_education

Update education by ID

delete_education

Delete education by ID

create_experience

Create a work experience entry

update_experience

Update experience by ID

delete_experience

Delete experience by ID

create_testimonial

Create a testimonial

update_testimonial

Update testimonial by ID

delete_testimonial

Delete testimonial by ID


Example prompts (once connected to Claude/Cursor/Copilot)

  • "List all my projects"

  • "What skills do I have in the Backend category?"

  • "Update my profile bio to: I'm a full-stack developer..."

  • "Create a new skill called Docker in the DevOps category"

  • "Update project 5 — set body_html to: <p>New description</p>"

  • "Publish project with slug 'my-app'"


Requirements

  • Node.js 18+

  • A running universal-portfolio instance

  • An MCP API key (generated in the portfolio admin panel)

Available Tools

32 tools
create_certificationC

Create a new certification. Requires write permission.

Inputs: title (required), authority, body_html, is_active, +5 more.

create_educationC

Create a new education entry. Requires write permission.

Inputs: institution (required), grade, degree, end_date, +7 more.

create_experienceB

Create a new work experience entry. Requires write permission.

Inputs: title (required), company (required), start_date (required), end_date, +6 more.

create_projectB

Create a new portfolio project. Requires write permission.

Inputs: slug (required), title (required), live_url, repo_url, +8 more.

create_skillB

Create a new skill. Requires write permission.

Inputs: name (required), logo_url, body_html, category_ids.

create_testimonialB

Create a new testimonial. Requires write permission.

Inputs: name (required), comment (required), position (required), company, +5 more.

delete_certificationA

Delete a certification by ID. Requires write permission.

Inputs: id (required).

delete_educationA

Delete an education entry by ID. Requires write permission.

Inputs: id (required).

delete_experienceB

Delete a work experience entry by ID. Requires write permission.

Inputs: id (required).

delete_projectA

Delete a project by ID. Requires write permission.

Inputs: id (required).

delete_skillA

Delete a skill by ID. Requires write permission.

Inputs: id (required).

delete_testimonialC

Delete a testimonial by ID. Requires write permission.

Inputs: id (required).

get_certificationA

Get a specific certification by ID

Inputs: id (required).

get_educationB

Get a specific education entry by ID

Inputs: id (required).

get_experienceA

Get a specific work experience entry by ID

Inputs: id (required).

get_profileA

Get the portfolio owner's profile: name, bio, contact details, social links

Inputs: no named parameters.

get_projectA

Get a specific project by ID or slug

Inputs: id, slug.

get_skillA

Get a specific skill by ID or name

Inputs: id, name.

get_testimonialA

Get a specific testimonial by ID

Inputs: id (required).

list_certificationsC

List all certifications

Inputs: page, limit.

list_educationC

List all education history

Inputs: page, limit.

list_experienceC

List all work experience

Inputs: page, limit.

list_projectsB

List published projects. Optionally filter by category or skill name.

Inputs: page, limit, skill, category.

list_skillsB

List all skills, optionally filtered by category

Inputs: page, limit, category.

list_testimonialsC

List all testimonials

Inputs: page, limit, featured.

update_certificationB

Update an existing certification by ID. Requires write permission.

Inputs: id (required), title, authority, body_html, +6 more.

update_educationC

Update an existing education entry by ID. Requires write permission.

Inputs: id (required), grade, degree, end_date, +8 more.

update_experienceA

Update an existing work experience entry by ID. Requires write permission.

Inputs: id (required), title, company, end_date, +7 more.

update_profileB

Update the portfolio owner profile. Requires write permission.

Inputs: bio, email, phone, github, +9 more.

update_projectA

Update an existing project by ID. Requires write permission.

Inputs: id (required), slug, title, live_url, +10 more.

update_skillB

Update an existing skill by ID. Requires write permission.

Inputs: id (required), name, logo_url, body_html, +1 more.

update_testimonialC

Update an existing testimonial by ID. Requires write permission.

Inputs: id (required), name, comment, company, +6 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 32 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action, with clear list/get/create/update/delete separation. There is no meaningful overlap or ambiguity between any of the 32 tools.

    Naming Consistency5/5

    Tool names follow a consistent verb_noun pattern throughout: list_ for collections, get_ for single items, and create_/update_/delete_ for mutations. This makes the API surface highly predictable.

    Tool Count2/5

    With 32 tools, the server is over-scoped for a portfolio use case, exceeding the threshold where tool selection becomes a cognitive burden. While the CRUD pattern is systematic, most real portfolio workflows would only need a small subset of read operations.

    Completeness5/5

    The tool set provides complete CRUD coverage for every portfolio content type, plus profile management. There are no obvious dead ends or missing lifecycle operations.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Exposes a personal portfolio of projects, skills, and resume as callable tools for MCP-compatible AI assistants like Claude Desktop.
      4
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables MCP-compatible AI clients to retrieve a professional profile as callable tools, including projects, work experience, skills, and live GitHub activity.
      5
      MIT