Repository navigation
Home
Technical guide and domain use cases — 21 November 2026. Experimental research service.
Q-SPEACE can provide an agentic generative-AI system with bounded numerical tools for information aggregation, resource-allocation experiments, adaptive pacing and computational-cost estimates. The LLM remains responsible for language and planning; the external orchestrator remains responsible for permissions, scheduling, budgets and execution. Connecting MCP does not automatically implement the whole Paradigm 6.0 architecture.
- 1. Endpoint and access
- 2. Architecture and Paradigm 6.0
- 3. Available tools
- 4. Connect an external agent
- 5. Apply scheduling and budget policies
- 6. Domain motivations and use cases
- 7. Runnable tool examples
- 8. Evidence, evaluation and operational limits
- 9. Troubleshooting
- 10. Specifications and source
| Setting | Value |
|---|---|
| MCP endpoint | https://q-speace-mcp.onrender.com/mcp |
| Transport | MCP Streamable HTTP over HTTPS |
| OAuth issuer | https://dev-imfska6viiq1ehqw.us.auth0.com/ |
| API audience | https://q-speace-mcp.onrender.com/mcp |
| Token endpoint | https://dev-imfska6viiq1ehqw.us.auth0.com/oauth/token |
| Resource metadata | https://q-speace-mcp.onrender.com/.well-known/oauth-protected-resource/mcp |
| Verified client SDK | Official Python MCP SDK 1.30.0 |
| Configured unattended-client flow | OAuth client credentials, RS256 access tokens, 900-second lifetime |
| Hosting profile | Render Free, Frankfurt; one application process and one concurrent numerical worker |
The endpoint is internet-accessible, but computational RPCs require an authorized access token. A public URL does not mean anonymous access. Access must be provisioned by the operator: create a separate Auth0 application for each trusted agent and grant only its required scopes. No dynamic client registration or interactive authorization-code/PKCE client has been configured by this deployment. A desktop client expecting automatic OAuth registration may need a separately registered client or an external token-handling adapter.
Never send GitHub, Hugging Face or ID tokens as Q-SPEACE access tokens. Never put client secrets in prompts, source control, URLs or browser-side JavaScript. The MCP resource server needs public verification keys, not the OAuth client secret.
Connection verified on 21 November 2026: initialize, initialized notification, ping, discovery of eight tools, BCEL/clock/metabolism calls and invalid-argument recovery using the official SDK. This is dated evidence, not an uptime guarantee.
Recorded data / approved read-only data adapters
|
v
Agentic LLM + external orchestrator
- selects tasks and explains results
- maps telemetry to declared numerical inputs
- enforces permissions, budgets and stop rules
|
OAuth bearer token + Streamable HTTP
v
Q-SPEACE MCP gateway
- verifies issuer, audience, signature, expiry and scopes
- binds session ownership and enforces service quotas
- validates bounded requests and records hash-only audit
|
v
Disposable numerical worker
economy / ILF clock / metabolism / BCEL catalog
|
v
Structured result -> orchestrator -> human-reviewed advisory
Physical controllers and operational execution remain outside this service.
An LLM can describe a trade-off without computing it consistently. Tool calling gives the agent an explicit numerical contract, discoverable schemas and results that can be checked independently. It also lets different agent frameworks share the same primitives without embedding the whole repository. The useful research question is whether these primitives improve task quality, resource use or robustness compared with simpler baselines. Benefits must be measured.
The technical interpretation of Paradigm 6.0 separates SPEACE Macro (domain agents, data interfaces and execution infrastructure) from Q-SPEACE Micro (numerical/advisory mediation). The remote MCP adapter is a narrow access surface for a subset of Micro. It is not the complete Macro–Micro Bridge.
| Paradigm design idea | Concrete implementation or responsibility | Status and boundary |
|---|---|---|
| Homeostasis | ILF adaptive-rate scalar; orchestrator applies pacing | Clock tool exists; no automatic control of an external LLM |
| Resource awareness | Metabolism estimates and Sevo; separate client budget ledger | Estimate is not measured hardware energy or spending authority |
| Concept discipline | BCEL functional/accidental classifications | Read-only catalog; not a code-execution sandbox or safety certificate |
| Multiple viewpoints | KL-barycentre calculation over caller-supplied distributions | Numerical aggregation; agreement does not prove correctness |
| Constrained allocation | VTEC projected-gradient experiment | Simplified declared objectives/constraints; no arbitrary industrial optimizer |
| Typed, auditable boundaries | T223 local adapter and T225 authenticated HTTP adapter | Implemented experimental surface; replay/audit requirements remain incomplete |
| Safe assimilation | T217 qualification lifecycle and T218 authorization boundary | No remote activation or operational promotion through these tools |
| Polycentric governance and resilience | Independent operators, revocable authority and domain validation | Architectural objective; a single free hosted instance is not a resilient distributed deployment |
Read the manifesto together with its technical errata. Biological terms are mathematical analogies only. No consciousness, life, quantum advantage or quantum communication is claimed. The HTTP service does not expose the quantum backend, fractal QCA, spiking-brain interface, a shared swarm blackboard, Kuramoto controller or live Earth feeds. Presence of a repository module does not make it remotely callable.
T218 relationship. T218 contains Bridge update/journal/validation primitives and a simplified microgrid harness. The T225 branch requires authorization before new ledger activations and prevalidates coupled activations. That does not implement a fault-isolated independent validator or crash-atomic distributed commit. Bridge activation, rollback and validator promotion are absent from the HTTP allowlist. T218 and manifesto Bridge sketches are related specifications, not identical wire protocols.
Always call tools/list and inspect the returned inputSchema. Discovery is scope-filtered; direct calls cannot bypass scope checks. Additional HTTP worker limits can be stricter than the general shared schema.
| Tool | Scope | Purpose | Interpretation |
|---|---|---|---|
bcel_lookup |
qspeace:catalog.read |
Query functional/accidental concept classifications | Does not approve a deployment |
adaptive_clock_rate |
qspeace:compute |
Compute rate from coherence_phi
|
Client decides how to schedule |
metabolism_cost_eval |
qspeace:compute |
Estimate power, energy and Sevo from declared operations | No automatic LLM-token-to-joule conversion |
compute_jc |
qspeace:compute |
Construct the economic J_c telemetry tuple | Caller defines measurement semantics and provenance |
cme_evaluate |
qspeace:compute |
Evaluate a twelve-component CME vector | Not a calibrated universal sustainability/welfare score |
elasticity_test |
qspeace:compute |
Compare declared claim/external trajectories and thresholds | Algorithmic comparison, not standards certification |
kl_barycentre_aggregate |
qspeace:simulation.compute |
Aggregate probability distributions | Correlated sources need explicit treatment |
vtec_allocate |
qspeace:simulation.compute |
Run bounded projected-gradient allocation | Does not execute purchases, dispatch or physical changes |
The local T223 stdio server exposes ten tools, including dat_mint and dat_spend. Those two accounting mutations are intentionally unavailable over public HTTP. The official GitHub MCP server is a different service for repository access; it does not execute Q-SPEACE computations.
Ask the Q-SPEACE operator to register your trusted backend agent in Auth0 and authorize the API audience above. Request the minimum scopes: catalog only, computation, and/or simulation computation. Receive the client secret through an approved secret-management channel. Do not post credentials in an issue or Wiki. Separate client identities allow grants to be revoked independently.
The existing operator application is not a shared public credential. For human-operated clients, the operator must separately configure the appropriate supported OAuth flow and exact callback URLs.
Use Python 3.12 for the reference client:
python -m venv .venv
# Activate the environment using your shell.
python -m pip install "mcp==1.30.0" "httpx>=0.28,<1"Inject QSPEACE_CLIENT_ID and QSPEACE_CLIENT_SECRET from your secret manager into the client process environment. Do not include their values in the script.
Save this as connect_qspeace.py. It obtains a token in memory, initializes MCP, prints discoverable tools and calls the three main primitives. It does not invoke an LLM or execute domain actions.
import asyncio
import json
import os
import httpx
from mcp import ClientSession
from mcp.client.streamable_http import streamable_http_client
ENDPOINT = "https://q-speace-mcp.onrender.com/mcp"
TOKEN_URL = "https://dev-imfska6viiq1ehqw.us.auth0.com/oauth/token"
async def main():
async with httpx.AsyncClient(timeout=60) as auth:
response = await auth.post(
TOKEN_URL,
json={
"grant_type": "client_credentials",
"client_id": os.environ["QSPEACE_CLIENT_ID"],
"client_secret": os.environ["QSPEACE_CLIENT_SECRET"],
"audience": ENDPOINT,
},
)
response.raise_for_status()
token = response.json()["access_token"]
async with httpx.AsyncClient(
headers={"Authorization": "Bearer " + token}, timeout=60
) as http:
async with streamable_http_client(
ENDPOINT, http_client=http
) as (read, write, _):
async with ClientSession(read, write) as session:
initialized = await session.initialize()
print("Connected:", initialized.serverInfo.name)
await session.send_ping()
tools = (await session.list_tools()).tools
names = {tool.name for tool in tools}
print("Granted tools:", sorted(names))
calls = [
("bcel_lookup", {"concept": "Homeostasis"}),
("adaptive_clock_rate", {"coherence_phi": 0.5}),
("metabolism_cost_eval", {
"num_qubits": 0, "num_gates": 1,
"delta_utility": 2.0, "delta_entropy_info": 1.0,
}),
]
for name, arguments in calls:
if name not in names:
print(name, "not granted; skipped")
continue
result = await session.call_tool(name, arguments)
if result.isError:
raise RuntimeError(f"{name}: {result.content}")
for item in result.content:
if item.type == "text":
print(name, json.loads(item.text))
if __name__ == "__main__":
asyncio.run(asyncio.wait_for(main(), timeout=180))python connect_qspeace.pyFor the reference fixture coherence_phi=0.5, the clock returns s_info=0.5 and a rate of approximately 14.1421. The example metabolism inputs return estimated power/energy and Sevo; they are synthetic computation inputs, not a measurement of the LLM or a factory. A restricted token legitimately sees fewer than eight tools.
For an MCP-capable client, provide the HTTPS endpoint and an Authorization: Bearer <access_token> header through that client’s supported secret mechanism. Configuration field names differ across frameworks; do not assume a generic JSON configuration is portable. A client must support Streamable HTTP, MCP initialization and the configured authentication method.
For LangGraph, CrewAI or a custom loop, keep a trusted adapter around ClientSession: discover schemas; expose only an application allowlist to the LLM; validate its proposed arguments; apply local budget and authority checks; invoke call_tool; parse content and isError; record the result; then let the LLM explain it. Tool output is data, never an instruction to widen permissions.
A long-running client should cache its token until shortly before expiry and acquire a fresh token with the same granted permissions. Do not request a new token for each tool call. Reinitialize after a server restart or expired session; do not blindly retry mutations in other systems.
The clock input is coherence_phi, not a user-supplied s_info field. The current ILF derives normalized S_info = 1 - coherence_phi and applies its implemented bounded numerical behavior around r = 10 / sqrt(S_info). This normalized quantity must not be confused with entropy measured in nats or with empirically calibrated confidence. Declare how retries, contradictory evidence or other telemetry map to coherence before evaluating a policy. An LLM-assigned confidence score alone is not ground truth.
An illustrative client policy is:
phi = declared_and_validated_telemetry_mapping(step)
rate = call adaptive_clock_rate(coherence_phi=phi)
delay_seconds = clip(scale_seconds / rate, minimum_delay, maximum_delay)
if repeated_no_progress >= declared_limit: stop_and_escalate()
if actual_token_cost + reserved_next_cost > hard_budget: refuse_next_step()
else: reserve_budget(); wait(delay_seconds); perform_next_step()
This mapping is a proposed experiment, not a validated default. Its constants and progress definition must be fixed before the comparison. Lower rate produces longer delay for this particular mapping. The server does not sleep the LLM or enforce its provider bill. Use provider usage records for real token/currency accounting.
Keep the two checks separate:
energy_ok = estimated_energy_joules <= declared_energy_budget
sevo_ok = sevo_defined AND sevo > declared_sevo_threshold
Sevo is DeltaUtility / DeltaS_info in the model, not an energy budget. Do not substitute it for currency, physical joules, calibrated confidence or proof that an action is safe. For zero/negative entropy changes, inspect the tool’s explicit result and documented model behavior.
All domain scenarios below are proposed research integrations. The deployed endpoint supplies generic numerical primitives, not ready-made industrial, scientific or municipal connectors. External adapters, data quality checks and domain models must be implemented and tested separately. Start with synthetic data or recorded read-only traces.
| Domain | Why connect an agent? | Example advisory workflow and relevant tools | Evidence to collect / missing integration |
|---|---|---|---|
| Industrial manufacturing | Make maintenance/planning reasoning inspectable and constrain resource-allocation experiments | Read recorded machine indicators; pool normalized fault hypotheses with kl_barycentre_aggregate; compare allocation candidates with vtec_allocate; explain a maintenance recommendation |
Precision/recall, false-alarm rate, downtime, constraint violations; OPC UA/MQTT/MES adapter and plant model are external; PLCs retain control |
| Scientific research and laboratory workflows | Separate narrative hypothesis generation from explicit numerical aggregation and reproducible experiment selection | Agents produce probabilities over the same hypotheses; aggregate distributions; use clock/budget policies to bound repeated failed analyses; propose the next experiment | Held-out calibration/Brier score, reproducibility, discovery rate versus a baseline; instrument and workflow adapters are external |
| Engineering design and digital twins | Compare bounded numerical design candidates while keeping approval and verification separate | An engineering agent prepares dimensionless candidate inputs; VTEC explores a declared simplified allocation; metabolism estimates the declared computational workload; BCEL checks the meaning of analogies | Feasibility, solver-baseline objective, residuals, robustness under perturbation; CAD/CAE/FEA and physical validation remain external |
| Smart cities and municipal services | Explore resource trade-offs between service areas and make recommendations explainable | A read-only digital-twin adapter aggregates cell-level demand; VTEC tests a toy service allocation; CME records a declared multi-component profile; the agent explains options to planners | Service-level adherence, unmet demand and geographic distribution; GTFS/GIS/H3 and transport/fairness constraints are external; no live traffic or rights-affecting decision authority |
| Energy and microgrids | Evaluate planning proposals without putting an LLM in a protection/control loop | Replay historical load scenarios; aggregate forecast hypotheses; evaluate a simplified allocation; present an advisory to an engineer | Constraint violations, forecast error and energy-model accuracy; power-flow simulation, grid limits and certified control remain external; no islanding command |
| Robotics and multi-agent swarms | Study whether pacing and bounded task allocation improve recovery under simulated failures | In a simulator, agents report progress and normalized task hypotheses; clock policy slows repeated failures; VTEC proposes reassignment | Completion rate, collision/safety-envelope violations, recovery time and communication cost; ROS 2/DDS adapter and safety controller are external; no robot actuation via MCP |
| Environment, Earth observation and agriculture | Aggregate evidence and bound exploratory analysis before requesting new measurements | Process recorded satellite/weather or soil data; aggregate hypotheses over a shared event space; recommend a sensor-inspection campaign | CRPS/Brier skill versus climatology, false alarms and effect sizes; live feeds and domain forecasting models are external; no established Earth-signal/cognition effect |
| Logistics and supply-chain research | Compare explicit capacity constraints and alternatives when a simulated node fails | An agent turns a small scenario into VTEC inputs and explains the result; an external routing solver checks the proposed allocation | Unmet demand, capacity violations, delivery service and runtime versus LP/MILP/heuristics; routing, inventory and transactional systems are external |
| Agent operations and software research | Measure whether feedback reduces unproductive loops without losing correct completions | Replay the same tasks with a fixed-iteration baseline and an MCP-regulated policy; log usage, retries and early stops | Correct completion, real provider cost, latency and false early-stop rate; hard budget, JSONL evidence and independent review belong to the orchestrator |
Two diagnostic agents assign probabilities to the same ordered classes [normal, bearing_fault, sensor_fault]. Their distributions and source windows are logged. The agent calls kl_barycentre_aggregate, reports the resulting distribution and explicitly notes source correlation. A maintenance engineer evaluates the recommendation against labeled historical failures. An external plant model evaluates schedule changes; the MCP result never changes a PLC.
Example agent instruction: “Use the recorded diagnostics only. Inspect the MCP schemas, aggregate the two distributions, report uncertainty and provenance, and propose a maintenance review. Do not issue machine commands. Compare recommendations against the labeled baseline before claiming improvement.”
Three synthetic districts request inspection capacity. A planner defines normalized capacities and the supported VTEC constraints. The agent evaluates a small candidate allocation and explains what is left unmet. A separate municipal model checks travel times, minimum service coverage and distributional impacts. A city official sets priorities and decides whether to commission a confined prototype. Hexagonal partitioning may be used by that external model; the MCP server does not supply an H3 routing service.
Example agent instruction: “Analyze this synthetic three-district allocation as an advisory. Show the declared constraints and unmet demand, compare with a simple equal-share baseline, and identify constraints the current VTEC model cannot express. Do not schedule crews or change traffic signals.”
A research agent repeatedly encounters contradictory results on a fixed dataset. Its external adapter uses a preregistered mapping from observed retries/disagreement to coherence. It calls the clock, applies backoff, and stops after a declared no-progress threshold. The next experiment remains a recommendation. Evaluate whether fewer wasted calls are offset by more incorrect early stops.
Example agent instruction: “Run the fixed dataset under baseline and MCP-regulated policies. Keep the same task inputs and success rubric. Report correct completion and cost jointly, including regressions; do not infer a benefit from token savings alone.”
Use these calls inside an initialized ClientSession. They use synthetic values; inspect isError before consuming results. The caller must have the relevant scope.
result = await session.call_tool(
"kl_barycentre_aggregate",
{
"distributions": [[0.6, 0.3, 0.1], [0.4, 0.5, 0.1]],
"weights": [0.5, 0.5],
"max_iter": 50,
},
)Use the same class ordering and compatible normalization across sources. Do not describe the returned KL barycentre as a quantum simulation, a calibrated posterior or a proof of consensus correctness.
result = await session.call_tool(
"vtec_allocate",
{
"objective_kind": "sum",
"u_max": [1.0, 1.0, 1.0],
"constraints": {
"s_assimilable": 2.0,
"e_available": 2.0,
"m_available": 2.0,
"ecological_threshold": 2.0,
"risk_acceptable": 2.0,
"human_agency_min": 0.0,
},
"horizon": [20, 5],
"lr": 0.05,
},
)The example uses dimensionless toy inputs. Field names such as ecological threshold and human agency do not provide calibrated ecological assessment or encode an entire governance policy. Audit the actual objective and constraint implementation before mapping domain quantities. This is projected-gradient optimization with supported sum/centered objectives, not a guarantee of global optimality for arbitrary nonlinear problems.
result = await session.call_tool(
"metabolism_cost_eval",
{
"num_qubits": 0, "num_gates": 10, "num_spikes": 100,
"duration_s": 1.0,
"delta_utility": 2.0, "delta_entropy_info": 1.0,
"sevo_threshold": 1.5,
},
)These operation counts must come from a defined workload model. Supplying zero qubits does not turn the cost model into an LLM energy meter. Physical measurements and hardware-specific calibration are separate experiments.
The local suite recorded 610 passed tests and three skips, followed by seven passing HTTP regression tests after the Windows-to-Linux audit-path fix. A Linux-container smoke test and a public Auth0/Streamable-HTTP SDK smoke test passed. Protocol interoperability and tested rejection paths are demonstrated for this profile; domain effectiveness and production qualification are not.
The T224 default controlled experiment is a negative result for that policy: baseline 3/4 correct completions and 360 synthetic tokens; regulated 2/4 and 220. Lower token use accompanied worse completion. These synthetic units are not provider billing or measured energy. The result must not be presented as evidence that MCP regulation improves agents.
- Specify a fixed task/dataset, ground truth, input units and telemetry mapping.
- Freeze policy thresholds, sample size, seeds, budgets and stopping rules before the comparison.
- Compare the same tasks with a simple classical/domain baseline and a regulated condition. Include MCP/network/worker overhead.
- Log version, seed, tool/arguments or protected input reference, output, actual usage, retries, stop reason and correct completion in a client-owned evidence store. Keep secrets and sensitive data out of logs.
- Report accuracy/completion and cost together, confidence intervals where justified, and failed/negative results.
- Follow T217 before any host-system promotion: correction, simulation, isolated replica, confined prototype, independent review and selective integration. The candidate cannot approve itself.
- Render Free can suspend after inactivity. Cold starts add latency. Availability is not guaranteed.
- Sessions, rate counters and SQLite audit are local/ephemeral. Restarting loses service state; do not rely on it as an accounting ledger or durable audit archive.
- Session ownership is bound to authenticated tenant/issuer/subject; a session identifier is not authorization. This is not proof of multi-replica state isolation or complete OS sandboxing.
- Current deployed wall timeout is 20 seconds with one concurrent numerical worker. Worker processes are terminated on timeout; Linux workers also have CPU/address-space limits. This does not make the service hard real-time or provide network-egress isolation.
- Default request quota is 60/minute with burst 10; session cap is four per principal. Respect
429and retry guidance. - Payloads are bounded (64 KiB); KL experiments are limited to 64 distributions of up to 256 entries and 100 iterations; VTEC to 64 dimensions and at most 100 iterations. Do not submit large datasets or confidential plant telemetry to this prototype.
- Server audit stores hashes, not full replay inputs. Encryption, independent checkpoints, canonical end-to-end replay and durable multi-replica accounting remain incomplete.
- JWT signing keys are pinned. Operator-reviewed configuration updates are required for signing-key rotation.
- No remote DAT mutations, Bridge actuation, arbitrary Python execution, GitHub writes, quantum-hardware execution or live industrial adapters are offered.
For an operational deployment, use an appropriately reviewed hosting/security design, persistent evidence and quotas, domain validation and independent qualification. The free prototype is suitable for bounded research and demonstrations.
| Symptom | Check / response |
|---|---|
401 Unauthorized |
Token expired, wrong issuer/audience, ID token supplied, unpinned signing key or invalid signature. Obtain the proper access token; do not disable validation. |
403 Forbidden |
Missing tool scope or rejected Host/Origin. Verify grants and exact operator configuration. |
| Fewer than eight tools | Discovery is filtered by the token scopes; this can be expected. |
404 with a session ID |
Session is expired, lost after restart or belongs to another principal. Initialize a new authorized session. |
405 on GET /mcp
|
This profile does not provide a persistent GET event stream. Use Streamable HTTP requests with the supported SDK. |
429 / worker capacity exhausted |
Respect retry timing; reduce concurrency and avoid retry loops. |
Tool isError=True
|
Inspect schema, ranges and computation limits. A tool error need not close the connection. Do not treat an error as a zero cost or a favorable gate result. |
worker_timeout |
Free-tier CPU is slow or work is too large. Reduce the request; the operator must review any bounded timeout change. |
503 / unavailable service |
Cold start, deployment or audit-store failure. Bound retries and fall back to local/domain-safe behavior. |
| OAuth popup cannot register the client | This deployment has no dynamic client registration; use an operator-registered client or supported token adapter. |
The HTTP implementation is on branch codex/t225-remote-mcp. Documentation follow-up commit: d6629ed22c6e72c0a4b38dc60aa9f6cdd992b0d0. The publicly verified runtime was built from a2a2ab7d41ded324dd49b6b25ee60e2f36143093 with operator-supplied Auth0 verifier configuration. Automatic deployment is disabled.
- T225 remote MCP specification and T218 reuse matrix
- Detailed repository connection/deployment guide
- Manifesto v2.0 technical errata
- T218 Bridge specification
- T223 local stdio adapter
- T208 evidence-first development
- T217 safe assimilation lifecycle
- T224 controlled experiment
- Public connection verification report
- HTTP gateway, session handling and workers
- Tool contracts and implementations
- Official Python MCP SDK
This Wiki documents an experimental implementation and proposed applications. It does not claim certification, validated industrial benefit, planetary governance, consciousness or quantum speedup.