explaingit

asyntheticai/asynthetic

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

An MCP server that gives AI coding agents verified, cited migration guides for exactly what breaks when a library is upgraded between versions.

Mindmap

mindmap
  root((repo))
    What it does
      Verified migration maps
      Breaking change lookups
      Cited official sources
    Tech stack
      TypeScript
      MCP server
      Supabase
    Tools
      get_migration
      get_breaking_changes
      check_peer_compatibility
    Coverage
      Next.js 14 to 15
      AI SDK 4 to 5
    Audience
      AI coding agents
      Developers upgrading libraries

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Give an AI coding agent accurate breaking change data before it upgrades a library.

USE CASE 2

Check if two package versions are compatible before combining them in a project.

USE CASE 3

Look up exactly what changed between Next.js 14 and 15 or AI SDK 4 and 5.

What is it built with?

TypeScriptMCPZodSupabasePostgres

How does it compare?

asyntheticai/asynthetic0xkinno/astraea0xkinno/halcyon
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardhard
Complexity2/54/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Hosted endpoint needs one MCP add command, self hosting with Postgres needs Supabase credentials.

Free to self host for your own use, but you cannot resell it as a competing hosted service, converts to Apache 2.0 in 2030.

In plain English

Asynthetic is a tool that gives AI coding agents accurate, up to date information about how software libraries have changed between versions. AI models are trained on data with a cutoff date, so when they try to help you upgrade a library, they sometimes write code using old syntax that no longer works, or miss a change that quietly breaks your build without any error. Asynthetic tries to fix that specific problem. It works as an MCP server, a kind of plugin that AI coding assistants like Claude Code, Cursor, or Windsurf can connect to. Once connected, the agent can ask a tool called get_migration for a specific package and version range, and Asynthetic replies with a list of breaking changes for that upgrade, each one showing the old code, the new code, and a link to the official source that documented the change. It currently covers two library upgrades in depth: Next.js from version 14 to 15, and the AI SDK from version 4 to 5, with about 40 breaking changes cataloged across both. Each answer also reports a confidence level such as high, medium, or low, depending on whether the change has actually been tested on a real build rather than just read from documentation. If Asynthetic has no information about a particular upgrade, it says so directly rather than guessing, which the README treats as a core design rule: a wrong answer is worse than no answer. You can use the hosted version with one command, or run it locally and offline using npx, or clone the project and self host it with your own Postgres database through Supabase. The project is written in TypeScript and is source available under the BSL 1.1 license, meaning you can self host it freely but cannot resell it as a competing hosted service. That license is set to convert automatically to the Apache 2.0 license in 2030. It is currently a free public beta.

Copy-paste prompts

Prompt 1
Connect Asynthetic to Claude Code and use it to check what breaks upgrading AI SDK 4 to 5.
Prompt 2
Explain how Asynthetic decides whether a migration entry gets a high, medium, or low verification level.
Prompt 3
Show me how to self host Asynthetic with my own Supabase database instead of the hosted endpoint.
Prompt 4
Walk me through the get_migration and check_peer_compatibility tools this server exposes.

Frequently asked questions

What is asynthetic?

An MCP server that gives AI coding agents verified, cited migration guides for exactly what breaks when a library is upgraded between versions.

What language is asynthetic written in?

Mainly TypeScript. The stack also includes TypeScript, MCP, Zod.

What license does asynthetic use?

Free to self host for your own use, but you cannot resell it as a competing hosted service, converts to Apache 2.0 in 2030.

How hard is asynthetic to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is asynthetic for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.