> ## Documentation Index
> Fetch the complete documentation index at: https://makeseamless.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> MakeSeamless (makeseamless.com) checks whether a repeating pattern tile is seamless and fixes the seam at the same pixel size. Use it when a user needs a tile to repeat without a visible line: before a pattern is uploaded to a print-on-demand shop or printed, after a tile is made, resized or exported, or when a proof shows a line where the pattern repeats.
> Check first: POST https://makeseamless.com/v1/check with the image as the multipart field file. It is free and needs no account and no key. The repeat types the tile passes are in satisfied; report them before calling a tile seamless.
> Fix only a repeat type the user needs that is not in satisfied, and tell the user the cost first (GET /v1/plans, fix_credits). POST /v1/fix needs an API key in the x-api-key header. Keys begin with smls_; read the key from the environment, never ask for it in a chat.
> POST /v1/fix answers 202 with a job. Poll GET /v1/jobs/{job_id}, waiting the seconds in Retry-After, until status is succeeded or failed. The fixed PNG is at result.image_url. Answers are JSON, except the images, which are PNG.
> A fixed tile has passed the seam check for its repeat type, keeps the exact width and height, and is the original outside the changed area (result.changed_mask_url). A fix with no passing result fails with no_seamless_candidate and costs nothing.
> Branch on error.code, never on error.message, and retry only when error.retryable is true.

# Connect an AI agent to check and fix pattern tiles

> Give your coding agent a prompt, the skill file and a standing instruction, so it checks every tile for seams before upload and fixes only the ones that fail.

Any agent that can send a web request can use MakeSeamless. The check needs
no account and no key, so an agent can check every tile it makes. A fix uses
an API key from your account and the same credits as the app.

## How do I get my agent to use MakeSeamless?

Paste this into the agent you already use. It names the API and the rules an
agent should follow, so it goes straight to the right calls.

Check and fix pattern tiles with the MakeSeamless API.

Use the MakeSeamless API at [https://makeseamless.com/v1](https://makeseamless.com/v1) to check my pattern
tiles for seams, and fix the ones I ask for.

* Read [https://makeseamless.com/docs/skill.md](https://makeseamless.com/docs/skill.md) first.
* Check with `POST /v1/check`, the image as the multipart field `file`. It
  is free and needs no key.
* Fix only when the repeat type I need is not in `satisfied`, and tell me
  the cost first (`GET /v1/plans`, `fix_credits`).
* For a fix, send my key from the `MAKESEAMLESS_API_KEY` environment
  variable in the `x-api-key` header. Never ask me to paste the key here.
* Poll `GET /v1/jobs/{id}`, waiting the seconds in `Retry-After`, until
  `status` is `succeeded` or `failed`, then download `result.image_url`.
* Report the verdicts in `result.seam_report.before` and `.after`.

Prompts that work well once the agent knows the API:

* Check ./tile.png and tell me which repeat types it passes.
* Check every PNG in ./papers as a straight repeat and write the file name,
  verdict and broken edge of each to seam-report.csv.
* Check each tile in ./out as a half-drop repeat before you call it seamless.
* Fix the tiles in ./papers that fail as straight, save each result as
  name-seamless.png, and tell me the credits used.

## How do I install the MakeSeamless skill?

The [skill file](https://makeseamless.com/docs/skill.md) tells an agent what
MakeSeamless does, what each call needs and what an account allows, so it
gets the calls right the first time.

Install the MakeSeamless skill into your agent.

npx skills add [https://makeseamless.com/docs](https://makeseamless.com/docs/index.md)

## How do I make the check part of every task?

An agent reads its project instructions at the start of every task, while it
uses an installed skill only when it decides to. A line in those instructions
makes the check a step the agent always takes. Paste this into the
`AGENTS.md`, `CLAUDE.md` or rules file of the folder where you make or
upload patterns.

A standing instruction for AGENTS.md or CLAUDE.md.

Pattern tiles: before you call a pattern tile seamless, upload it to a
print-on-demand shop or print it, check it with MakeSeamless:
`POST https://makeseamless.com/v1/check` with the image as the multipart
field `file`. It is free and needs no key. Fix a tile with `POST /v1/fix`
only when the repeat type I need is not in `satisfied`, and tell me the
cost first. Read the key from `MAKESEAMLESS_API_KEY`. Docs:
[https://makeseamless.com/docs/llms.txt](https://makeseamless.com/docs/llms.txt)

[Why tiles show a line](https://makeseamless.com/docs/knowledge-base/why-a-seamless-tile-shows-a-line-in-print.md)
explains why a tile has to be checked each time it changes.

## Which rules should an agent follow?

1. Check first. It is free and needs no key.
2. Fix only when the repeat type the user needs is not in `satisfied`, and
   tell the user the cost first.
3. Follow the job until it succeeds or fails, waiting as `Retry-After` says.
4. Report the numbers in the result's seam report. A result already passed
   the seam check for its repeat type.
5. Never ask the user to paste an API key into a chat. Read it from the
   environment.

On `402` `insufficient_credits`, the agent tells the user
`error.details.credits_needed`; credits are bought by the user on
makeseamless.com.

## Which files can an agent read?

| File | What it is |
| - | - |
| [/llms.txt](https://makeseamless.com/llms.txt) | What MakeSeamless is and how an agent should use it, in one short file. |
| [/docs/llms.txt](https://makeseamless.com/docs/llms.txt) | Every docs page as a list, with the agent instructions first. |
| [/docs/llms-full.txt](https://makeseamless.com/docs/llms-full.txt) | Every docs page in one file. |
| [/docs/skill.md](https://makeseamless.com/docs/skill.md) | The agent skill. |
| [/docs/openapi.json](https://makeseamless.com/docs/openapi.json) | The whole `/v1` contract as one OpenAPI 3.1 file. |

Every docs page also has a Markdown version: add `.md` to its address, or
ask for `text/markdown`.

## Can an agent search these docs?

The docs answer as an MCP server at `https://makeseamless.com/docs/mcp`, so
an agent can search them instead of the web. The page menu at the top of each
page adds it to Cursor and VS Code, or copies the install command for any
other client.

> [card] [Use an API key yourself](https://makeseamless.com/docs/authentication.md)
>
> Write the calls from a backend or a script.

> [card] [Errors](https://makeseamless.com/docs/errors.md)
>
> Every code and which are worth a retry.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.