Quickstart · MCP

TIP

This walkthrough uses a plain API key, since that's what curl (and most scripts) need. Connecting a native MCP client with its own "Sign in" button instead (Claude.ai's remote-MCP connector)? Skip straight to MCP clients — no key required.

1. Get an API key

In the Vlozi Dashboard go to Settings → API Keys → Create new key. Grant the scopes you need (see Authentication for the full table) and copy the key — it starts with ls_ and shows once.

export VLOZI_API_KEY=ls_your_secret_here

WARNING

Treat the key like a password.

2. Check connectivity

curl https://mcp.vlozi.app/health

All env fields should be true.

3. List the tools your key can use

curl https://mcp.vlozi.app/tools \
  -H "Authorization: Bearer $VLOZI_API_KEY"

The response is filtered to what your key can call — drop a scope, lose a tool.

4. Call your first tool

curl -X POST https://mcp.vlozi.app/tools/blog.list_posts \
  -H "Authorization: Bearer $VLOZI_API_KEY" \
  -H "content-type: application/json" \
  -d '{"limit": 5}'

{
  "data": {
    "posts": [
      { "id": "post_xxx", "title": "Hello world", "slug": "hello-world", "status": "published", "tags": [...] }
    ],
    "pagination": { "page": 1, "limit": 5, "total": 1, "hasMore": false }
  }
}

5. Wire up a native MCP client

The same key drives the JSON-RPC endpoint at /mcp. For Claude Code:

claude mcp add --transport http vlozi https://mcp.vlozi.app/mcp \
  --header "Authorization: Bearer $VLOZI_API_KEY"

Configs for Claude Desktop, Cursor, Windsurf, Antigravity, Codex, Continue are on the MCP clients page — as is the OAuth "Sign in" flow for clients that support one instead of a pasted key.

Where to go next

Connect your agent — one-line setup for every popular MCP client
Agent recipes — drop-in skills: auto-publisher, Q&A bot, content pipeline
Tool reference — every tool's input/output shape