Skills

Get a skill

Changed on

One skill, including its SKILL.md body. The body is mutable and an edit overwrites the previous one in place, so aggregateHash is the only handle on which content this read returned.

get/projects/{projectId}/skills/{skillId}

Request

  • Base URL
    https://app.mcpjam.com/api/v1
  • URL
    https://app.mcpjam.com/api/v1/projects/{projectId}/skills/{skillId}
  • Auth
    HTTP bearer

Path parameters

projectIdstring required

ID of the hosted project that contains the server.

skillIdstring required

Skill ID.

Response

The skill.

idstring required
projectIdstring required
namestring required

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

descriptionstring required
sharing'user' | 'project' 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.

isOwnerboolean required
aggregateHashstring 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.

provenancestring

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

createdAtnumber required
updatedAtnumber required
contentstring required

The SKILL.md body, with frontmatter stripped.

Changes