Back to search
100
MCP live MCP 2025-11-25 streamable-http

Agent Workspace Practice

io.github.jimy-r/agent-workspace-practice

Search + patterns, maturity assessment, context pricing, redaction checks - a practice as tools.

Watch this dependency Share evidence report
Uptime
100.0%
5 direct probes · 30d
Response
464ms
last probe
Tools
6
callable
Resources
108
readable
Prompts
0
available
Primary URL
https://jamesross.ai/mcp
Score: 100/100
Handshake verified by our own probe.
pass Answers the MCP handshake 50/50
The handshake and the list calls succeeded on the primary URL.
pass Lists tools, resources or prompts 30/30
6 tools, 108 resources, 0 prompts returned.
pass 3 or more catalogue items 10/10
114 items in total; 3 or more earns these points.
pass Describes itself 10/10
96 characters; more than 30 earns these points.

Tools · 6

search_architecture

Full-text search across the published architecture corpus: the 18 patterns and how they compose, the evaluation method, the seven learn-track modules, and the teardowns of other people's published age…

lookup_pattern

Search the 18 architecture patterns behind this practice by keyword or by pattern number. Returns up to 3 matches, each with its number, title, the problem it opens on, and a link to the full text. Us…

assess_workspace

Score an agent workspace across six dimensions: canonical knowledge, memory and context economics, verification and oversight, safety and permissions, telemetry and cost, provenance and delegation. Tw…

price_context_read

Price a block of context by where it enters a session. The API is stateless, so the whole transcript is re-sent on every inference step, and a token costs its size times the number of turns left after…

check_redaction

Scan text for the shapes of private content before it goes anywhere public: email addresses, absolute home paths, credential and token prefixes, private and link-local IPs, .local hostnames, and secre…

request_capability

Tell this server what capability you needed but didn't find here. Requests are logged and reviewed by a human; include no secrets or personal data.

Resources · 108

Patterns

PATTERNS.md

architecture://patterns--patterns
1. Pure roles, composed with project facts

PATTERNS.md

architecture://patterns--1-pure-roles-composed-with-project-facts
2. Classify-then-act, not ask-then-wait

PATTERNS.md

architecture://patterns--2-classify-then-act-not-ask-then-wait
3. Make silent failure loud (the dead-man's switch)

PATTERNS.md

architecture://patterns--3-make-silent-failure-loud-the-dead-man-s-switch
4. Tier by mechanical impact, not by tone

PATTERNS.md

architecture://patterns--4-tier-by-mechanical-impact-not-by-tone
5. Memory points, it doesn't mirror

PATTERNS.md

architecture://patterns--5-memory-points-it-doesn-t-mirror
6. Credentials live in one place, never in files

PATTERNS.md

architecture://patterns--6-credentials-live-in-one-place-never-in-files
7. A cheap hook beats a careful agent

PATTERNS.md

architecture://patterns--7-a-cheap-hook-beats-a-careful-agent
8. Audit the workspace like a fitness function

PATTERNS.md

architecture://patterns--8-audit-the-workspace-like-a-fitness-function
9. Context is a budget, not a constant

PATTERNS.md

architecture://patterns--9-context-is-a-budget-not-a-constant
10. A skill is editable weights — never adopt a self-edit without a gate

PATTERNS.md

architecture://patterns--10-a-skill-is-editable-weights-never-adopt-a-self-edit-without-a-gate
11. A scaffold is a hypothesis — gate it behind a measurable signal

PATTERNS.md

architecture://patterns--11-a-scaffold-is-a-hypothesis-gate-it-behind-a-measurable-signal
12. Loop selection: not everything should be a loop

PATTERNS.md

architecture://patterns--12-loop-selection-not-everything-should-be-a-loop
13. Challenge half-formed ideas with a different lens — and hold a sample back to prove it helps

PATTERNS.md

architecture://patterns--13-challenge-half-formed-ideas-with-a-different-lens-and-hold-a-sample-back-to-prove-it-helps
14. Delegation is a queue you fill, not work the agent finds

PATTERNS.md

architecture://patterns--14-delegation-is-a-queue-you-fill-not-work-the-agent-finds
15. Price the lane before you migrate it

PATTERNS.md

architecture://patterns--15-price-the-lane-before-you-migrate-it
16. A claim carries its provenance, or it is a guess

PATTERNS.md

architecture://patterns--16-a-claim-carries-its-provenance-or-it-is-a-guess
17. One canonical copy, and pointers from everywhere else

PATTERNS.md

architecture://patterns--17-one-canonical-copy-and-pointers-from-everywhere-else
18. Position is price — a token costs more the earlier you add it

PATTERNS.md

architecture://patterns--18-position-is-price-a-token-costs-more-the-earlier-you-add-it
How they compose

PATTERNS.md

architecture://patterns--how-they-compose
Evaluation: knowing whether a workspace change helped

EVALUATION.md

architecture://evaluation--evaluation-knowing-whether-a-workspace-change-helped
The instrument

EVALUATION.md

architecture://evaluation--the-instrument
1. Deterministic checks only, never a judge

EVALUATION.md

architecture://evaluation--1-deterministic-checks-only-never-a-judge
2. A pass-rate with variance, never a single number

EVALUATION.md

architecture://evaluation--2-a-pass-rate-with-variance-never-a-single-number
3. Five fixture classes, and two of them are the point

EVALUATION.md

architecture://evaluation--3-five-fixture-classes-and-two-of-them-are-the-point
What it costs

EVALUATION.md

architecture://evaluation--what-it-costs
How it connects to the rest

EVALUATION.md

architecture://evaluation--how-it-connects-to-the-rest
Where it lives

EVALUATION.md

architecture://evaluation--where-it-lives
M0. Foundations — the session loop

learn/00-foundations.md

architecture://learn-00-foundations--m0-foundations-the-session-loop
Do this

learn/00-foundations.md

architecture://learn-00-foundations--do-this
Measure it

learn/00-foundations.md

architecture://learn-00-foundations--measure-it
M1. Canonical knowledge — one source of truth

learn/01-canonical-knowledge.md

architecture://learn-01-canonical-knowledge--m1-canonical-knowledge-one-source-of-truth
The patterns

learn/01-canonical-knowledge.md

architecture://learn-01-canonical-knowledge--the-patterns
Do this

learn/01-canonical-knowledge.md

architecture://learn-01-canonical-knowledge--do-this
Measure it

learn/01-canonical-knowledge.md

architecture://learn-01-canonical-knowledge--measure-it
M2. Context economics — context is spend

learn/02-context-economics.md

architecture://learn-02-context-economics--m2-context-economics-context-is-spend
The patterns

learn/02-context-economics.md

architecture://learn-02-context-economics--the-patterns
Do this

learn/02-context-economics.md

architecture://learn-02-context-economics--do-this
Measure it

learn/02-context-economics.md

architecture://learn-02-context-economics--measure-it
M3. Verification & oversight — trust through checks

learn/03-verification-oversight.md

architecture://learn-03-verification-oversight--m3-verification-oversight-trust-through-checks
The patterns

learn/03-verification-oversight.md

architecture://learn-03-verification-oversight--the-patterns
Do this

learn/03-verification-oversight.md

architecture://learn-03-verification-oversight--do-this
Measure it

learn/03-verification-oversight.md

architecture://learn-03-verification-oversight--measure-it
M4. Safety & permissions — cheap mechanical guards

learn/04-safety-permissions.md

architecture://learn-04-safety-permissions--m4-safety-permissions-cheap-mechanical-guards
The patterns

learn/04-safety-permissions.md

architecture://learn-04-safety-permissions--the-patterns
Do this

learn/04-safety-permissions.md

architecture://learn-04-safety-permissions--do-this
Measure it

learn/04-safety-permissions.md

architecture://learn-04-safety-permissions--measure-it
M5. Telemetry & cost — loud failure, priced lanes

learn/05-telemetry-cost.md

architecture://learn-05-telemetry-cost--m5-telemetry-cost-loud-failure-priced-lanes
The patterns

learn/05-telemetry-cost.md

architecture://learn-05-telemetry-cost--the-patterns
Do this

learn/05-telemetry-cost.md

architecture://learn-05-telemetry-cost--do-this
Measure it

learn/05-telemetry-cost.md

architecture://learn-05-telemetry-cost--measure-it
M6. Provenance & delegation — sourced claims, mandated work

learn/06-provenance-delegation.md

architecture://learn-06-provenance-delegation--m6-provenance-delegation-sourced-claims-mandated-work
The patterns

learn/06-provenance-delegation.md

architecture://learn-06-provenance-delegation--the-patterns
Do this

learn/06-provenance-delegation.md

architecture://learn-06-provenance-delegation--do-this
Measure it

learn/06-provenance-delegation.md

architecture://learn-06-provenance-delegation--measure-it
Learn the architecture

learn/README.md

architecture://learn-readme--learn-the-architecture
Where to start

learn/README.md

architecture://learn-readme--where-to-start
The modules

learn/README.md

architecture://learn-readme--the-modules
How each module works

learn/README.md

architecture://learn-readme--how-each-module-works
Track your progress

learn/README.md

architecture://learn-readme--track-your-progress
Questions and corrections

learn/README.md

architecture://learn-readme--questions-and-corrections
Teardown: 12-Factor Agents

teardowns/2026-08-27-12-factor-agents.md

architecture://teardowns-2026-08-27-12-factor-agents--teardown-12-factor-agents
What it is

teardowns/2026-08-27-12-factor-agents.md

architecture://teardowns-2026-08-27-12-factor-agents--what-it-is
What works

teardowns/2026-08-27-12-factor-agents.md

architecture://teardowns-2026-08-27-12-factor-agents--what-works
The trade-offs

teardowns/2026-08-27-12-factor-agents.md

architecture://teardowns-2026-08-27-12-factor-agents--the-trade-offs
What's conspicuously absent

teardowns/2026-08-27-12-factor-agents.md

architecture://teardowns-2026-08-27-12-factor-agents--what-s-conspicuously-absent
What this teaches

teardowns/2026-08-27-12-factor-agents.md

architecture://teardowns-2026-08-27-12-factor-agents--what-this-teaches
Corrections

teardowns/2026-08-27-12-factor-agents.md

architecture://teardowns-2026-08-27-12-factor-agents--corrections
Teardown: herdr

teardowns/2026-08-28-herdr.md

architecture://teardowns-2026-08-28-herdr--teardown-herdr
What it is

teardowns/2026-08-28-herdr.md

architecture://teardowns-2026-08-28-herdr--what-it-is
What works

teardowns/2026-08-28-herdr.md

architecture://teardowns-2026-08-28-herdr--what-works
The trade-offs

teardowns/2026-08-28-herdr.md

architecture://teardowns-2026-08-28-herdr--the-trade-offs
What's conspicuously absent

teardowns/2026-08-28-herdr.md

architecture://teardowns-2026-08-28-herdr--what-s-conspicuously-absent
What this teaches

teardowns/2026-08-28-herdr.md

architecture://teardowns-2026-08-28-herdr--what-this-teaches
Corrections

teardowns/2026-08-28-herdr.md

architecture://teardowns-2026-08-28-herdr--corrections
Teardown: LifeOS

teardowns/2026-08-28-lifeos.md

architecture://teardowns-2026-08-28-lifeos--teardown-lifeos
What it is

teardowns/2026-08-28-lifeos.md

architecture://teardowns-2026-08-28-lifeos--what-it-is
What works

teardowns/2026-08-28-lifeos.md

architecture://teardowns-2026-08-28-lifeos--what-works
The trade-offs

teardowns/2026-08-28-lifeos.md

architecture://teardowns-2026-08-28-lifeos--the-trade-offs
What's conspicuously absent

teardowns/2026-08-28-lifeos.md

architecture://teardowns-2026-08-28-lifeos--what-s-conspicuously-absent
What this teaches

teardowns/2026-08-28-lifeos.md

architecture://teardowns-2026-08-28-lifeos--what-this-teaches
Teardown: DeepSeek Harness

teardowns/2026-09-05-deepseek-harness.md

architecture://teardowns-2026-09-05-deepseek-harness--teardown-deepseek-harness
What it is

teardowns/2026-09-05-deepseek-harness.md

architecture://teardowns-2026-09-05-deepseek-harness--what-it-is
What works

teardowns/2026-09-05-deepseek-harness.md

architecture://teardowns-2026-09-05-deepseek-harness--what-works
The trade-offs

teardowns/2026-09-05-deepseek-harness.md

architecture://teardowns-2026-09-05-deepseek-harness--the-trade-offs
What's conspicuously absent

teardowns/2026-09-05-deepseek-harness.md

architecture://teardowns-2026-09-05-deepseek-harness--what-s-conspicuously-absent
What this teaches

teardowns/2026-09-05-deepseek-harness.md

architecture://teardowns-2026-09-05-deepseek-harness--what-this-teaches
Teardown: GPT-RAG

teardowns/2026-09-06-azure-gpt-rag.md

architecture://teardowns-2026-09-06-azure-gpt-rag--teardown-gpt-rag
What it is

teardowns/2026-09-06-azure-gpt-rag.md

architecture://teardowns-2026-09-06-azure-gpt-rag--what-it-is
What works

teardowns/2026-09-06-azure-gpt-rag.md

architecture://teardowns-2026-09-06-azure-gpt-rag--what-works
The trade-offs

teardowns/2026-09-06-azure-gpt-rag.md

architecture://teardowns-2026-09-06-azure-gpt-rag--the-trade-offs
What's conspicuously absent

teardowns/2026-09-06-azure-gpt-rag.md

architecture://teardowns-2026-09-06-azure-gpt-rag--what-s-conspicuously-absent
What this teaches

teardowns/2026-09-06-azure-gpt-rag.md

architecture://teardowns-2026-09-06-azure-gpt-rag--what-this-teaches
Corrections

teardowns/2026-09-06-azure-gpt-rag.md

architecture://teardowns-2026-09-06-azure-gpt-rag--corrections
Teardown: OpenHarness

teardowns/2026-10-02-openharness.md

architecture://teardowns-2026-10-02-openharness--teardown-openharness
What it is

teardowns/2026-10-02-openharness.md

architecture://teardowns-2026-10-02-openharness--what-it-is
What works

teardowns/2026-10-02-openharness.md

architecture://teardowns-2026-10-02-openharness--what-works
The trade-offs

teardowns/2026-10-02-openharness.md

architecture://teardowns-2026-10-02-openharness--the-trade-offs
What's conspicuously absent

teardowns/2026-10-02-openharness.md

architecture://teardowns-2026-10-02-openharness--what-s-conspicuously-absent
What this teaches

teardowns/2026-10-02-openharness.md

architecture://teardowns-2026-10-02-openharness--what-this-teaches
Teardowns

teardowns/README.md

architecture://teardowns-readme--teardowns
Why teardowns

teardowns/README.md

architecture://teardowns-readme--why-teardowns
Ground rules

teardowns/README.md

architecture://teardowns-readme--ground-rules
Page conventions

teardowns/README.md

architecture://teardowns-readme--page-conventions
Distribution

teardowns/README.md

architecture://teardowns-readme--distribution
What six readings show

teardowns/README.md

architecture://teardowns-readme--what-six-readings-show
Published

teardowns/README.md

architecture://teardowns-readme--published
Disagree with a reading?

teardowns/README.md

architecture://teardowns-readme--disagree-with-a-reading

How to use

Claude Desktop or claude.ai: add a custom connector (Customize → Connectors; on Team and Enterprise plans an owner adds it under Organization settings → Connectors) with this server URL: https://jamesross.ai/mcp

Cursor or Cline: add to your MCP config:

{
  "mcpServers": {
    "agent_workspace_practice": {
      "url": "https://jamesross.ai/mcp",
      "transport": "streamable-http"
    }
  }
}