---
title: "Conversion | OwlMeans"
description: "Beta. Preserve the original source and approve the proposed conversion stages and costs before proceeding."
url: "https://owlmeans.com/docs/mcp/reference/conversion/"
lang: "en"
---

# Conversion

![](https://owlmeans.com/_astro/mcp-reference-conversion.DOmVQDFj_Z3N2dq.webp)

Beta. Preserve the original source and approve the proposed conversion stages and costs before proceeding.

## Use these tools

1.  Call the relevant read or status tool first.
2.  Review the target and required arguments.
3.  Run one intended action, with explicit human confirmation where required.
4.  Inspect status or re-read the affected resource afterward.

Inputs below describe the public contract. Your connected server’s current tool list is authoritative. Some tools require a particular host, target, inference mode or plan. Identifiers are values returned by earlier tools; do not invent them.

## `check_convertible`

Can this application be converted.

Requires an existing intake project. Start convert\_project before checking a new source.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |

**Operation:** read-only.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `convert_project`

Convert an application you already have.

Starts or continues the supported intake. repoUrl takes precedence over the local workspace. Preserve original source and inspect conversion\_status.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |
| `name` | No | string |
| `about` | No | string |
| `repoUrl` | No | string |
| `branch` | No | string |
| `confirm` | Yes | boolean; default `false` |

**Operation:** can change state or start work.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `proceed_conversion`

Decide what a conversion does next.

Supported decisions include analyze, extract, implement, leave, retry and cancel. Follow the current stage; confirm only after reviewing scope and costs.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `decision` | Yes | `analyze`, `extract`, `implement`, `leave`, `retry`, `cancel` |
| `projectId` | No | string |
| `note` | No | string |
| `confirm` | Yes | boolean; default `false` |
| `name` | No | string; minLength 1; maxLength 128 |
| `description` | No | string |
| `specification` | No | string |
| `vision` | No | string |
| `designSystem` | No | string |

**Operation:** can change state or start work.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `conversion_status`

Where a conversion stands.

Read the returned resource and use its current values when planning the next action.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |

**Operation:** read-only.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `purge_origin`

Delete the converted original.

Irreversibly deletes the retained original. Confirm explicitly only after behavior, licenses and recovery needs have been reviewed.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |
| `confirm` | Yes | boolean |

**Operation:** can change state or start work; destructive effects are possible.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## Related reference

[MCP home](https://owlmeans.com/docs/mcp) · [Recovery workflow](https://owlmeans.com/docs/mcp/workflows/review-answer-questions-and-resume-development) · [Costs](https://owlmeans.com/docs/help/how-ai-work-and-inference-costs-are-calculated)
