Migration

Migrate from Scalar to Sourced: OpenAPI launch checklist

Scalar is one of the stronger modern OpenAPI docs tools. It has a polished API reference, hosted docs, an API client, MCP and SDK direction, and a generous free docs story. A migration to Sourced only makes sense when you want the same OpenAPI input to produce docs, SDK previews, package-readiness checks, and launch approvals in one place.

This is not a "Scalar is bad" page. It is a "which workflow do you need?" page.

When Sourced is the better fit

Use Sourced when:

  • TypeScript and Python SDK previews matter as much as docs.
  • npm and PyPI readiness need to be part of the release checklist.
  • You want free noindex docs review sites before production.
  • You want custom-domain publishing to stay approval-gated.
  • You want an agent-readable llms.txt, Markdown output, and MCP starter work tied to the same OpenAPI source.

Stay with Scalar if the priority is the interactive OpenAPI reference itself, public API client experience, or Scalar's hosted docs workflow.

What to inventory in Scalar

Collect:

  • OpenAPI source and any transformed output
  • Scalar config
  • docs navigation
  • custom domain settings
  • SDK generation settings or language add-ons
  • MCP server settings
  • guide pages and MDX/Markdown source
  • analytics and search settings
  • redirects
  • theme customizations

As of August 31, 2026, Scalar's official pricing includes free hosted OpenAPI docs, a paid Pro plan, and SDK language add-ons. Sourced's comparison point is different: free previews plus up to 2 hosted noindex docs review sites, then $99/month per API project for Launch.

Scale is $349/month and adds more API projects, more hosted docs sites, more team capacity, and production custom domains.

Hard part: API client behavior

Scalar's public API client can be part of the developer experience, not just the docs UI. Before migrating, decide whether Sourced needs to reproduce that behavior or whether the docs and SDK workflow is the actual requirement. If customers rely on trying requests directly in the docs, QA auth, examples, base URLs, and failure states before cutover.

Migration steps

  1. Export the exact OpenAPI spec Scalar is rendering.
  2. Upload that file to Sourced.
  3. Generate docs and compare endpoint coverage.
  4. Generate TypeScript and Python SDK previews.
  5. Review package metadata, install snippets, auth examples, and README content.
  6. Generate or review MCP starter output from the same spec.
  7. Build a redirect map if production docs routes will change.
  8. Keep preview docs noindex.
  9. Approve custom-domain cutover only when the docs are ready for search.

Watch the SDK add-on math

SDK pricing can look cheap or expensive depending on what is included. Normalize the comparison:

Question Why it matters
How many live SDK languages? Per-language pricing can move quickly as you add targets.
Are docs included? Some tools price docs and SDKs separately.
Is publishing included? A generated SDK is not the same as a release-ready npm/PyPI package.
Are previews free? You should be able to review output before paying.
Is custom domain production or preview? Search indexing belongs only on the production docs host.

For Sourced, the current default is simple: free evaluation, then Launch at $99/month per API project when production publishing starts. Scale is $349/month when you need more API projects, hosted docs sites, custom domains, and team capacity.

Prompt for an AI agent

Migrate our Scalar OpenAPI docs and API-interface workflow to Sourced.
Inventory OpenAPI source, Scalar config, docs navigation, custom domains, SDK language settings, MCP settings, guides, analytics, search, redirects, and theme customizations.
Generate Sourced docs, TypeScript SDK, Python SDK, llms.txt, MCP starter, and npm/PyPI readiness previews.
Compare route coverage, examples, SDK method names, package metadata, auth setup, sitemap, and noindex/index behavior.
Do not change DNS, publish packages, or make previews indexable without explicit approval.

Bottom line

Migrate from Scalar to Sourced if you want docs plus SDK release readiness from one OpenAPI workflow. Stay with Scalar if the public API reference and hosted docs experience are the core product you need.

Start free, compare Scalar pricing, or read the OpenAPI-to-MCP guide.