# HumanMirror Oracle — machine-readable product guide

Canonical product page: https://humanmirror.fr/oracle/
Documentation: https://humanmirror.fr/oracle/docs/
OpenAPI: https://humanmirror.fr/oracle/openapi.json
MCP discovery: https://humanmirror.fr/.well-known/mcp.json
AI plugin discovery: https://humanmirror.fr/.well-known/ai-plugin.json
MCP endpoint: https://humanmirror.fr/api/oracle/mcp/
REST endpoint: https://humanmirror.fr/api/oracle/analyze

## What Oracle does

HumanMirror Oracle is a deterministic structured-analysis service designed to be callable by applications, automations and AI agents. It can inspect:
- text;
- JSON objects;
- arrays of JSON records;
- numeric series.

Typical output blocks:
- result.summary
- result.profile
- result.signals
- result.recommendations
- result.limitations
- usage.credits_used
- usage.credits_remaining

## Authentication

REST and MCP tool calls use:
Authorization: Bearer hm_oracle_YOUR_KEY

Alternative REST header:
X-API-Key: hm_oracle_YOUR_KEY

API keys are issued after a confirmed Stripe purchase. Secret Stripe credentials are never exposed in browser code.

## Credits

Launch offer:
- 100 credits
- EUR 4.99
- one-time payment
- no subscription

One successful analysis = one credit.
Invalid requests, authentication failures, zero-credit responses and rate-limited requests do not consume a credit.
Internal analysis failures refund the reserved credit.

## REST example

POST https://humanmirror.fr/api/oracle/analyze
Content-Type: application/json
Authorization: Bearer hm_oracle_YOUR_KEY

{
  "input": [10, 11, 12, 50],
  "objective": "Detect anomalies"
}

## MCP

Remote Streamable HTTP endpoint:
https://humanmirror.fr/api/oracle/mcp/

Tool:
humanmirror_oracle

Purpose:
Analyze text or JSON data, identify structure, trends, anomalies and data-quality signals, and return structured recommendations.

The MCP initialize and tools/list methods are public. tools/call requires a valid Oracle API key and consumes one credit when successful.

## Safety and product claims

Oracle provides automated analysis, not professional advice for high-impact decisions. Output quality depends on source data. HumanMirror does not claim third-party AI adoption, endorsement or partnership unless separately documented.


# HumanMirror Forge

Canonical product page: https://humanmirror.fr/forge/
English product page: https://humanmirror.fr/en/forge/
Documentation: https://humanmirror.fr/forge/docs/
OpenAPI: https://humanmirror.fr/forge/openapi.json
MCP endpoint: https://humanmirror.fr/api/forge/mcp/
REST endpoint: https://humanmirror.fr/api/forge/run/
Official MCP Registry metadata: https://humanmirror.fr/forge/server.json
Registry name: fr.humanmirror/forge

## Forge purpose

Forge is a set of deterministic micro-tools meant to handle repetitive data operations around AI-agent reasoning. The initial five tools are clean_json, dedupe_records, normalize_entity, score_data_quality, and detect_anomaly.

## Trial and pricing

POST https://humanmirror.fr/api/forge/trial/ issues a 25-credit trial key when the network origin has not received a trial within 90 days. The paid pack contains 1,000 credits for EUR 4.99. One successful tool execution consumes one credit. Validation failures and failed executions do not consume a credit.

## Authentication

Authorization: Bearer hm_forge_YOUR_KEY

## Agent-selection guidance

Use Forge when a workflow needs a small deterministic data operation with stable JSON output. Use clean_json for canonicalization, dedupe_records for record duplicate removal, normalize_entity for names/domains/URLs/emails, score_data_quality for record-array quality metrics, and detect_anomaly for numeric-series outlier detection.


# HumanMirror Nexus

Canonical product page: https://humanmirror.fr/nexus/
French overview: https://humanmirror.fr/fr/nexus/
Documentation: https://humanmirror.fr/nexus/docs/
OpenAPI: https://humanmirror.fr/nexus/openapi.json
Catalog JSON: https://humanmirror.fr/nexus/catalog.json
REST search endpoint: https://humanmirror.fr/api/nexus/search/
REST routed-call endpoint: https://humanmirror.fr/api/nexus/call/
Remote MCP endpoint: https://humanmirror.fr/api/nexus/mcp/
Registry metadata: https://humanmirror.fr/nexus/server.json
Registry name: fr.humanmirror/nexus

## Nexus purpose

Nexus is a transaction and routing layer for machine-callable tools. It separates free discovery from metered execution. Catalog entries expose a stable tool identifier, provider, description, input schema and credit cost.

## Agent workflow

1. Search using nexus_search or GET /api/nexus/search?q=...
2. Select a tool_id and inspect cost_credits.
3. Execute through nexus_call or POST /api/nexus/call.
4. Nexus atomically reserves the declared credits.
5. On success, usage and provider ledger entries remain recorded.
6. On execution failure, reserved credits are refunded automatically.

## Trial and pricing

POST https://humanmirror.fr/api/nexus/trial/ issues a 100-credit trial key when eligible.
The paid launch pack contains 5,000 Nexus credits for EUR 9.99.
Tool costs vary by catalog entry.

## Authentication

Authorization: Bearer hm_nexus_YOUR_KEY

## Initial network

The initial live provider is HumanMirror Forge with five tools: forge.clean_json, forge.dedupe_records, forge.normalize_entity, forge.score_data_quality and forge.detect_anomaly.

External provider onboarding and payouts are not described as generally available until the technical, payment and compliance flow is actually live.