Agent Platform

The Elven Agent Platform is a set of programmatic surfaces for managing a creator account — listings, posts, drops, follows, analytics, and publishing — without touching the web UI.

Three packages, one core:

Package	npm	What it is
@elvenvtt/api	0.7.1	Typed REST client. Zero deps. Node, Bun, Deno, browser, edge.
@elvenvtt/cli	0.7.1	The elven command-line tool. Browser-OAuth + PAT login, multi-account, one-command elven publish.
@elvenvtt/mcp-account	0.7.1	MCP server for AI agents — stdio for local agents (Claude Code, Cursor) and hosted HTTP at mcp.elvenvtt.com/mcp for cloud agents.

All three share one core. Adding a new verb means adding it once in @elvenvtt/api and surfacing it in the other two.

Source for all three lives at github.com/aoatkinson/elven-sdk. MIT licensed.

Who this is for

• Creators who live in terminals. Publishing a companion via elven publish from a project directory takes one command instead of clicking through the web UI.
• CI / GitHub Actions. Auto-publish a companion on every push to main. See Publishing → GitHub Actions.
• AI-augmented creators. Tell Claude "publish my Lancer companion" or "show last month's sales" and it calls the right verbs via the MCP server. See MCP Setup.
• Custom tooling. The @elvenvtt/api package gives you a typed client for scripting anything Elven from your own code.

What's NOT in this section

The agent-platform pages cover creator account management — what an account owner can do programmatically. For:

• Connecting an AI agent to a live game session (controlling actors, spawning creatures, casting spells) — that's a different MCP server tied to a specific table (sync.elvenvtt.com/mcp/{sessionId}). Docs for that flow are being rewritten.
• Plugin development (extending the game engine itself) — docs for the plugin SDK are being rewritten.

Quick path

npm install -g @elvenvtt/cli
elven login
elven listing mine

Then either drop into a companion project and run elven publish, or wire up an AI agent — see the CLI Quick Start or MCP Setup.