PicYep is a remote Model Context Protocol server. A person connects it to their assistant once, and the assistant can then make photos and video with their account. There are no provider keys, and a person's credits pay for what is made.
The server
- Address:
https://picyep.com/mcp - For ChatGPT:
https://picyep.com/mcp/chatgpt - Transport: Streamable HTTP, stateless, answering in JSON
- Signing in: OAuth 2.1 with PKCE and dynamic client registration
Files to read
- developers.md: every tool, in Markdown
- auth.md: signing in, step by step
- openapi.json
- .well-known/mcp.json: the server card
- pricing.md: what things cost, in credits
- status.json
Scopes
photos: see the balance and models, make photos with the account's credits, and use photos added through a link.library: see, change and delete saved photos, people and albums, and make public links to photos.offline_access: a refresh token.
Adding photos
Photos attached to a chat do not reach a connector, so create_upload_link makes a link that opens on a phone or a computer, and a box inside the chat in clients that show MCP Apps. check_upload can wait for them to arrive. A client that can send files itself can POST each one to the post_to address, as the raw request body. On the ChatGPT address, add_chat_photos takes the photos attached to the chat.
Jobs and credits
Making a photo or a video is a job. The tool returns a job_id, and check_job returns the result when it is ready. estimate_cost and estimate_video_cost say what a request would cost first. A request sent again with the same request_id is not charged twice, and a request that ends without a result gives its credits back.
Connecting a client
See how to connect.