We are excited to announce that LadderHub now supports the Model Context Protocol (MCP) — an open standard that lets AI assistants interact with external tools and services. This means you can now create brag items directly from your IDE, terminal, or any MCP-compatible client without ever leaving your workflow.
What is MCP?
The Model Context Protocol is an open standard created by Anthropic that provides a universal way for AI models to connect with external data sources and tools. Think of it as a USB-C port for AI — a single, standardized interface that lets any compatible AI assistant plug into any compatible service.
With MCP support, AI assistants like Claude can read from and write to LadderHub on your behalf, turning natural language into structured career data.
What You Can Do
With LadderHub's MCP integration, you can ask your AI assistant to log achievements as they happen. No context switching, no opening a separate tab, no forgetting to document your wins at the end of the week.
- ✓ Create brag items using natural language from your IDE or terminal
- ✓ Follow the Impact + How format automatically — the AI structures your input correctly
- ✓ Link to skills by providing skill level IDs for precise career tracking
- ✓ Set custom dates to log past achievements you forgot to record
Setup Guide
Step 1: Generate an API Token
Log in to LadderHub and navigate to Settings > API Token. Click Generate Token to create a new personal access token. Copy it immediately — it will only be shown once.
Step 2: Configure Your MCP Client
LadderHub provides a remote MCP server — no local installation required. Just point your MCP client to the URL with your API token. Below are examples for the most common setups.
Recommended — Remote Server
The remote server runs on LadderHub's infrastructure. Nothing to install, works from any machine, and always up to date.
Claude Code
Run the following command in your terminal to add the LadderHub remote MCP server:
claude mcp add ladderhub \
--transport http \
https://app.ladder-hub.com/api/mcp?token=lh_your_token_here
Alternatively, create or edit a
.mcp.json
file in your project root:
{
"mcpServers": {
"ladderhub": {
"type": "http",
"url": "https://app.ladder-hub.com/api/mcp?token=lh_your_token_here"
}
}
}
Claude Desktop
In Claude Desktop, click your profile icon, then go to Settings → Customize → Connectors. Click the + button and select Add Custom Connector. In the popup, enter a name (e.g. "LadderHub") and paste the URL:
https://app.ladder-hub.com/api/mcp?token=lh_your_token_here
Other MCP Clients
Any MCP client that supports the Streamable HTTP transport can connect to LadderHub. Use the following endpoint:
https://app.ladder-hub.com/api/mcp
Authenticate via an
Authorization: Bearer lh_your_token_here
header, or pass the token as a
?token=lh_your_token_here
query parameter for clients that don't support custom headers.
Replace
lh_your_token_here
with the token you generated in Step 1.
Usage Examples
Once configured, just talk to your AI assistant naturally. Here are some examples of what you can say:
You say:
"Log a brag item: Led the migration from monolith to microservices, reducing deploy time by 40%."
Claude does:
Calls
create_brag_item
with the title "Led monolith-to-microservices migration" and
description "Reduced deploy time by 40% by re-architecting the
monolithic application into independently deployable
microservices."
You say:
"Create a brag item for last Friday: Mentored 3 junior developers through their first production deploy."
Claude does:
Calls
create_brag_item
with an appropriate title, description in Impact + How format,
and
entryDate
set to the previous Friday's date.
You say:
"I just finished the API rate-limiting feature. Log it as a brag item and link it to skill level 12."
Claude does:
Calls
create_brag_item
with the title, an Impact + How description, today's date, and
skillLevelIds: [12]
to link it to the relevant skill.
Available Tools
The LadderHub MCP server currently exposes the following tool:
| Tool | Description |
|---|---|
create_brag_item
|
Create a new brag item with title, description, entry date, and optional skill level links. |
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
title
|
string | Yes | Short headline for the achievement (max 150 characters) |
description
|
string | Yes | Narrative using Impact + How format (max 2000 characters) |
entryDate
|
string | No | Date in YYYY-MM-DD format. Defaults to today if omitted. |
skillLevelIds
|
number[] | No | Array of skill level IDs to link the brag item to specific skills. |
Ready to Let AI Track Your Wins?
Sign up for LadderHub, generate your API token, and start logging achievements from your AI assistant in minutes.