Skip to main content
API Preview
Developers

MCP Resources

Resources are read-only data endpoints that expose structured information about the authenticated individual. Unlike tools, resources do not perform actions or side effects - they return the current state of a data object. For transport and connection setup, see the MCP overview.

Tools vs Resources

ToolsResources
PurposePerform actions, compute results, create dataRead current state of a data object
Side effectsYes (may create stubs, trigger assessments, etc.)None (read-only)
ParametersAccepts input argumentsURI-based, no input arguments
Invocationtools/callresources/read
AuthCapability token or anonymousRequires authenticated session

Reading a Resource

Use the resources/read JSON-RPC method with the resource URI. The server returns the resource contents scoped to the authenticated individual.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "member://profile"
  }
}

Discovering Resources

Call resources/list to discover all available resources and their URI patterns.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/list",
  "params": {}
}

Available Resources

3 resources are available, all scoped to the authenticated individual.

member://profileIndividual Profileapplication/json

Requires authenticated session (capability token or JWT)

The authenticated individual's profile data including assessment phase, archetype, and engagement level.

Example Response

json
{
  "uri": "member://profile",
  "mimeType": "application/json",
  "text": "{\n  \"member_id\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n  \"assessment_phase\": \"completed\",\n  \"account_status\": \"active\",\n  \"created_at\": \"2026-02-15T09:30:00Z\",\n  \"archetype\": \"Pragmatist\",\n  \"engagement_level\": 3\n}"
}
member://traitsIndividual Traitsapplication/json

Requires authenticated session (capability token or JWT)

The authenticated individual's trait vector - tier-labelled traits across the 5 trait categories. Tier labels only; numeric scores are never returned to members.

Example Response

json
{
  "uri": "member://traits",
  "mimeType": "application/json",
  "text": "{\n  \"member_id\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n  \"trait_count\": 3,\n  \"traits\": [\n    {\n      \"trait_name\": \"pressure_response\",\n      \"tier\": \"Strong\",\n      \"category\": \"adaptive_capacity\",\n      \"computed_at\": \"2026-03-10T14:22:00Z\"\n    },\n    {\n      \"trait_name\": \"ambiguity_tolerance\",\n      \"tier\": \"Strong\",\n      \"category\": \"adaptive_capacity\",\n      \"computed_at\": \"2026-03-10T14:22:00Z\"\n    },\n    {\n      \"trait_name\": \"systems_thinking\",\n      \"tier\": \"Moderate\",\n      \"category\": \"cognitive_style\",\n      \"computed_at\": \"2026-03-10T14:22:00Z\"\n    }\n  ]\n}"
}
member://competenciesIndividual Competenciesapplication/json

Requires authenticated session (capability token or JWT)

The authenticated individual's competency portfolio - verified competencies, evidence log, and badges.

Example Response

json
{
  "uri": "member://competencies",
  "mimeType": "application/json",
  "text": "{\n  \"member_id\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n  \"competencies\": [\n    {\n      \"name\": \"Strategic Planning\",\n      \"level\": \"advanced\",\n      \"evidence_count\": 4,\n      \"verified\": true,\n      \"last_demonstrated\": \"2026-03-08T10:15:00Z\"\n    },\n    {\n      \"name\": \"Technical Architecture\",\n      \"level\": \"expert\",\n      \"evidence_count\": 7,\n      \"verified\": true,\n      \"last_demonstrated\": \"2026-03-10T09:00:00Z\"\n    }\n  ],\n  \"badges\": [\n    {\n      \"name\": \"Systems Thinker\",\n      \"awarded_at\": \"2026-03-01T12:00:00Z\",\n      \"category\": \"cognitive_style\"\n    }\n  ],\n  \"total_competencies\": 2,\n  \"total_badges\": 1\n}"
}