Atelier
Search and license original photographs for personal or commercial use, as screen and print files.
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"store": {
"url": "https://store.atelierphotos.app/api/mcp"
}
}
}リモートエンドポイント
https://store.atelierphotos.app/api/mcpstreamable-httpできること
ツール一覧
ツール（10）
🟢search_images(query, orientation, target_width, target_height, collection_id, ...)
Find images for sale by description, mood, colour or subject — a plain description of the feeling or scene works as well as a keyword, so pass what the person actually said. Give target_width and target_height when the image is destined for a specific screen — results are then ranked by how close each frame is to that shape, and frames whose shape is badly wrong for it (a landscape frame for a phone) are left out. Images are sold as the photographer framed them, never cropped. Returns a preview of each image. Use get_image for one listing you already have the id of; use list_collections to browse rather than search.
入力スキーマ
{
"type": "object",
"properties": {
"query": {
"description": "Free text: subject, mood, colour, setting.",
"type": "string"
},
"orientation": {
"type": "string",
"enum": [
"landscape",
"portrait",
"square"
]
},
"target_width": {
"description": "Destination width in pixels, e.g. 1290 for an iPhone. Give both or neither.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"target_height": {
"description": "Destination height in pixels, e.g. 2796. Give both or neither.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"collection_id": {
"description": "Restrict to one collection from list_collections.",
"type": "string"
},
"licence": {
"description": "\"commercial\" for only the images that can be licensed for business use. Every image has the personal license.",
"type": "string",
"enum": [
"personal",
"commercial"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"cursor": {
"description": "next_cursor from the previous page, unchanged, with the same query and filters. Cannot be combined with target_width/target_height.",
"type": "string"
},
"include_previews": {
"description": "Set false for metadata only, which is much cheaper.",
"type": "boolean"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"listing_id": {
"type": "string"
},
"headline": {
"type": [
"string",
"null"
]
},
"title": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"keywords": {
"type": "array",
"items": {
"type": "string"
}
},
"orientation": {
"type": "string"
},
"aspect_ratio": {
"type": "string"
},
"pixels": {
"anyOf": [
{
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"width",
"height"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"collection": {
"type": "object",
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"title"
],
"additionalProperties": false
},
"photographer": {
"type": "string"
},
"preview_url": {
"type": [
"string",
"null"
]
},
"price": {
"type": "object",
"properties": {
"credits": {
"type": "number"
},
"cents": {
"type": "number"
},
"currency": {
"type": "string"
},
"trial_credits_accepted": {
"type": "boolean"
},
"card_available": {
"type": "boolean"
},
"commercial": {
"anyOf": [
{
"type": "object",
"properties": {
"cents": {
"type": "number"
},
"currency": {
"type": "string"
}
},
"required": [
"cents",
"currency"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"credits",
"cents",
"currency",
"trial_credits_accepted",
"card_available",
"commercial"
],
"additionalProperties": false
},
"licence": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"version": {
"type": "number"
}
},
"required": [
"code",
"version"
],
"additionalProperties": false
},
"shape_fit": {
"type": "object",
"properties": {
"score": {
"type": "number"
},
"target": {
"type": "string"
}
},
"required": [
"score",
"target"
],
"additionalProperties": false
},
"match": {
"type": "string",
"enum": [
"keyword",
"semantic",
"semantic_weak"
]
},
"owned": {
"type": "boolean"
},
"owned_licences": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"listing_id",
"headline",
"title",
"description",
"keywords",
"orientation",
"aspect_ratio",
"pixels",
"collection",
"photographer",
"preview_url",
"price",
"licence"
],
"additionalProperties": false
}
},
"next_cursor": {
"type": [
"string",
"null"
]
}
},
"required": [
"results",
"next_cursor"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_image(listing_id)
Everything known about a single listing: its description, keywords, price in credits and money, the license it sells under, and a preview. Use after search_images when the person wants a closer look at one option.
入力スキーマ
{
"type": "object",
"properties": {
"listing_id": {
"type": "string"
}
},
"required": [
"listing_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"listing_id": {
"type": "string"
},
"headline": {
"type": [
"string",
"null"
]
},
"title": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"keywords": {
"type": "array",
"items": {
"type": "string"
}
},
"orientation": {
"type": "string"
},
"aspect_ratio": {
"type": "string"
},
"pixels": {
"anyOf": [
{
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"width",
"height"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"collection": {
"type": "object",
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"title"
],
"additionalProperties": false
},
"photographer": {
"type": "string"
},
"preview_url": {
"type": [
"string",
"null"
]
},
"price": {
"type": "object",
"properties": {
"credits": {
"type": "number"
},
"cents": {
"type": "number"
},
"currency": {
"type": "string"
},
"trial_credits_accepted": {
"type": "boolean"
},
"card_available": {
"type": "boolean"
},
"commercial": {
"anyOf": [
{
"type": "object",
"properties": {
"cents": {
"type": "number"
},
"currency": {
"type": "string"
}
},
"required": [
"cents",
"currency"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"credits",
"cents",
"currency",
"trial_credits_accepted",
"card_available",
"commercial"
],
"additionalProperties": false
},
"licence": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"version": {
"type": "number"
}
},
"required": [
"code",
"version"
],
"additionalProperties": false
},
"shape_fit": {
"type": "object",
"properties": {
"score": {
"type": "number"
},
"target": {
"type": "string"
}
},
"required": [
"score",
"target"
],
"additionalProperties": false
},
"match": {
"type": "string",
"enum": [
"keyword",
"semantic",
"semantic_weak"
]
},
"owned": {
"type": "boolean"
},
"owned_licences": {
"type": "array",
"items": {
"type": "string"
}
},
"licence_summary": {
"anyOf": [
{
"type": "object",
"properties": {
"code": {
"type": "string"
},
"version": {
"type": "number"
},
"name": {
"type": "string"
},
"summary": {
"type": "string"
},
"permitted": {
"type": "array",
"items": {
"type": "string"
}
},
"prohibited": {
"type": "array",
"items": {
"type": "string"
}
},
"effective_from": {
"type": "number"
}
},
"required": [
"code",
"version",
"name",
"summary",
"permitted",
"prohibited",
"effective_from"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"listing_id",
"headline",
"title",
"description",
"keywords",
"orientation",
"aspect_ratio",
"pixels",
"collection",
"photographer",
"preview_url",
"price",
"licence",
"licence_summary"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_collections
The collections available in the store, with how many images are in each. Use for browsing when there is no particular search in mind; prefer search_images when the person has described what they want.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"collections": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"listing_count": {
"type": "number"
}
},
"required": [
"id",
"title",
"description",
"listing_count"
],
"additionalProperties": false
}
}
},
"required": [
"collections"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_licence(code, version)
The full terms an image is sold under: what the buyer may and may not do with it. Read this before recommending a purchase, and whenever the person asks what they are allowed to do with an image. "personal" (the default) is what credits and a card one-off buy; "commercial" is the business licence, sold by card where price.commercial is offered.
入力スキーマ
{
"type": "object",
"properties": {
"code": {
"description": "One of: personal, commercial. Omit for personal.",
"type": "string"
},
"version": {
"description": "Omit for the terms currently on offer. Pass a version to read what was sold earlier.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"code": {
"type": "string"
},
"version": {
"type": "number"
},
"name": {
"type": "string"
},
"summary": {
"type": "string"
},
"permitted": {
"type": "array",
"items": {
"type": "string"
}
},
"prohibited": {
"type": "array",
"items": {
"type": "string"
}
},
"effective_from": {
"type": "number"
},
"terms": {
"type": "string"
}
},
"required": [
"code",
"version",
"name",
"summary",
"permitted",
"prohibited",
"effective_from",
"terms"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢unlock_collection(gallery, access_code)
Open a PRIVATE collection to the signed-in buyer, using the address and access code its photographer gave them — for example a wedding or client gallery whose pictures are also for sale. Afterwards search_images, get_image and list_collections include it for this buyer, and its images can be bought like any other. Use it only with a code the person gave you; never guess one. Requires sign-in.
入力スキーマ
{
"type": "object",
"properties": {
"gallery": {
"type": "string",
"description": "The gallery's address as the person has it, e.g. https://example.com/jane/smith-wedding, or \"jane/smith-wedding\"."
},
"access_code": {
"type": "string",
"minLength": 1,
"description": "The access code the photographer gave the person."
}
},
"required": [
"gallery",
"access_code"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"collection_id": {
"type": "string"
},
"title": {
"type": "string"
},
"listing_count": {
"type": "number"
}
},
"required": [
"collection_id",
"title",
"listing_count"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_account
The signed-in buyer: their credit balance, subscription status, how many images they already own, and whether a free trial is still available. Call this before proposing a purchase, so you know what they can already afford. Requires sign-in.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"email": {
"type": "string"
},
"credits": {
"type": "number"
},
"trial_credits": {
"type": "number"
},
"paid_credits": {
"type": "number"
},
"subscription": {
"anyOf": [
{
"type": "object",
"properties": {
"plan_code": {
"type": "string"
},
"status": {
"type": "string"
},
"credits_per_period": {
"type": "number"
},
"current_period_end": {
"type": [
"number",
"null"
]
},
"cancel_at_period_end": {
"type": "boolean"
}
},
"required": [
"plan_code",
"status",
"credits_per_period",
"current_period_end",
"cancel_at_period_end"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"entitlement_count": {
"type": "number"
},
"trial_available": {
"type": "boolean"
},
"licence": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"version": {
"type": "number"
}
},
"required": [
"code",
"version"
],
"additionalProperties": false
},
"account_url": {
"type": "string"
}
},
"required": [
"email",
"credits",
"trial_credits",
"paid_credits",
"subscription",
"entitlement_count",
"trial_available",
"licence",
"account_url"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢start_trial
Give the signed-in buyer 3 credits free, once per email address, ever, and never to an account that has paid here. Offer it when get_account says trial_available, someone wants an image, has no credits and has not tried the store before — AND the trial would buy that image: its price.credits is no more than 3 and price.trial_credits_accepted is true. Otherwise the trial is spent on nothing they wanted. Trial credits buy the screen file only — tell the person, so a print is not expected; the print can be bought afterwards at the full price. Requires sign-in.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"granted": {
"type": "number"
},
"credits": {
"type": "number"
}
},
"required": [
"granted",
"credits"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟡create_checkout(kind, plan_code, listing_id, licence)
Return a payment link for the person to open in a browser: either a subscription plan, or a single image bought outright (only where price.card_available is true) — or that image's commercial license, with licence=commercial, where price.commercial is not null. The commercial license is sold only this way; Stripe's page asks the person to name the licensee. THE AGENT NEVER HANDLES CARD DETAILS and must not ask for any — hand the url over and let the person pay on the payment page. Nothing is granted until they finish. After a one-off, call fulfil_image with the same listing_id: once the payment has landed it delivers the image at no credit cost, and until then it answers payment_pending. After a subscription, get_account shows it. Every result lists the plans with their prices. Use fulfil_image instead when the buyer already has credits or already owns the image, and start_trial when they have none and have not tried the store. Refused when the buyer already owns the image or already has a subscription, so that nobody pays twice — except an image the free trial bought, which is the screen file only: a one-off for it buys the print file at the full price. Each new link cancels the previous one — any earlier subscription link, or an earlier link for the same image — so give the person only the latest.
入力スキーマ
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"subscription",
"one_off"
]
},
"plan_code": {
"description": "For kind=subscription. Call with kind=subscription and no plan_code to list the plans and their prices.",
"type": "string"
},
"listing_id": {
"description": "For kind=one_off: the image to buy outright.",
"type": "string"
},
"licence": {
"description": "For kind=one_off. \"commercial\" buys the business licence, by card only; omit for personal.",
"type": "string",
"enum": [
"personal",
"commercial"
]
}
},
"required": [
"kind"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"checkout_url": {
"type": [
"string",
"null"
]
},
"kind": {
"type": "string"
},
"order_id": {
"type": [
"string",
"null"
]
},
"listing_id": {
"type": [
"string",
"null"
]
},
"expires_at": {
"type": [
"number",
"null"
]
},
"plans": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"credits_per_period": {
"type": "number"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"cents": {
"type": "number"
},
"currency": {
"type": "string"
},
"interval": {
"type": "string"
},
"interval_count": {
"type": "number"
}
},
"required": [
"cents",
"currency",
"interval",
"interval_count"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"code",
"name",
"description",
"credits_per_period",
"price"
],
"additionalProperties": false
}
}
},
"required": [
"checkout_url",
"kind",
"order_id",
"listing_id",
"expires_at",
"plans"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🔴fulfil_image(listing_id, full_image, abandon_checkout, buy_print)
Deliver an image to the signed-in buyer, spending the image's price in credits (price.credits in search_images and get_image — often 1, sometimes more) if they do not already own it. Credits buy the personal license only; the commercial license is bought with create_checkout, and this then delivers it. If they DO already own it this is free and always will be — use it freely for re-downloads, and for a fresh download link. The purchased image comes as two links, both as the photographer framed it, uncropped: download_url, 2560px WebP on the long side, which a phone or desktop fits to its own screen as a wallpaper; and print_url, the original file at full resolution (often 10–35 MB), for printing (null when unavailable). Give the person both; they expire at download_expires_at, a day out, and their account page (account_url in get_account) lists every image they own with fresh links. The picture returned inline is a 1200px copy to show them what they got. Pass full_image: true to have the full file inline as well — often 1–3 MB — only if you can accept a result that large and save it yourself. Confirm the price with the person before spending credits. An image bought wholly with free-trial credits is the screen file only: print_url is null, print_included false, and print_offer says what the print costs — the full price again, in paid credits. With the person's agreement, call again with buy_print: true to spend them (or create_checkout kind=one_off to pay by card). After a card checkout for this image it spends nothing: it answers payment_pending until the payment lands, then delivers. Requires sign-in.
入力スキーマ
{
"type": "object",
"properties": {
"listing_id": {
"type": "string"
},
"full_image": {
"description": "Also return the full 2560px file inline. Large; see the description.",
"type": "boolean"
},
"abandon_checkout": {
"description": "Only after payment_pending, and only when the person has said they will not pay by card: cancels the open payment link and spends credits instead.",
"type": "boolean"
},
"buy_print": {
"description": "For an image the free trial bought (print_included false): buy its print file, spending print_offer.credits of PAID credit. Only with the person's agreement.",
"type": "boolean"
}
},
"required": [
"listing_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"listing_id": {
"type": "string"
},
"already_owned": {
"type": "boolean"
},
"credits_spent": {
"type": "number"
},
"entitlement_id": {
"type": [
"string",
"null"
]
},
"licence": {
"anyOf": [
{
"type": "object",
"properties": {
"code": {
"type": "string"
},
"version": {
"type": "number"
},
"expires_at": {
"type": [
"number",
"null"
]
}
},
"required": [
"code",
"version",
"expires_at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"credits_remaining": {
"type": "number"
},
"source_pixels": {
"anyOf": [
{
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"width",
"height"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"download_url": {
"type": "string"
},
"print_url": {
"type": [
"string",
"null"
]
},
"print_included": {
"type": "boolean"
},
"print_offer": {
"anyOf": [
{
"type": "object",
"properties": {
"credits": {
"type": "number"
},
"paid_credits": {
"type": "number"
},
"card_price": {
"anyOf": [
{
"type": "object",
"properties": {
"cents": {
"type": "number"
},
"currency": {
"type": "string"
}
},
"required": [
"cents",
"currency"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"credits",
"paid_credits",
"card_price"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"download_expires_at": {
"type": "number"
},
"file_name": {
"type": "string"
},
"inline": {
"type": "string",
"enum": [
"preview",
"full",
"none"
]
},
"paid_by": {
"anyOf": [
{
"type": "string",
"enum": [
"credit",
"trial",
"purchase",
"comp"
]
},
{
"type": "null"
}
]
},
"photographer": {
"type": "string"
}
},
"required": [
"listing_id",
"already_owned",
"credits_spent",
"licence",
"credits_remaining",
"source_pixels",
"download_url",
"print_url",
"print_included",
"print_offer",
"download_expires_at",
"file_name",
"inline",
"paid_by",
"photographer"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_entitlements(cursor, limit, include_previews)
Everything the signed-in buyer has bought, newest first. Re-downloading any of them with fulfil_image costs nothing. Pass include_previews: true whenever the person wants to see their library: small pictures (at most 12 per page) without a fulfil_image per image. Requires sign-in.
入力スキーマ
{
"type": "object",
"properties": {
"cursor": {
"type": "string"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50
},
"include_previews": {
"description": "A small picture of each image. Caps the page at 12.",
"type": "boolean"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"entitlements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"listing_id": {
"type": "string"
},
"headline": {
"type": [
"string",
"null"
]
},
"title": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"orientation": {
"type": [
"string",
"null"
]
},
"photographer": {
"type": "string"
},
"preview_url": {
"type": [
"string",
"null"
]
},
"licence": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"version": {
"type": "number"
}
},
"required": [
"code",
"version"
],
"additionalProperties": false
},
"licensee": {
"type": [
"string",
"null"
]
},
"print_included": {
"type": "boolean"
},
"granted_at": {
"type": "number"
}
},
"required": [
"listing_id",
"headline",
"title",
"description",
"orientation",
"photographer",
"preview_url",
"licence",
"licensee",
"print_included",
"granted_at"
],
"additionalProperties": false
}
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"revoked": {
"type": "array",
"items": {
"type": "object",
"properties": {
"listing_id": {
"type": "string"
},
"title": {
"type": "string"
},
"licence": {
"type": "string"
},
"revoked_at": {
"type": "number"
}
},
"required": [
"listing_id",
"title",
"licence",
"revoked_at"
],
"additionalProperties": false
}
}
},
"required": [
"entitlements",
"next_cursor",
"revoked"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}コミュニティ
エビデンス