TechOneDigital Scope a controlled connector

Based on the current stable MCP specification

Production implementation

A production MCP service is an operated business capability, not a successful tool demo.

The current MCP protocol is deliberately small and composable. That makes servers easier to build, but it leaves service ownership, idempotency, downstream failure, data freshness, change control and recovery with the implementation team. Production readiness begins when each capability has an explicit contract and an accountable owner.

Technical guide by , Founder & Technology Consultant.

TechOne architecture position

MCP standardises discovery and invocation. It does not standardise the business meaning of success. Production architecture must make that meaning testable across the host, transport, server and system of record.

Contract before SDK

A tool is a production interface, not a prompt convenience.

Its name, schema, permission, failure behaviour and evidence model become part of the runtime surface seen by hosts and models. Define that contract before choosing framework decorators.

Illustrative operation contract

Expose a business capability, not a raw API estate.

This record is deliberately implementation-neutral. It states what must be true for the capability to be safe to build and operate.

Stable capability identity
An immutable internal server ID, tool name and contract version, distinct from human-readable titles.
TechOne recommendation
Purpose and non-goals
The business outcome the capability supports, the decisions it must not make and the environments or records it must not reach.
TechOne recommendation
Input schema
A constrained JSON Schema with required fields, formats, ranges and additional-property behaviour. The server validates every call independently of the model.
Protocol fact and TechOne recommendation
Output schema
A structured result contract that distinguishes business data, evidence, warnings and machine-actionable error states.
Protocol-supported and TechOne recommendation
Authorisation contract
Required audience, scopes, principal types, tenant rules and object-level checks.
Protocol fact and TechOne recommendation
Approval contract
The consequence class, approval trigger, information shown to the approver and the exact request digest to which approval is bound.
TechOne recommendation
Side-effect and idempotency contract
Whether the operation reads, proposes, creates, updates or irreversibly acts; the command identifier and duplicate-call behaviour for mutations.
TechOne recommendation
Timeout and cancellation contract
Client deadline, server budget, downstream budget, cancellation propagation and the state reported when work may continue after disconnection.
Protocol-supported and TechOne recommendation
State contract
Any explicit handle, its owner, retention, expiry and recovery behaviour. MCP 2026-07-28 has no protocol-level session.
Protocol fact and TechOne recommendation
Freshness contract
Source timestamp, cache eligibility, ttlMs, cacheScope and invalidation path for discoverable or readable data.
Protocol fact and TechOne recommendation
Evidence contract
Trace, policy, approval, downstream and outcome records needed to explain a production action without logging secrets.
TechOne recommendation
Ownership and SLO
Named business and technical owners, availability and latency objectives, support path, error budget and retirement decision.
TechOne recommendation

Implementation sequence

Move from contract to evidence, then to operation.

  1. 01

    Design

    Is this a focused capability with a clear owner, consequence and trust boundary?

    Evidence: Contract draft, data-flow map, threat model and proposed SLO.TechOne recommendation
  2. 02

    Verify

    Does the implementation reject invalid identity, inputs, states and protocol metadata before it reaches the backend?

    Evidence: Contract, security, tenancy, failure and compatibility test results.TechOne recommendation
  3. 03

    Register

    Has the organisation recorded the publisher, endpoint, transport, version, schemas, owner and approved environments?

    Evidence: Private catalogue record and schema fingerprint.TechOne recommendation
  4. 04

    Publish

    Are only the approved tools visible to the intended principals and clients?

    Evidence: Policy decision, filtered tools/list response and release approval.Protocol-supported and TechOne recommendation
  5. 05

    Operate

    Can the team observe latency, errors, policy decisions, approvals, cost and downstream health by capability and tenant?

    Evidence: Dashboards, trace samples, audit records and alert tests.TechOne recommendation
  6. 06

    Change

    Does a schema, description, authorisation or side-effect change trigger compatibility testing and the right level of re-approval?

    Evidence: Semantic diff, version decision, migration test and updated catalogue record.TechOne recommendation
  7. 07

    Retire

    Can consumers move without silent breakage, orphaned credentials or retained state?

    Evidence: Usage inventory, deprecation notice, credential revocation and state-retention outcome.TechOne recommendation

Cache with an authorisation context

Freshness and permission are separate decisions.

The current protocol defines cache hints for discovery, list operations and resource reads. It does not make arbitrary tool execution safely cacheable.

SurfaceCache positionWhy
server/discoverCacheable with ttlMs and public or private cacheScope.The 2026-07-28 caching model explicitly includes discovery results. Capabilities may still differ by deployment or authorisation context.
tools/listCacheable. Use public only when the same catalogue is safe for every caller.The protocol requires cache hints and recommends deterministic tool ordering. Authorisation may change the visible tool set.
prompts/listCacheable with a scope matching the caller-specific catalogue.Prompt lists are included in the protocol cache model and may vary by authorisation.
resources/list and resources/templates/listCacheable per page with consistent cacheScope across one paginated list.Pages are independently fresh; there is no cross-page snapshot guarantee.
resources/readCacheable only with a TTL and scope appropriate to the resource and identity.A private resource result must not be reused across authorisation contexts. A notification can invalidate a still-fresh result.
tools/callNot cacheable through the MCP protocol cache contract.tools/call is absent from the defined cacheable operations. Any application-level memoisation needs explicit semantic, identity, freshness and side-effect rules.
input_required and MRTR retriesDo not cache.The specification excludes interim results and retries carrying inputResponses or requestState from caching.

Failure is part of the contract

A retry must not become a duplicate business action.

Transport recovery, business idempotency and downstream confirmation are separate mechanisms. Writes require an explicit command identity and a result that can be reconciled.

Protocol fact and TechOne recommendation

Use stateless transport without hiding business state.

At the protocol layer, MCP 2026-07-28 allows any request to reach any compatible instance. Persist required workflow state behind an explicit, opaque handle, keep that state reachable by the selected instance and bind the handle to the verified principal.

TechOne recommendation; optional draft Tasks extension where supported

Separate request completion from business completion.

A transport response may confirm acceptance while downstream work remains in progress. Return a durable job or task reference and an unambiguous terminal outcome for long-running operations.

TechOne recommendation

Do not retry consequential calls blindly.

Timeout does not prove that a write failed. Give mutations a stable command ID, deduplicate server-side and expose a status lookup before retrying.

Protocol-supported and TechOne recommendation

Budget time across the whole chain.

Define separate host, gateway, server and downstream deadlines. Propagate cancellation where possible and document any work that cannot be stopped safely.

TechOne recommendation

Bound concurrency before it reaches the system of record.

Apply per-principal, tenant, tool and downstream limits. A model can generate valid calls faster than a legacy service can process them.

Protocol fact and TechOne recommendation

Design failure as data the model can use safely.

Distinguish protocol errors from tool execution errors. Return bounded, actionable business errors without leaking internal topology, credentials or sensitive records.

Protocol fact and TechOne recommendation

Test both protocol eras during migration.

The 2026-07-28 lifecycle is materially different from the 2025-era `initialize` handshake and session behaviour. Negotiate deliberately and test the clients that will actually consume the server.

Protocol fact and TechOne recommendation

Use Streamable HTTP for shared remote services and stdio for deliberate local process integration.

The transports have different process, network, cancellation and isolation boundaries; they are not interchangeable deployment labels.

Performance evidence

Measure the full call path, not just server response time.

  • Tool catalogue size and definition tokensSplit broad servers, filter by authorisation and defer loading where the host supports it. More visible tools increase context cost before any API call occurs.TechOne recommendation supported by official client guidance
  • Prompt-cache stabilityReturn tools in deterministic order and avoid unnecessary metadata churn.Protocol recommendation
  • Discovery and list cache hit rateTune ttlMs from observed change frequency and invalidate on relevant notifications.Protocol-supported and TechOne recommendation
  • p50, p95 and p99 end-to-end latencyBreak down host, gateway, server and downstream spans rather than optimising only the MCP handler.TechOne recommendation
  • Queue time and active concurrencyProtect constrained downstream systems before latency turns into cascading timeout and retry traffic.TechOne recommendation
  • Timeout, cancellation and orphan-work rateIdentify operations that continue after the client has gone away and make their recovery path explicit.TechOne recommendation
  • Tool success versus business successMeasure accepted, completed, rejected, partially applied and compensated outcomes separately.TechOne recommendation
  • Schema-validation and policy-denial rateUse failures to improve the contract or client behaviour; do not weaken validation to make the metric disappear.TechOne recommendation
  • Cost per completed business outcomeCombine model use, retries, review, integration and downstream cost rather than reporting tool-call volume as value.TechOne recommendation

Release evidence

The negative path is a production feature.

ScenarioExpected behaviourEvidence
Modern protocol request reaches any healthy compatible instanceNo connection affinity is required for protocol state; the request carries its protocol version and client capabilities, while any application state remains reachable through its explicit handle.Load-balancer test across multiple instances with trace correlation.
Unsupported protocol versionThe server returns the defined structured error and advertises supported versions rather than silently interpreting the request.Captured HTTP and JSON-RPC response.
Mcp-Method or an applicable Mcp-Name disagrees with the bodyThe server rejects the request with HTTP 400 and HeaderMismatch -32020.Negative transport conformance test.
Caller has a narrower scope or different tenantThe visible catalogue and object access are reduced; no cached private result crosses the authorisation boundary.Two-principal comparison with cache instrumentation.
Two servers expose the same tool namePolicy, logs and approval UI retain an unambiguous server-qualified identity.Aggregation and routing test.
Tool definition changes after approvalThe release is blocked or moved through semantic review and re-approval before the new contract is active.Schema and description diff in the release record.
Expired or stolen state handle is presented by another principalThe server rejects the call and does not reveal whether another user’s state exists.Cross-principal and expiry test.
Client times out during a writeA repeated command cannot duplicate the side effect; the client can query the original command outcome.Injected timeout with downstream record count and command log.
A resource changes before ttlMs expiresA supported change notification invalidates the cached result, or the documented freshness limitation remains visible to the consumer.Cache invalidation test and resource timestamps.
Downstream system slows or returns partial failureConcurrency remains bounded, timeouts do not cascade and the tool returns an accurate recoverable state.Fault-injection trace and SLO result.
SSE response stream is closed by the clientThe server treats the close as cancellation, stops work where practical and emits no further messages on that request.Cancellation test with server and downstream traces.
OAuth metadata redirects to a private or link-local addressThe client or controlled egress path blocks the request.SSRF test with network-deny evidence.

Handover boundary

A server is not finished until another person can operate it.

  • Latency or timeout SLO breachIdentify the slow hop from traces, reduce admission at the affected capability, stop automatic write retries, verify downstream health and communicate any accepted-but-incomplete work.Evidence: Trace sample, queue depth, downstream status and command-state reconciliation.
  • Unexpected tool or schema changeDisable the affected capability at the catalogue or gateway, preserve the observed definition, compare it with the approved fingerprint and re-enable only after owner review.Evidence: Definition diff, publisher/version record and approval decision.
  • Suspected token or credential exposureRevoke the affected credential, block the audience or client as appropriate, inspect access and downstream logs, rotate dependent secrets and test that old credentials fail.Evidence: Revocation record, affected principals, access timeline and validation test.
  • Cross-tenant or excessive-data exposureFail closed for the affected server, isolate relevant caches, preserve audit evidence, determine impacted principals and data, correct authorisation or cache partitioning and run cross-tenant regression tests.Evidence: Cache keys, policy decisions, access records and repaired test results.
  • Downstream mutation outcome is uncertainDo not issue a new business command until the original command ID has been reconciled. Query the system of record, classify completed, rejected or unknown work and compensate only through an approved business procedure.Evidence: Command log, system-of-record state and compensation approval.
  • Protocol incompatibility after client or server releaseCapture the negotiated version and error, compare modern and legacy lifecycle behaviour, roll back the affected component or route compatible clients separately, then add the case to the conformance suite.Evidence: Wire capture, version matrix and regression test.

Primary sources

Checked against the stated protocol baseline.

Official sources establish the protocol baseline and identify any draft extension. Unless a statement is labelled as a protocol fact, the surrounding control pattern is a TechOne architecture recommendation.

  1. MCP 2026-07-28 specificationNormative protocol baseline
  2. 2026-07-28 release notesRelease changes and migration context
  3. ArchitectureStateless host, client and server model
  4. Transport overviewTransport-independent behaviour
  5. Streamable HTTPHTTP requests, headers, streaming and cancellation
  6. stdioLocal process transport and lifecycle
  7. ToolsSchemas, results, errors, state handles and security
  8. ResourcesResource discovery, reads and subscriptions
  9. CachingTTL, cache scope, invalidation and pagination
  10. Tasks extensionOptional draft extension for durable long-running operations
  11. MCP servers and deferred tool loadingClient integration, deferred loading and safety

Direct answers

Questions that expose the hidden architecture decision.

Does stateless MCP mean the application has no state?

No. MCP 2026-07-28 removes protocol-level sessions. An application may still keep carts, jobs, browser contexts or transactions, but it should expose an explicit handle and validate the caller on every use.

Which MCP responses can be cached?

The current protocol cache model covers server discovery, tool, prompt and resource lists, resource-template lists and resource reads. It does not make tools/call results generally cacheable.

Can we mark every catalogue response public to improve performance?

Only if the response is identical and safe for every caller. A public result may be shared across authorisation contexts. If identity or scopes affect visibility, use private caching and partition it correctly.

Should one MCP server expose every enterprise API?

Usually not. A smaller, task-relevant capability surface reduces model context, policy complexity, unintended authority and the blast radius of a compromised server. The right boundary follows ownership and trust, not an arbitrary tool count.

Does MCP guarantee idempotent writes?

No general business idempotency guarantee is provided by the protocol. Consequential tools should define a command identifier, duplicate behaviour and a way to retrieve the original outcome.

When should we use stdio rather than Streamable HTTP?

Use stdio for a deliberate local child-process integration with a controlled executable and local isolation. Use Streamable HTTP for a shared remote service that needs ordinary network, identity, gateway and horizontal-scaling controls.

Are Tasks required for long-running work?

No. Tasks is an optional draft MCP extension and support must be negotiated and tested. Where it is unavailable, use an explicit durable job contract with status, cancellation and expiry semantics.

What proves that an MCP server is production-ready?

Not a successful demo. Evidence should cover contract validation, authorisation, tenancy isolation, side-effect idempotency, failure recovery, protocol compatibility, observable SLOs, change control and an exercised runbook.

Commercial route

Turn the architecture question into a controlled next step.

We begin with the system boundary, intended capabilities, identities and consequences—not with a gateway product or SDK preference.

Scope a controlled connectorExplore the complete MCP architecture