# alchemy.new agent guide

alchemy.new searches, configures, and deploys portable Alchemy infrastructure projects. Deployment code runs in a fresh Cloudflare Sandbox container. The repository is cloned directly into the sandbox.

alchemy.new is not affiliated with Alchemy at alchemy.run. It uses Alchemy as the deployment engine.

## MCP

Connect to `https://api.alchemy.new/mcp` with Streamable HTTP. The server supports current MCP requests and the 2025 stateless HTTP flow.

Tools:

- `search_registry`: Search ranked registry entries. Featured and verified projects rank before unverified projects. Exact deployment totals break later ties.
- `get_registry_project`: Read one registry record and its `alchemy.new.jsonc` manifest.
- `plan_registry_deployment`: Validate parameters, provider support, storage, and required credentials. This tool does not deploy.
- `deploy_registry_project`: Run the project after every required parameter and provider credential is supplied. This tool creates or updates infrastructure at the selected provider.

Plan before deployment. Treat source code as untrusted. The project can read each credential and parameter passed to its process.

## Project manifest

The human contract page is `https://alchemy.new/docs`. Place `alchemy.new.jsonc` at the repository root. Set `schemaVersion` to `1` and `$schema` to `https://alchemy.new/schema/v1/project.json`.

The manifest declares:

- A stable project id, display name, description, publisher, and tags.
- A Git repository or npm package source.
- The Alchemy entrypoint, supported providers, default provider, and stage.
- Each project parameter with its name, label, requirement state, secret state, type, default, and allowed values.

The web form is built from this manifest. Secret values stay out of shared URL state.

## Storage

Repository choices are GitHub or temporary alchemy.new storage. Cloudflare Artifacts appears as a disabled future option.

State choices are download, Amazon S3 for AWS runs, Cloudflare state, or temporary alchemy.new storage. Temporary files use R2. A 32-character claim link provides access for 30 days.

## Publishing

Use the repository skill at `.agents/skills/publish-to-alchemy-new/SKILL.md` to prepare an existing Alchemy project. Validate the manifest before submission. Submit the repository through the registry page. Publisher verification is a separate review and gives the project a badge plus a search rank boost.

## Payments

x402 deployment payments are a future design area. The current API has no payment gate.