portfolio-mcp-server
Enables AI-powered code assistants to interact with a universal-portfolio instance, providing tools for CRUD operations on portfolio data.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@portfolio-mcp-server list my projects"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Related
universal-portfolio — the full-stack portfolio app this server connects to: github.com/muhammad-awais-web-dev/universal-portfolio
Setup
1. Install dependencies
npm install2. Configure environment
cp .env.example .envEdit .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_here3. Test manually
npm startFor development with auto-reload:
npm run devThe 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 |
| Profile info, bio, social links |
| Published projects (filter by category/skill, paginated) |
| Single project by ID or slug |
| All skills (filter by category, paginated) |
| Single skill by ID or name |
| All certifications |
| Single certification by ID |
| Education history |
| Single education entry by ID |
| Work experience |
| Single experience entry by ID |
| Testimonials (filter featured) |
| Single testimonial by ID |
Write tools — API key with can_write = true
Tool | Description |
| Update name, bio, email, social links, etc. |
| Create a new project |
| Update project by ID (including |
| Delete project by ID |
| Create a new skill |
| Update skill by ID |
| Delete skill by ID |
| Create a new certification |
| Update certification by ID |
| Delete certification by ID |
| Create an education entry |
| Update education by ID |
| Delete education by ID |
| Create a work experience entry |
| Update experience by ID |
| Delete experience by ID |
| Create a testimonial |
| Update testimonial by ID |
| 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 toolscreate_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
Scored across 32 tools
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.
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.
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.
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
Related MCP Connectors
Public portfolio MCP for resume, services, availability, project evidence, and introductions.
Build, version and render resumes as PDFs from Claude or any MCP client.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Remote MCP server for supportsheep: run AI interviews and manage support content for your blog.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceExposes core recruiting tools such as candidate ranking, profile retrieval, honeypot audits, and job description parsing via stdio protocol.MIT
- AlicenseAqualityCmaintenanceExposes a personal portfolio of projects, skills, and resume as callable tools for MCP-compatible AI assistants like Claude Desktop.4MIT
- AlicenseAqualityDmaintenanceEnables MCP-compatible AI clients to retrieve a professional profile as callable tools, including projects, work experience, skills, and live GitHub activity.5MIT
- AlicenseNot gradedqualityCmaintenanceProvides read-only access to NALLAR engineering evidence and portfolio artifacts over MCP, exposing tools, resources, and prompts via stdio JSON-RPC.MIT