journeyman
Read-only Pattern-Assist corpus for aspiring software engineers: grounded dev patterns with sources.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"journeyman": {
"url": "https://journeyman.softwareengineeringprofessional.com/api/mcp"
}
}
}Remote endpoints
https://journeyman.softwareengineeringprofessional.com/api/mcpstreamable-httpWhat it can do
Tool inventory
Tools (5)
🟢search_patterns(query, limit, provenance, area)
Search the vendored Pattern-Assist corpus (hybrid lexical + embeddings when available; lexical fallback). Returns ranked patterns with source_ref citations and optional when_not guidance. Use this before asserting an approach.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Natural-language or keyword query."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"description": "Max hits (default 10)."
},
"provenance": {
"type": "string",
"enum": [
"our-dev",
"book",
"patent"
],
"description": "Optional provenance filter."
},
"area": {
"type": "string",
"description": "Optional area substring filter."
}
},
"required": [
"query"
]
}Output Schema
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"query": {
"type": "string"
},
"count": {
"type": "integer"
},
"patterns": {
"type": "array"
},
"_citation": {
"type": "object"
}
},
"required": [
"contract",
"query",
"count",
"patterns"
]
}🟢recommend_patterns(query, limit)
C-03: ranked Pattern-Assist recommendations for a task. Each hit carries a corpus why, a when-not / FTO trade-off, and cited same-area cross-links. Use this when the learner wants alternatives, not just a lexical hit list.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Task or problem to recommend against."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"description": "Max recommendations (default 5)."
}
},
"required": [
"query"
]
}Output Schema
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"query": {
"type": "string"
},
"count": {
"type": "integer"
},
"recommendations": {
"type": "array"
},
"_citation": {
"type": "object"
}
},
"required": [
"contract",
"query",
"count",
"recommendations"
]
}🟢get_pattern(id)
Lookup a single Pattern-Assist row by stable id. Returns 404-shaped payload when unknown — never fabricates a nearest match.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Pattern id, e.g. devplane-P02."
}
},
"required": [
"id"
]
}Output Schema
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"pattern": {
"type": "object"
},
"error": {
"type": "string"
},
"code": {
"type": "string"
}
}
}🟢list_patterns(limit, offset, provenance, area)
Paginated inventory of pattern ids and summaries from the vendored corpus.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"type": "integer",
"minimum": 0
},
"provenance": {
"type": "string",
"enum": [
"our-dev",
"book",
"patent"
]
},
"area": {
"type": "string"
}
}
}Output Schema
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"total": {
"type": "integer"
},
"patterns": {
"type": "array"
}
},
"required": [
"contract",
"total",
"patterns"
]
}🟢list_public_pages
Site map for agents: canonical human pages plus read-only REST/MCP endpoints on this host.
Input Schema
{
"type": "object",
"properties": {}
}Output Schema
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"site": {
"type": "object"
},
"pages": {
"type": "array"
},
"endpoints": {
"type": "array"
}
},
"required": [
"contract",
"pages",
"endpoints"
]
}Community
Evidence