# PicYep MCP Realistic photos and video of real people, pets and products, from a sentence or from your own photos, inside your AI assistant. One account, with no provider keys. - Server: https://picyep.com/mcp - For ChatGPT: https://picyep.com/mcp/chatgpt - Transport: Streamable HTTP, stateless, answering in JSON - Version: 0.3.0 - Signing in: https://picyep.com/auth.md - OpenAPI: https://picyep.com/openapi.json - Status: https://picyep.com/status.json - Prices: https://picyep.com/pricing.md - How to connect each client: https://picyep.com/how-to-connect ## How it works Photos attached to a chat do not reach a connector, so create_upload_link makes a link for adding them, and a box inside the chat where the client can show one. check_upload can wait for them to arrive. A client that can send files itself can POST each one to the post_to address it returns. Making a photo or video is a job: the tool returns a job_id, and check_job returns the result. Everything that spends credits says what it costs through estimate_cost or estimate_video_cost first, and a request sent again with the same request_id is not charged twice. ## Tools ### list_models Lists the image models on PicYep: what each is, what one photo costs in credits at each size, how many reference photos it takes, and whether this account can use it now. ### get_model_params Returns one image model’s settings: aspect ratios, resolutions, qualities, photos per request, reference photos and credits per photo. ### search_styles Searches PicYep’s ready-made looks (each with the words and the photo it made) and styles (which set the light and the camera for a request). A look’s words can be used as a prompt, or its id given as look_id; a style’s id can be given as style. ### estimate_cost Returns what a request would cost in credits, with these settings and this many reference photos, and whether the account has that many. Makes nothing and spends nothing. ### get_credits_balance Returns how many credits the signed-in account has, what they are from, and when the next ones expire. ### create_upload_link The first step of any request that goes by the user's own photos, such as a headshot or a portrait, and it needs nothing from them beforehand. Makes a link the user opens in a browser, on a phone or a computer, to add up to 16 of their photos, and a box for adding them inside the chat where the assistant can show one. Photos attached to the chat itself do not reach PicYep, so asking the user to attach them gets nowhere. The link lasts 20 minutes. A client that can send files itself can POST one JPG or PNG at a time, as the raw request body, to post_to. Its upload_id goes to generate_image, and check_upload says how many photos have arrived. Only photos the user has the right to use. ### check_upload Says how many photos have arrived through a link from create_upload_link. With wait_seconds it waits up to that long, at most 45, and answers once photos have arrived and stopped arriving, so the user does not have to say they are there. ### add_upload_photo Adds one photo, as base64, to an upload from create_upload_link. The upload box uses it when it cannot reach PicYep directly. ### generate_image Makes photos from a description, from the user’s photos, or from both, and spends the credits of the signed-in account. Returns a job at once; check_job returns the photos when they are ready. A request that ends without a photo gets its credits back. ### check_job Returns how a job from generate_image is going and, when it is done, its photos: a small picture of each, a link to the full one that works for a while, and its page on PicYep. Waits a little before answering while the job is still working. ### cancel_job Cancels a job that has not started yet, and its credits go back to the account. A job already being made goes on. ### generate_image_set Makes one photo in each of 2 to 4 styles from the same request, and spends the account's credits for all of them. Style ids come from search_styles. Each photo is a job for check_job. ### compare_models Sends one request to 2 to 4 models, one photo each, and spends the account's credits for all of them. Each photo is a job for check_job. ### list_video_models Lists the video models for generate_video: lengths, sizes, shapes, and what a video starts at in credits. ### estimate_video_cost Says how many credits a video would cost with these settings, and the balance. Nothing is made or spent. ### generate_video Makes a video from a description, or from one photo, through a link from create_upload_link or saved in the library, or two for a first and last frame. It spends the account’s credits. It returns a job for check_job, whose answer holds the video’s address. ### edit_photo Makes a new version of a photo from a sentence saying what to change. It spends the account’s credits, and returns a job for check_job. ### add_person_to_photo Adds people to a photo and keeps who is already in it. They come from a link from create_upload_link, from saved people (list_people), or both. It spends the account’s credits, and returns a job for check_job. ### upscale_photo Makes a photo 2 or 4 times larger. It spends the account's credits, and returns a job for check_job. ### remove_background Cuts out the subject on a transparent background. It spends the account's credits, and returns a job for check_job. ### expand_photo Extends a photo outward to a new shape, inventing what was outside it. It spends the account's credits, and returns a job for check_job. ### change_background Puts the subject on one of a few plain or everyday backgrounds. It spends the account's credits, and returns a job for check_job. ### erase_from_photo Removes what is inside a box on the photo and fills it in. The box is given as fractions of the photo, from 0 to 1, measured from its top left. It spends the account's credits, and returns a job for check_job. ### animate_photo Makes a short clip from a photo. It spends the account's credits, and returns a job for check_job. ### search_photos Finds photos and clips in the account’s library, newest first, by words in their title, request or model. Leave the words out to list the latest. photo_id goes to the tools that change a photo. ### get_photo Returns one photo of the account’s: its links and what it was made from, with a small picture in the answer. ### import_photo_from_url Copies a JPG or PNG at a public https address into the account’s library, and returns its photo_id. Only pictures the user has the right to use. ### create_share_link Makes a public link to one photo. Anyone with the link can see it, until it is taken back on the site or the photo is deleted. ### delete_photo Moves a photo to the trash and takes back any public link to it. It stays there for 30 days and can be restored on the site, then it is gone. ### list_people Lists what the account has saved to use again: people, pets, products, outfits, places and so on. A person_id goes to generate_image and add_person_to_photo. ### create_person Saves a person, pet, product or other thing with its photos from a link from create_upload_link, up to 6, to use again by person_id. Only photos the user has the right to use. ### add_person_photo Adds photos from a link from create_upload_link to a saved person or thing, up to 6 in all. ### delete_person Deletes a saved person or thing and its photos for good. There is no trash for these, and it cannot be undone. Photos already made with them stay. ### list_albums Lists the account’s photo albums. ### create_album Makes a photo album, at the top or inside another album. ### add_to_album Puts up to 100 photos in an album. They stay wherever else they were. ### get_plans_info Says what plans and credit packs PicYep has, and where to read about them. Nothing can be bought here. ### submit_feedback Sends the user’s own words to the PicYep team, as a message from their account. The answer comes in their account’s feedback chat.