SeenRelay MCP server

SeenRelay

Find out whether your agent fleet is wasting time or provider spend on repeated read-only validation — before enabling reuse.

SeenRelay starts with a free shadow audit. Run the workload you already have while every authoritative validation stays enabled. Measure exact recurrence, stronger local/source/provider-native controls, safety equivalence and prospective economics. Keep SeenRelay only where the result is USE; accept DO NOT USE or INSUFFICIENT EVIDENCE everywhere else.

Currently free · no account · no SeenRelay API key required.

SeenRelay itself requires no account or API key. A third-party client, directory, gateway, or assistant may require its own account to use that third-party service; that is not a SeenRelay access requirement. The canonical direct MCP endpoint is https://seenrelay.com/mcp.

Fastest start: give the audit to your coding agent

npx skills add https://seenrelay.com --skill seenrelay --yes

Then ask it:

Run a SeenRelay shadow audit on this project. Find repeated expensive read-only validations, preserve every authoritative call, measure stronger local/source/provider-native controls first, do not enable reuse, and return USE / DO NOT USE / INSUFFICIENT EVIDENCE for each measured workload.

Or use the developer paths below. Full audit method: docs/SHADOW_AUDIT.md.

<!-- BEGIN GENERATED:PUBLIC-FACTS --> Install: npm install seenrelay · pip install seenrelay · client v0.2.14 · currently free · no account/API key. <!-- END GENERATED:PUBLIC-FACTS -->

Free shadow audit: measure without changing application behavior

Ambient wraps an existing MCP-style client in local shadow mode. The authoritative call still runs; SeenRelay measures exact repetition and produces a local report.

JavaScript / TypeScript:

npm install seenrelay

import { ambientMcpClient } from 'seenrelay/ambient';

const client = ambientMcpClient(rawMcpClient);
// use client.callTool(...) normally
console.log(client.seenRelayAmbient.getReport());

Python:

pip install seenrelay

from seenrelay_ambient import ambient_mcp_client

client = ambient_mcp_client(raw_mcp_client)
# await client.call_tool(...) normally
print(client.get_report())

Run the existing workload and inspect the report before enabling any bounded reuse. Shared CHECK remains optional and off by default in Zero-State.

SeenRelay is a provider-independent reuse layer for repeated read-only validation. It has exactly two hosted domain operations: CHECK and OBSERVE, and reports recent observations rather than universal truth.

Current JavaScript/TypeScript and Python clients include multi-signal shared-evidence assurance helpers, deterministic Fact Coordinate Kit v1 and provider-independent Zero-State. Python Zero-State supports explicit read-only in-flight/local reuse, caller-owned private L1 and source-native conditional validation before authoritative fallback. The classic Python API and Python Ambient adapters remain shadow-first by default. Shared evidence is explicit caller policy, does not prove truth or independent real-world actors, and MCP/OpenAPI coordinates are local repetition keys unless a stable source-native locator supports a shared fact descriptor. Provider-specific adapters are optional.

What it can avoid

Even with no shared observation:

• simultaneous identical eligible calls can be coalesced in-process;
• completed read-only results can be reused only inside an explicit caller-defined freshness window;
• optional encrypted caller-owned L1 storage can reuse values across workers or restarts;
• ETag / Last-Modified can support source-native conditional confirmation without a shared CHECK;
• shared CHECK is optional in Zero-State and is not placed on the hot path merely because SeenRelay is installed;
• after a genuinely fresh independent validation, OBSERVE can add evidence that may help later callers.

Shortened. The full README is on GitHub.