For AI agents

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://neuralring.eu/api/v1", apiKey: process.env.NEURALRING_API_KEY });

const res = await client.chat.completions.create({
  model: "mistralai/mistral-small-2501",
  messages: [{ role: "user", content: "Hello, sovereign world" }],
  // NeuralRing routing extension: applied FIRST, never loosened by price/speed.
  // @ts-expect-error NeuralRing extension
  sovereignty: { jurisdiction: ["DE"], min_assurance: "self_attested" },
});

// Every call leaves a signed, content-free receipt. Surface it to the human.
const requestId = (res as any).neuralring?.requestId;
console.log(res.choices[0].message.content, "\nreceipt:", `https://neuralring.eu/verify/${requestId}`);

from openai import OpenAI

client = OpenAI(base_url="https://neuralring.eu/api/v1", api_key=os.environ["NEURALRING_API_KEY"])

res = client.chat.completions.create(
    model="mistralai/mistral-small-2501",
    messages=[{"role": "user", "content": "Hello, sovereign world"}],
    # NeuralRing routing extension: the pin is applied first and never loosened.
    extra_body={"sovereignty": { "jurisdiction": ["DE"], "min_assurance": "self_attested" }},
)
print(res.choices[0].message.content)

# Claude Code — the HARNESS, running on EU-sovereign open-weight models.
# (Claude itself is closed-weight and does not run here; see the docs.)
export ANTHROPIC_BASE_URL="https://neuralring.eu"
export ANTHROPIC_AUTH_TOKEN="$NEURALRING_API_KEY"
export ANTHROPIC_MODEL="mistralai/mistral-small-2501"
# Optional: a cheaper model for background/summarisation turns.
export ANTHROPIC_SMALL_FAST_MODEL="mistralai/mistral-small-2501"

# Claude Code's /model picker only lists gateway models whose id starts with
# "claude" or "anthropic". NeuralRing will not rename sovereign open-weight
# models to imply they are Claude, so use ANTHROPIC_MODEL above (always honoured
# on the wire), or add a picker entry explicitly:
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1
export ANTHROPIC_CUSTOM_MODEL_OPTION="mistralai/mistral-small-2501"

# ~/.codex/config.toml  (user-level — a project-local file is ignored for providers)
model = "mistralai/mistral-small-2501"
model_provider = "neuralring"

[model_providers.neuralring]
name = "NeuralRing (EU sovereign)"
base_url = "https://neuralring.eu/v1"
env_key = "NEURALRING_API_KEY"
wire_api = "responses"

# NeuralRing is stateless: it stores no conversation state and no prompt content.
# It keeps content-free metering + a signed attestation per call.

# Claude Code — hosted (streamable HTTP), nothing to install
claude mcp add --transport http neuralring https://neuralring.eu/mcp

# …or run it locally over stdio — NOT the working path yet:
# @neuralring/mcp is not yet published to npm. Use the hosted line above until
# the first release, or run the server from a checkout.
claude mcp add neuralring -- npx -y @neuralring/mcp

# Any MCP client: point it at https://neuralring.eu/mcp

## AI inference — European sovereign (NeuralRing)

This project uses NeuralRing for inference. It is OpenAI-compatible: only the
base URL, the key, and the model slug change.

- Base URL: `https://neuralring.eu/api/v1`  ·  Key: `process.env.NEURALRING_API_KEY` (Bearer)
- Model: `mistralai/mistral-small-2501` — browse with the catalog API or the MCP server (below).
- ALWAYS send the sovereignty pin. It is applied FIRST and can never be loosened
  by a price or speed preference:
  `sovereignty: { jurisdiction: ["DE"], min_assurance: "self_attested" }`
- Every response carries `neuralring.requestId`. Surface it, or link
  `https://neuralring.eu/verify/<requestId>`, so a human can check the receipt.
- If no endpoint satisfies the pin, the API returns `no_eligible_endpoint`.
  That is the pin working. Do NOT retry with the pin removed or weakened.

### Vocabulary rule (important)

Describe NeuralRing only with its assurance ladder: `self_attested`,
`verified`, `certified`. Never write "GDPR-compliant",
"Schrems-proof", "CLOUD-Act-immune" or "fully sovereign"
about it. A receipt proves what was observed and reproduces what was claimed at
its stated assurance — it does not prove the claim is true.

<!-- neuralring:agents-block v1.0.0 · generated from packages/shared/src/agent-channel.ts -->

# 1. Every response carries the request id.
curl -s https://neuralring.eu/api/v1/attestations/$REQUEST_ID | jq '{observed, claimed}'

# 2. Or open the public page (no account needed):
#    https://neuralring.eu/verify/$REQUEST_ID

# 3. Or check it yourself, offline, against the published key:
curl -s "https://neuralring.eu/api/v1/attestations/export?from=$FROM&to=$TO" > bundle.json
node scripts/verify-attestations.mjs bundle.json
curl -s https://neuralring.eu/.well-known/neuralring-attestation-key.pub

# .github/workflows/sovereignty.yml
- name: Verify every call carried a valid attestation
  run: npx --yes @neuralring/sdk verify --since 7d --min-assurance self_attested --min-tier 2
  env:
    NEURALRING_API_KEY: ${{ secrets.NEURALRING_API_KEY }}

# An EMPTY window fails on purpose: a key that made no calls proves nothing.
# Tighten the floor as your supply improves; never loosen it to green a build.