Skip to main content
Quilvo.
Start free

Developers - API & MCP

Developers building around writing progress.

Use the API and MCP in two clear ways: automate your own writing workflow, or build Quilvo into a third-party writing app so users can keep their project progress in sync.

Read API docs MCP guide Create an account

Personal automation

Connect your own writing workflow.

Use scripts, shortcuts, local tools, or AI assistants to update Quilvo when you finish writing.

  • Log word counts from a terminal command or desktop shortcut.
  • Let a local AI assistant update a project after a drafting session.
  • Sync progress from your own notebooks, folders, or writing setup.

Third-party app developers

Add Quilvo as a progress destination.

Writing apps can let users link a Quilvo project and send session updates automatically.

  • List projects so users can choose where progress should go.
  • Create projects for new manuscripts or documents.
  • Send session updates when words are added, cut, or synced.

Build with Quilvo

Project and session data that fits into real workflows.

01

Projects

List, read, create, and update projects so an integration can match local documents to Quilvo records.

02

Sessions

Log word count deltas or set a new project total while keeping a proper session history.

03

MCP

A focused remote MCP server lets AI assistants read project context and log sessions with the same scoped keys.

04

Scoped keys

Users create API keys with explicit abilities and optional expiry from their account settings.

05

Idempotency

Session writes support retry-safe keys, so a flaky network does not double-count progress.

Integration flow

Connect a writing tool to Quilvo in a few direct steps.

Users choose the abilities they want to grant, and integrations can log sessions for word count changes so Quilvo keeps an auditable writing history.

  1. 01

    Create a key

    A user generates a scoped API key from Settings > API Keys.

  2. 02

    Pick a project

    Your script or app lists projects and stores the selected Quilvo project ID.

  3. 03

    Log progress

    Send a session update when words are added, cut, or when your app knows the latest total.

curl -X POST https://quilvo.app/api/v1/sessions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: draft-session-2026-05-24" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "9b7d4f6a-...",
    "word_count_action": "add",
    "word_count": 750
  }'

Session logging

Update progress from any tool that can send JSON.

Keys can be short-lived or long-lived.

Abilities keep public access narrow.

Idempotency makes retries safe.

The API is plain JSON over HTTPS.

MCP gives assistants a narrow tool surface.