ViewertViewert
API Reference

Build with theViewert API

Inject your Libram context into any AI tool, app, or workflow. The context API is live today — no waitlist.

Context API — Live
MCP Server — Live

No SDK required

A single curl call returns clean Markdown. Paste it anywhere.

API key auth

Bearer token auth. Create and revoke keys in Settings.

Markdown or JSON

Get context as a single Markdown doc or structured JSON.

Public & private

Public Librams need no auth. Private ones require your key.

Quick Start

Two steps: get a key, fetch your Libram context.

Base URL
https://www.viewert.com/api
Authentication
Authorization: Bearer vwt_your_key_here
Fetch your Libram context (macOS / Linux)
$ curl -H "Authorization: Bearer vwt_your_key_here" \
  "https://www.viewert.com/api/librams/YOUR_LIBRAM_ID/context"
Fetch your Libram context (Windows PowerShell)
PS> Invoke-RestMethod -Headers @{Authorization="Bearer vwt_your_key_here"}
  "https://www.viewert.com/api/librams/YOUR_LIBRAM_ID/context"
Response — Markdown (default)
# My Coding Style

Always prefer explicit types over any...

---

# Project Conventions

Use ULID for all IDs...
Response — JSON (?format=json)
{
  "libram_id": "01J...",
  "libram_name": "My Coding Style",
  "vellums": [
    {
      "id": "01J...",
      "title": "My Coding Style",
      "markdown": "..."
    }
  ]
}

Live Endpoints

Live

Available now. No waitlist.

GET/api/librams
Auth required
GET/api/librams/:id/context
Public Librams: no auth
GET/api/librams/:id/context?format=json
Public Librams: no auth

MCP Server

Live

Connect Claude Desktop, Cursor, and Windsurf to your Librams with zero manual prompting.

list_librams
Inputsnone
ReturnsArray of { id, name, description, vellum_count, visibility }
NoteCalled automatically when you ask Claude "what librams do I have?"
get_libram_context
Inputslibram_id (required), libram_name (optional)
ReturnsFull Markdown context of all AI-enabled Vellums in the Libram
NoteCalled automatically when you ask Claude to "load my X libram"

Install and configure in one command (requires Node.js 18+):

Setup wizard
npx -y @viewert/mcp

Errors

401UnauthorizedMissing or malformed API key.
403ForbiddenKey is valid but you do not own this resource.
404Not FoundLibram does not exist, or is private and you are not the owner.
429Too Many RequestsRate limit hit. Slow down and retry.

All error responses are JSON: { "error": "message" }

Coming Soon

Coming soon

Full read/write access to Vellums, users, and search.

GET/api/vellums
GET/api/vellums/:id
POST/api/vellums
GET/api/users/:username
GET/api/search

Start building today

The context API is live. Create a free account, build a Libram, and start injecting your knowledge into any AI tool in minutes.