Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

Novi Corpus

✓ vom Dienst · novicorpus.com

von jb1011Version 1.0.0i★ 4 (Sterne gehören zu einem anderen Repo)iLäuft in der CloudOffizielle Website ↗
Name in der Registrycom.novicorpus/legal-body

So installierst du es

What it does

A legal body for AI agents: a real company, a verified human and spending rules on Arc (testnet).

  • Connects Läuft in der Cloud
  • Account or key Needs Authorization
  • Category Recht & Behördendaten

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit0/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch8/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert20/100

Qualität: 1/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte Novi Corpus. Folge https://mcp.popnx.com/i/novicorpus-legal-body.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

1/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (api.novicorpus.com) · ✓ Befehle geprüft am 13. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 5 Min.

Du brauchst einen Schlüssel von Novi Corpus (auf der Seite des Anbieters erstellen) · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Bei Novi Corpus registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Novi Corpus öffnen ↗

  2. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameNovi Corpus
    Remote MCP server URL · Adressehttps://api.novicorpus.com/mcp

    Unter Request headers diesen Namen und Wert hinzufügen

    Header-NameAuthorization
    WertBearer <Schlüssel hier einfügen>

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  4. Im Chat einschalten

    +ConnectorsNovi Corpus

  5. Ausprobieren

    Nutze Novi Corpus und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Novi Corpus nutzt, oder ein Werkzeug von Novi Corpus in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann Novi Corpus noch nicht verbinden

Novi Corpus braucht zum Verbinden deinen eigenen Schlüssel, aber die OpenAI-Hilfe beschreibt nur die Anmeldung per OAuth; eine Schlüssel-Option konnten wir nicht bestätigen

Das kannst du stattdessen tun

A · Eine App nutzen, die Novi Corpus verbinden kann

  • Du brauchst einen Schlüssel von Novi Corpus (auf der Seite des Anbieters erstellen) · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu
  • Du brauchst einen Schlüssel von Novi Corpus (auf der Seite des Anbieters erstellen)
  • Du brauchst einen Schlüssel von Novi Corpus (auf der Seite des Anbieters erstellen)
  • Du brauchst einen Schlüssel von Novi Corpus (auf der Seite des Anbieters erstellen)

B · Andere in Recht & Behördendaten, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code · etwa 5 Min.

Du brauchst einen Schlüssel von Novi Corpus (auf der Seite des Anbieters erstellen)

  1. Bei Novi Corpus registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Novi Corpus öffnen ↗

  2. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  3. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user legal-body https://api.novicorpus.com/mcp --header 'Authorization: Bearer your-value'

    Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. /mcp in Claude Code eingeben

    Novi Corpus sollte in der Liste als verbunden erscheinen

  5. Ausprobieren

    Nutze Novi Corpus und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Novi Corpus nutzt, oder ein Werkzeug von Novi Corpus in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 5 Min.

Du brauchst einen Schlüssel von Novi Corpus (auf der Seite des Anbieters erstellen)

  1. Bei Novi Corpus registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Novi Corpus öffnen ↗

  2. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  3. Schlüssel eintragen

    In den Einstellungen von Novi Corpus ist Authorization leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. KI-Chat in Cursor im Agent-Modus öffnen

  5. Ausprobieren

    Nutze Novi Corpus und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Novi Corpus nutzt, oder ein Werkzeug von Novi Corpus in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 5 Min.

Du brauchst einen Schlüssel von Novi Corpus (auf der Seite des Anbieters erstellen)

  1. Bei Novi Corpus registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Novi Corpus öffnen ↗

  2. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  3. Schlüssel eintragen

    In den Einstellungen von Novi Corpus ist Authorization leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. KI-Chat in VS Code im Agent-Modus öffnen

  5. Ausprobieren

    Nutze Novi Corpus und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Novi Corpus nutzt, oder ein Werkzeug von Novi Corpus in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://api.novicorpus.com/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Novi Corpus nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user legal-body https://api.novicorpus.com/mcp --header 'Authorization: Bearer your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "legal-body": {
      "url": "https://api.novicorpus.com/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "legal-body": {
      "type": "http",
      "url": "https://api.novicorpus.com/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • Authorization geheim erforderlich HTTP header
    Bearer gefolgt von deinem Novi-Corpus-API-Schlüssel (mcp_...). Hol dir einen unter www.novicorpus.com/agents/connect
    Englisches Original anzeigenBearer followed by your Novi Corpus API key (mcp_...). Get one at www.novicorpus.com/agents/connect

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

GitHub-Sternei
4 (Sterne gehören zu einem anderen Repo)
Dieser Eintrag verweist auf das Repo einer anderen Person, daher zählen die Sterne nicht in Ranglisten
Downloads pro Wochei
Nicht auf npm/PyPI
Bestätigte Domain
✓ novicorpus.com
Lizenzi
Keine Lizenz angegeben
Verbindung
Läuft in der Cloud
Transport
streamable-http
Neueste Versioni
1.0.0
In der Registry veröffentlichti
13. Okt. 2026
Code zuletzt geänderti
19. Nov. 2026
Zuletzt geprüft
18. Nov. 2026
Entwickler
jb1011
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Der Server verlangt eine Anmeldung, bevor er seine Tools auflistet.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026

  • ! Vorsicht

    Entwickler passt zum Repo

    Der Herausgeber (novicorpus.com) ist nicht der Repo-Inhaber (jb1011); vielleicht hat jemand anderes ihn eingetragen

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: heute

  • ✕ Nicht bestanden

    Hat eine Lizenz

    Keine Lizenzdatei im Repo gefunden

  • ! Vorsicht

    Endpunkt antwortet

    Zugriff verweigert (HTTP 401) ohne OAuth-Anmeldung. Braucht vielleicht einen Schlüssel oder blockiert Bots; nicht bestätigt.

  • ! Vorsicht

    Anmeldung mit OAuth

    Braucht einen Schlüssel oder Token, den du selbst kopierst und einfügst

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Noch nicht geprüft; wir lesen die Tool-Liste, wenn wir den Endpunkt prüfen

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/novicorpus-legal-body.svg)](https://mcp.popnx.com/en/servers/novicorpus-legal-body)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Recht & Behördendateni

  • Mehr Sterne als 0 % der anderen 1948 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 45 % der anderen 1948 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 8 % der anderen 1948 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Novi Corpus sicher?

Er hat 1 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: Authorization

Läuft er auf meinem Computer oder in der Cloud?

Er läuft in der Cloud des Entwicklers. Du verbindest dich übers Internet, ohne etwas zu installieren, aber was du sendest, läuft über die Server des Entwicklers.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt heute geändert, und die neueste Version (1.0.0) kam vor 37 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Global law

The law of nearly every country on earth, any date: read it, see what changed it, check citations.

von lexifinaWeit verbreitet★ 2096Aktualisiert vor 9 Tagen

Läuft in der Cloud✓ lexifina.com

LibreJustice

Search French-language and European case law and French legal texts (codes, statutes, treaties).

von librejusticeAm Anfang★ 36Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · librejustice.fr

InfraNode

Keyless open data for 84 German cities: 12 lean read-only MCP tools covering 67 data types.

von street1983nkAm Anfang★ 18Aktualisiert vor 5 Monaten

Läuft in der Cloud✓ vom Dienst · infranode.dev

Fedlex Connector

Search Swiss federal legislation: laws, articles, amendments via the Fedlex SPARQL endpoint.

von JayTheSkierAm Anfang★ 8Aktualisiert vor 7 Monaten

Läuft in der Cloud✓ vom Dienst · fedlex-connector.ch
Im Vergleich mit ähnlichen
Dieser
Novi Corpus
Global lawOpen Legal Data (Germany)LibreJusticeInfraNodeFedlex Connector
Läuft woLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselJaNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinNein
Basisprüfungen1/54/44/44/44/44/4
Lizenz–NOASSERTIONMITApache-2.0Apache-2.0MIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

Agent Legal Body — Backend ("the brain")

Framework-agnostic TypeScript backend that onboards an AI agent into an on-chain legal body on Arc: generate operating agreement → register ERC-8004 identity → deploy + wire LegalManager + AgentTreasury via the Factory (one atomic tx) → bind the agent wallet → persist. CLI-driven, fully tested.

Prerequisites

  • Node >= 22, npm. Foundry (forge/anvil) on PATH for integration tests.
  • Contracts deployed to Arc testnet (see ../script/Deploy.s.sol and ../addresses.arc-testnet.json).

Setup

cp .env.example .env # fill PLATFORM_PRIVATE_KEY, FACTORY_ADDRESS, GUARDIAN_ADDRESS, OPERATOR_PRIVATE_KEY npm install npm run gen:abis # regenerate typed ABIs after any forge build

Test

npm test # unit + anvil integration (live tests skipped) ARC_E2E=1 npx vitest run test/e2e.arc.live.test.ts # live Arc testnet (spends USDC gas)

CLI

npm run cli -- create-entity --config agent.example.json --id agent-1 npm run cli -- create-entity --config agent.example.json --id agent-1 --fund 50.00 npm run cli -- get-entity agent-1 npm run cli -- list-entities npm run cli -- fund-treasury agent-1 25.00

Roles (v1)

  • manager = platform key (Factory owner; sends createEntity + setAgentWallet). PLATFORM_PRIVATE_KEY.
  • guardian = human registrant address (on-chain pause/veto/rescue). GUARDIAN_ADDRESS.
  • operator = the agent's spending key; signs the EIP-712 AgentWalletSet (bound as agentWallet). OPERATOR_PRIVATE_KEY in v1 (LocalKeySigner); a Turnkey enclave key in production (TurnkeySigner, M4.3).

The operator signs the bind; the manager sends the tx. The operator key never sends gas.

Live Arc-testnet E2E — runbook

  1. PLATFORM_PRIVATE_KEY must be the Factory owner key (createEntity is onlyOwner) and be funded with Arc-testnet USDC (USDC is the gas token on Arc). The deployed owner is recorded in ../addresses.arc-testnet.json; faucet: https://faucet.circle.com.
  2. OPERATOR_PRIVATE_KEY can be a throwaway — it only signs, never sends gas, never holds funds.
  3. GUARDIAN_ADDRESS is any address distinct from manager/operator.
  4. Run: ARC_E2E=1 npx vitest run test/e2e.arc.live.test.ts (optionally ARC_E2E_TAG= for a stable idempotency key). Asserts the entity reaches bound and getAgentWallet(agentId) == operator.

The off-chain EIP-712 domain + AgentWalletSet typehash are verified against the live registry, so the bind signature is correct by construction (no "bad signature" surprise).

Wizard REST API (npm run api, default :8789)

Multi-tenant onboarding API for the web wizard. Tenant = controller wallet (SIWE login).

Auth (SIWE → Bearer JWT)
  1. GET /auth/nonce → { nonce }
  2. Build an EIP-4361 message with the nonce, sign with the wallet.
  3. POST /auth/verify { message, signature } → { token, address, expiresAt }
  4. Send Authorization: Bearer on protected routes. Re-auth on expiry.
Config keys
KeyDefaultNotes
AUTH_JWT_SECRETdev-insecure-secret-change-me-pleaseMin 16 chars. Change in production.
AUTH_JWT_TTL_SEC3600JWT lifetime in seconds
WEB_ORIGIN*CORS allowed origin
SIWE_DOMAINlocalhostEIP-4361 domain
PASSKEY_RP_IDlocalhostWebAuthn RP ID
Endpoints
MethodPathAuthBody / Notes
GET/healthznoliveness
GET/schema/agent-spec.jsonnoJSON Schema for the onboard spec
GET/auth/nonceno{ nonce }
POST/auth/verifyno{ message, signature } → JWT
GET/passkey/challengeno{ challenge, rpId } for WebAuthn registration
POST/onboardyes{ spec, guardianPasskey, idempotencyKey? } → 202 { id, status }. guardian is forced to the caller.
GET/entitiesyestenant's EntityView[]
GET/entities/:idyesone EntityView (404 if not owned)
POST/entities/:id/fundyes{ amount } (atomic USDC) → 202 { id, status }

Poll GET /entities/:id (~2–3 s) until terminal status (bound / funded / failed).

MCP Server (Claude / Cursor)

The API (npm run api) also serves /mcp as a Model Context Protocol server, exposing agent onboarding and management tools to Claude/Cursor.

Setup
  1. Run the API (same server, no new service):
   npm run api  # listens on :8789
  1. Sign in (SIWE) and mint an MCP key:
  • GET /auth/nonce → { nonce }
  • Sign the message with your wallet
  • POST /auth/verify { message, signature } → { token, address, expiresAt }
  • POST /api-keys with Authorization: Bearer → { id, key, label } — copy the `key` (shown once)
  1. Capture the guardian passkey in your browser:
  • GET /passkey/challenge → { challenge, rpId } — use these for WebAuthn registration
  • Perform the WebAuthn ceremony in your browser
  • POST /passkey with Authorization: Bearer and the attestation → { id } — copy the `id` (handle)
  1. Add the server to Claude/Cursor: Create or edit ~/.claude/mcp.json (Claude CLI) or .cursor/rules/mcp.json (Cursor):
   {

"mcpServers": { "project-alpha": { "url": "https:// /mcp", "headers": { "Authorization": "Bearer mcp_ " } } } }

   Replace `<your-host>` with the deployed/local URL and `<your-key>` with the key from step 2.
Tools
ToolInputDescription
whoami(none)Return the authenticated tenant address
list_entities(none)List all agent legal bodies owned by the caller
get_entityid (idempotency key)Fetch one entity; poll after onboard_agent until status is bound
onboard_agentspec (object), passkeyId (handle from step 3), idempotencyKey? (optional)Create an agent legal body; guardian is automatically set to the caller
fund_treasuryid (idempotency key), amount (atomic USDC, 6 decimals as string)Fund a bound entity's treasury
Resources
ResourceURIDescription
agent-specschema://agent-specJSON Schema for onboard_agent's spec argument
Example Flow
  1. Read schema://agent-spec to understand the required entity structure
  2. Call onboard_agent with your agent spec and guardian passkey handle → returns { id, status: "pending" }
  3. Poll get_entity with the returned id (~2–3 s) until status reaches bound (or failed)
  4. Call fund_treasury with id and amount to top up the treasury (atomic USDC)
  5. Call list_entities to review all owned legal bodies

Hedera rail (ETHOnline 2026)

Novi Corpus adds a second, flag-gated payment rail on Hedera testnet, built for ETHGlobal ETHOnline 2026's "AI & Agentic Payments on Hedera" track. Where the Arc rail settles through Circle, the Hedera rail prices GET /verify/:publicId, a paid legal-standing check, in HTS USDC and settles it through x402 v2 and the Blocky402 facilitator. The Arc rail is untouched; with the flag off, nothing in this section exists at runtime.

Custody is self-custody with a leash. Your agent runtime holds its own Hedera key and signs every payment locally; the Novi Corpus server never holds or sees that key. A human guardian co-owns the float account through a 1-of-2 key list, so the guardian can rotate the agent key out at any time (revoke). The policy gate is enforced by the client and the float, not by the server: before paying, the client asks check_policy, and a deny stops the payment before anything is signed.

Enable it

Set HEDERA_ENABLED=1 and the rest of the block (the commented HEDERA_* lines in .env.example). The block is all-or-nothing: if any required variable is missing, the server refuses to boot rather than start half-configured.

VariableValueNotes
HEDERA_ENABLED1 or trueTurns the whole block on.
HEDERA_NETWORKtestnetThe only accepted value; this build is testnet only.
HEDERA_FACILITATOR_URLhttps://api.testnet.blocky402.comThe Blocky402 testnet facilitator.
HEDERA_MIRROR_URLhttps://testnet.mirrornode.hedera.comRead-only settlement confirmation.
HEDERA_USDC_TOKEN_ID0.0.429274HTS USDC, 6 decimals.
HEDERA_PAYTO_ACCOUNT_IDyour pay-to accountWhere /verify payments land. Must be associated with the USDC token.
HEDERA_VERIFY_PRICE_USDC0.001 (default)Price of one /verify call.
MCP tools (require an API key with the spend capability)
ToolInputDescription
link_hedera_accountid, accountId, publicKeyRecord the entity's float account. The server reads the account from the mirror node and accepts only a 1-of-2 key list of two ECDSA keys, one equal to publicKey; the other is recorded as the guardian key.
check_policyid, payee, amountUsdc, networkAnswer { ok: true, available } or { ok: false, reason } (paused, over-cap, not-linked, legal-not-active, and so on) from the float account's USDC balance, the entity's caps, the guardian pause on Arc and the payee allowlist. The allowlist is read live from Arc; an unreadable state never allows.
report_paymentid, payee, amountUsdc, network, transactionId, idempotencyKeyTurn a settled transaction into a ledger row. Answers { status: settled } only after the mirror node shows the USDC transfer on both legs; pending while the mirror node lags; failed with a reason otherwise.
How /verify is paid

GET /verify/:publicId is public and unauthenticated, but paid. The route answers GET only: any other method is refused with 405 and Allow: GET. A request without a payment header gets a 402 with the price and payment requirements in the PAYMENT-REQUIRED header. Your client signs a payment with its own Hedera key and resubmits; the facilitator verifies and settles the USDC transfer on Hedera testnet and pays the network fee, so the float account needs no HBAR. The route serves the attestation body (subject, standing, formation, controller flag, operating-agreement hash and version, issuedAt, expiresAt) once the facilitator's settle succeeds, and answers 402 with no body when it does not. Novi Corpus does not trust the facilitator's reply alone for its books: the ledger row is marked settled (network = hedera:testnet, batch_ref = ) only after your client's report_payment reads the transaction back from the mirror node with the USDC token pinned on both legs. With NOVI_ATTESTATION_KEY set the body is signed; see "Signed attestation".

Signed attestation (pull request 3)

When NOVI_ATTESTATION_KEY is set, the /verify body carries attestor (the key's address, also published as hedera.attestor in /metadata/:publicId) and an EIP-712 signature. Domain { name: "Novi Corpus Attestation", version: "1" }, no chain id, no verifying contract. One primary type, LegalBodyAttestation, with twelve fields in this order: publicId string, agentId string, treasury address, uaid string, standing string, formationStatus string, formationEnvironment string, humanVerified bool, oaHash bytes32, manifestVersion uint256, issuedAt uint256, expiresAt uint256. Every field is read from the served body.

What a verifier must know:

  • The signed timestamps are issuedAtUnix and expiresAtUnix (unix seconds). The ISO issuedAt and expiresAt strings are a convenience and are not signed; read the unix pair.
  • Null mapping, applied identically when signing and verifying: oaHash null → 0x + 64 zeros, manifestVersion null → 0, uaid null → "", agentId null → "", a null formation → "" for both

Nur der Anfang wird gezeigt; den Rest findest du im Repo