# Developers — MakeFX by Make Effects

MakeFX is the CLI and technical surface for Make Effects. This page is the same-origin entrypoint to the public contracts, discovery documents, and operating guidance available to developers and agents.

Last updated: August 26, 2026

## REST API

- [OpenAPI document](https://makefx.app/api/openapi.json) is the canonical machine-readable REST contract.
- [API Catalog](https://makefx.app/.well-known/api-catalog) links the public REST and MCP service descriptions, documentation, and metadata.
- [API lifecycle policy](https://makefx.app/docs/api-lifecycle) explains REST v1 compatibility, version negotiation, deprecation signals, typed errors, and rate limits.

Use the OpenAPI document for current paths and schemas. The lifecycle policy owns compatibility expectations; copied endpoint lists do not.

## OAuth and protected-resource metadata

- [OAuth protected-resource metadata](https://makefx.app/.well-known/oauth-protected-resource) describes the MakeFX MCP resource, authorization servers, scopes, and policy links.
- [OAuth authorization-server metadata](https://makefx.app/.well-known/oauth-authorization-server) publishes authorization and token endpoints plus supported capabilities.
- [OpenID Connect metadata](https://makefx.app/.well-known/openid-configuration) provides the corresponding discovery document for compatible clients.

Clients should discover these documents at runtime instead of retaining endpoint or scope copies.

## MCP

- [Hosted MCP endpoint](https://makefx.app/mcp) is the canonical Streamable HTTP resource and requires OAuth.
- [MCP setup and agent guide](https://makefx.app/docs/mcp) explains connection, discovery, durable polling, recovery, and the shared product model.
- [Official MCP Registry record](https://registry.modelcontextprotocol.io/v0.1/servers/app.makefx%2Fmake-effects/versions/latest) publishes `app.makefx/make-effects`; its [same-origin manifest](https://makefx.app/server.json) stays available for direct discovery.

After connecting, use `tools/list` and the public model tools for the current typed contract. MCP operates on the same Spaces, Assets, Variants, Recipes, References, Collections, and permissions as the web app.

## MakeFX CLI

- [CLI documentation](https://makefx.app/docs/cli) covers installation, authentication, local files, JSON output, and command discovery.
- [makefx on npm](https://www.npmjs.com/package/makefx) is the published package. Install it with `npm install -g makefx`.
- [Machine-readable CLI contract](https://makefx.app/.well-known/makefx-cli-contract.json) provides stable discovery fields; live `makefx --help` owns commands and flags.

Use the CLI when work needs caller-local file upload or download. Use hosted MCP for structured remote operations.

## Documentation and policies

- [Documentation index](https://makefx.app/docs) lists every public guide; [Markdown](https://makefx.app/docs.md) is the agent-readable twin.
- [llms.txt](https://makefx.app/llms.txt) is the concise agent index, and [llms-full.txt](https://makefx.app/llms-full.txt) provides bounded operational context.
- [Privacy Policy](https://makefx.app/privacy) explains information handling and the authoritative privacy contact.
- [Terms of Service](https://makefx.app/terms) describes the rules for the website, app, CLI, MCP server, and related services.

Public HTML documents advertise their Markdown alternates. Live discovery contracts remain authoritative where commands, schemas, scopes, or service capabilities can change.