For builders

Publish your connector on the Orchard

Built a VGI worker? List it in the marketplace, set your pricing, and let teams discover and subscribe to it with one line of SQL.

How it works

From worker to listing in four steps

1

Build a VGI worker

Implement your connector as a VGI worker in any supported language. It exposes schemas, tables, and functions over the VGI protocol.

2

Describe your listing

Add a manifest: name, category, summary, the tables and functions you expose, an example query, and your pricing model.

3

Submit for review

We review the worker for correctness, security, and a clean schema. We test the attach flow and your example queries.

4

Publish & get paid

Once approved, your connector appears in the Orchard. Subscriptions are billed by Query.Farm and paid out to you on a revenue share.

Requirements

What a listing needs

  • A working VGI worker that runs as a hosted service.
  • A stable schema — tables and functions that won’t change without versioning.
  • Auth handled via DuckDB secrets / Orchard tokens, never hard-coded.
  • A runnable example query that returns rows.
  • Clear docs for each table, function, and required credential.

Revenue share

Query.Farm handles billing, credentials, and distribution. You keep a revenue share on every subscription — exact terms are set during onboarding while the Orchard is in preview.

Example listing manifest

orchard.toml
# orchard.toml — connector listing manifest (prototype)
id = "my-connector"
name = "My Connector"
category = "Streaming"
summary = "One-line description shown on the marketplace card."
language = "python"

pricing.model = "subscription"   # free | subscription | enterprise
pricing.note  = "From $49/mo"

[[offers]]
kind = "table"
name = "my.things"
description = "What this table contains."

[example]
sql = """
ATTACH 'my-connector' AS mc (TYPE vgi, LOCATION 'https://orchard.query.farm/my-connector', TOKEN getenv('ORCHARD_TOKEN'));
SELECT * FROM mc.things LIMIT 10;
"""

The manifest format is a prototype and will change as the Orchard matures.

Have a connector to share?

Tell us what you’ve built and we’ll help you get it listed on the Orchard.