Getting Started

Itabyrium is the agent gateway to Fucina Nexus Foundation’s sovereign infrastructure — 7 Nexi, 64 endpoints, one protocol stack.

This guide will walk you through discovering available endpoints, authenticating with a DID, and invoking your first Nexus skill.

Prerequisites

A DID (Decentralized Identifier) — did:key, did:web, did:ethr, or did:pkh
An HTTP client or MCP-compatible agent

Quick Start

1. Discover the Registry

curl https://itabyrium.tech/.well-known/mcp.json

This returns the MCP server manifest with all available capabilities.

2. Explore Available Endpoints

curl -H "Accept: application/json" https://itabyrium.tech/discover

3. Authenticate

const auth = await fetch("https://itabyrium.tech/auth", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    did: "did:key:z6Mk...",
    challenge_response: signedChallenge
  })
});
// Returns: { jwt, auth_level, capabilities }

4. Invoke an Endpoint

const result = await fetch("https://itabyrium.tech/api/nexus1/evaluate_founder", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${jwt}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    founder_did: "did:key:z6Mk...",
    venture_type: "defi"
  })
});

Comprehensive getting started guide coming in Q2 2026 alongside Layer 1 launch.