# Genvernium developer resources

# Genvernium

> Genvernium helps businesses monitor approved websites, surface source-linked SEO and GEO findings, and prepare drafts for human review.

## What Genvernium does

- Monitors an approved website and organises source-linked evidence.
- Surfaces SEO and GEO visibility findings with supporting context.
- Prepares reviewable recommendations and drafts for a customer workspace.

## When to use this

- Use it when a business needs traceable website findings and a reviewable next step.
- Use it when the team needs evidence and context kept together across a workspace.
- Review the underlying evidence before relying on an automated finding or recommendation.

Reach for Genvernium when an agent needs bounded website visibility evidence, source-linked findings, or a human-reviewed next step for a business website.

## API reliability and versioning

- The public discovery surface is read-only and returns JSON errors with `code`, `message`, `status`, and `resolution` fields when a request cannot be served.
- Authenticated workspace write requests use an `Idempotency-Key`; long-running analysis work is queued with durable status and requires a customer session.
- `/api/v1` is the versioned workspace boundary. Breaking changes use a new major path; deprecations are announced with `Deprecation` and `Sunset` headers before removal.

## Operating boundaries

- Genvernium does not silently publish website changes or send external communications.
- External actions require the applicable customer authorisation and an auditable approval.
- Results can be incomplete, stale, or incorrect; they are decision-support information, not a guarantee of rankings, citations, traffic, or revenue.
- Do not submit passwords, private keys, API tokens, payment-card data, or other secrets.

## Agent onboarding

- Self-serve API key generation for agents: POST https://genvernium.com/api/v1/onboarding; returns a short-lived sandbox-only onboarding token with scope sandbox.read and no customer workspace access.
- Sandbox/test environment: GET https://genvernium.com/api/v1/sandbox; deterministic synthetic read-only fixture.
- Zero-auth access: the sandbox and public discovery resources require no API key, OAuth token, account, or payment.

## Public resources

- [Genvernium](https://genvernium.com/): Product overview, workflow, FAQs, and pricing.
- [About](https://genvernium.com/about): Product purpose, review boundaries, and company context.
- [Contact](https://genvernium.com/contact): Verified support contact details.
- [Developer resources](https://genvernium.com/developers): Public integration and discovery guidance.
- [NPM SDK and CLI](https://www.npmjs.com/package/@genvernium/sdk): @genvernium/sdk@0.1.1; install with `npm install @genvernium/sdk`; CLI `npx --package @genvernium/sdk genvernium --help`.
- [PyPI SDK and CLI](https://pypi.org/project/genvernium-sdk/): genvernium-sdk==0.1.0; install with `pip install genvernium-sdk`, then run `genvernium --help`.
- [Genvernium on Smithery](https://smithery.ai/servers/alwaysrememberme1024/genvernium): Published public MCP listing for agent discovery.
- [OpenAPI discovery document](https://genvernium.com/openapi.json): Machine-readable public, read-only resources.
- [Terms of Service](https://genvernium.com/legal/terms): Service terms.
- [Privacy Notice](https://genvernium.com/legal/privacy): Privacy and data-processing information.
- [AI Disclosure](https://genvernium.com/legal/ai-disclosure): Automated analysis and AI-assisted workflow boundaries.
- [Acceptable Use Policy](https://genvernium.com/legal/acceptable-use): Permitted and prohibited use.
- [Agent Plugin manifest](https://genvernium.com/plugin.json): Standard manifest for the public read-only discovery components.
- [Workspace MCP server card](https://genvernium.com/.well-known/mcp/product-server-card.json): Authenticated, read-only product MCP tools.
- [Public sandbox](https://genvernium.com/sandbox): Deterministic, read-only integration fixtures.
- [Agent onboarding contract](https://genvernium.com/api/v1/onboarding): Self-serve sandbox onboarding, zero-auth access, and workspace boundary details.
- [Batch discovery API](https://genvernium.com/api/v1/batch): Bounded batch lookup of public resource descriptors.