Skip to main content
GET
Get a skill

Authorizations

Authorization
string
header
required

MCPJam API key (sk_…). Create one at Settings → API keys. Guest sessions cannot use the API, and API keys cannot manage other API keys.

Path Parameters

projectId
string
required

ID of the hosted project that contains the server.

skillId
string
required

Skill ID.

Response

The skill.

id
string
required
projectId
string
required
name
string
required

Load-bearing identity: the on-box directory name and the loadSkill argument. Immutable — renames are rejected.

description
string
required
sharing
enum<string>
required

project skills are shared with the organization and are the only ones an environment may pin. user skills are the caller's own drafts.

Available options:
user,
project
isOwner
boolean
required
aggregateHash
string
required

Drift key over the body and any supporting files. A skill body is mutable and an edit overwrites it in place, so this is the only handle on WHICH content a given pin resolved to.

createdAt
number
required
updatedAt
number
required
content
string
required

The SKILL.md body, with frontmatter stripped.

provenance
string

How the row came to exist (authored, computer-adopted, …). Absent on older records; treat an unknown value as authored.

pinnability
object

Whether this skill may be pinned into an environment. ABSENT means unknown (an older backend), which is not the same as eligible.