# Credly MCP

> Credly connects your AI agent directly to the world’s largest digital credential network. It lets you manage badge issuance, audit certifications, and track verified skills for any organization. Your agent can list all templates available, check who received specific badges, or map skills back to an employee's profile.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Tags:** digital-credentials, badges, skill-tracking, certification, verification

## Description

Managing credentials used to be a headache of logins, spreadsheets, and manual auditing. Now, your AI client talks directly to Credly. You tell it what you need—like listing every badge issued last quarter, or checking if a specific skill is tied to a particular template—and it finds the data for you. It's about shifting from clicking through multiple dashboards to asking natural questions and getting verifiable answers instantly. When your agent interacts with this MCP via Vinkius, it handles all the complex API calls behind the scenes. You simply ask: 'Show me all certifications John Doe has.' And you get a precise, actionable list, no matter how deep in the credentialing data it is.

## Tools

### get_badge_details
Retrieves the full details for one specific badge that has been issued.

### get_organization_info
Pulls general metadata about a single organization linked to your account.

### get_template_details
Gets the full design and criteria required for using a specific badge template.

### list_issued_badges
Pulls a list of all badges that have been issued by your company.

### list_authorized_issuers
Shows you a list of people who have been given permission to issue badges in your system.

### list_org_members
Lists all current members belonging to an organization within the Credly platform.

### list_connected_organizations
Lists every organization that has been linked or connected to your main Credly account.

### list_badge_recipients
Retrieves a list of every person who has received any badge from the platform.

### list_badge_skills
Lists every skill that is mapped or linked to badges within your credentialing system.

### list_badge_templates
Shows all the badge designs and templates available for issuing credentials.

## Prompt Examples

**Prompt:** 
```
List all badges issued by my organization in the last month.
```

**Response:** 
```
I've found 25 badges issued in the last 30 days. Most are for the 'Cloud Architecture' and 'Agile Leadership' templates. Would you like to see the names of the recipients?
```

**Prompt:** 
```
Show me the details for badge ID 'b8s9df7'.
```

**Response:** 
```
Badge 'b8s9df7' was issued to John Doe for completing 'Python for Data Science'. It is currently 'Accepted'. The associated skills include 'Data Analysis' and 'Python'. Should I list the criteria for this badge?
```

**Prompt:** 
```
What skills are associated with the 'Senior DevOps Engineer' badge template?
```

**Response:** 
```
The 'Senior DevOps Engineer' template is mapped to several skills: 'CI/CD Pipelines', 'Kubernetes Orchestration', 'Infrastructure as Code', and 'Cloud Security'. Would you like to see which employees have already earned this badge?
```

## Capabilities

### Audit specific badge records
You can pull detailed information on any single issued badge using its unique ID.

### Track skill mappings
The MCP lists all skills that Credly recognizes and maps to digital credentials in your system.

### View organizational structure
You can retrieve metadata for specific organizations connected to the network, or list all affiliated organizations.

### Monitor issuance history
The agent can pull lists of people who have earned badges or view all templates your organization offers.

### Verify issuer permissions
You can check which specific users are authorized to issue credentials within the system.

## Use Cases

### Onboarding new trainers
The L&D Manager needs to prove that all new hires have completed the required security training. They ask the agent to use `list_badge_recipients` and filter by 'Security Compliance' to get a list of everyone who has earned it, ensuring nobody slips through the cracks.

### Auditing organizational scope
A consultant needs to know which partner organizations are linked to your company. They prompt the agent to run `list_connected_organizations` first, then use `list_org_members` on each result to get a full roster of affiliated contacts.

### Investigating badge discrepancies
The compliance officer notices an incorrect status. They ask the agent to check the specific details using `get_badge_details`, which tells them if the credential is 'Accepted' or needs manual review, allowing for immediate action.

### Mapping skills to job roles
A hiring manager wants to know what skills are required for a new role. They ask the agent to run `list_badge_skills` to see the full inventory of transferable knowledge linked across all existing badge templates.

## Benefits

- Stop searching multiple dashboards. You can use `list_issued_badges` to pull all credential records for your organization instantly, giving you a single view of issuance history.
- Verify skill gaps immediately. Instead of guessing what a badge means, you ask the agent to run `list_badge_skills` to see every recognized skill mapped in the system.
- Manage templates without logging into Credly's UI. Use `list_badge_templates` to get a quick inventory and check design criteria for new programs.
- Know who can issue badges. If you need to audit authority, simply run `list_authorized_issuers` to see the full roster of people allowed to grant credentials.
- Pinpoint credential issues fast. Running `get_badge_details` allows your agent to pull specific data points about a single badge, like its current status and associated skills.

## How It Works

The bottom line is that you talk naturally to your agent, and it uses these tools to pull complex credential data from Credly for you.

1. Connect your AI client and authorize the MCP using your Credly API key.
2. Prompt your agent with a request, like 'List all badges issued by my company in 2024.'
3. The MCP executes multiple calls to gather the required data points (e.g., listing badges, then retrieving recipient names) and presents one cohesive answer.

## Frequently Asked Questions

**How do I list all badges issued by my company using the Credly MCP?**
You run `list_issued_badges`. This tool pulls a complete record of every badge your organization has dispensed, letting you see who got what and when.

**What is the difference between listing badges and getting badge details? (get_badge_details vs list_issued_badges)**
Listing badges (`list_issued_badges`) gives you a bulk overview of all issued credentials. `get_badge_details` requires a specific badge ID and returns deep, detailed information on just that one item.

**Can I find out which skills are tied to my organization? (list_badge_skills)**
Yes, you use `list_badge_skills`. This tool provides a full inventory of all recognized competencies mapped across the entire Credly system for your account.

**Does list_authorized_issuers tell me if someone is active?**
It lists who has permission to issue badges. If you need current activity status, you'll need to check other data points like `list_badge_recipients` or the badge details themselves.

**What information does `get_organization_info` retrieve about a company?**
It retrieves core metadata for a connected entity. You can use it to check the official name, ID, and other structural details of an organization within Credly. This is useful for verifying which account you're working with.

**How do I use `get_template_details` to review badge criteria?**
This function pulls the full design and specific rules for any given badge template ID. It lets your AI client see exactly what is required—both visually and technically—to earn that credential.

**If I need a complete roster, should I use `list_org_members` or list badges?**
You must use `list_org_members`. While listing issued badges shows *what* people earned, this function provides a comprehensive directory of every individual belonging to the organization account.

**How do I verify which organizations are linked using `list_connected_organizations`?**
`list_connected_organizations` pulls a list of all distinct organizational accounts connected via your API key. This is helpful when your business operates across multiple separate Credly entities.

**How do I get a Credly API Key?**
Log in to your Credly account and navigate to the organization settings to generate or retrieve your API Key. Ensure you have administrative privileges.

**Can the agent issue badges to new recipients?**
This integration currently provides tools for listing and auditing badges and templates. Issuing new badges should be handled through the Credly dashboard or specific automated workflows.

**What badge details can I retrieve?**
You can retrieve full badge profiles including recipient details, template criteria, associated skills, and current status (e.g., pending, accepted).