Say what you need, in your own words. Your assistant finds real, free-to-use photos and works with you: pick them in a grid, or let it place them straight into your article, deck or code.
One request, sixteen photographs with their credits, inside the conversation. Heart the ones you want: they go back to the assistant in the order you chose.
Connect in one click
Install Pexafy in one click. In VS Code and Cursor you can search right away, without an account; ChatGPT asks you to sign in to Pexafy once, and a free account is enough. Claude is in preview.
ChatGPT, Claude, Cursor, GitHub, Goose, Kiro and Visual Studio Code are trademarks of their respective owners.
Set it up by hand
Nothing to install, no key to paste. Most clients below work right away, without an account; connect your Pexafy account with OAuth when you want to use it. Claude and ChatGPT ask you to sign in once, in a browser window.
Connects over OAuth — you sign in with your Pexafy account, there is no key to paste.
Open Customize → Connectors.
Click +, then Add custom connector.
Paste the server URL and click Add:
https://mcp.pexafy.com/mcp
Sign in with Pexafy in the window Claude opens, and approve access.
Available on Free, Pro, Max, Team and Enterprise. Free accounts can hold one connector.
Custom MCP servers live behind developer mode, on the web app.
Open Settings → Security and login and turn on Developer mode.
Go to Plugins and click + to create a developer-mode app.
Name it Pexafy and paste the server URL:
https://mcp.pexafy.com/mcp
Pick OAuth as the authentication method, then sign in with Pexafy.
Developer mode is available to Plus, Pro, Business, Enterprise and Education accounts on the web.
One command adds the server to Claude Code, from its command line.
Run, from any project:
claude mcp add --transport http pexafy https://mcp.pexafy.com/mcp
Ask for photos in plain language: it works right away, without an account.
To use your Pexafy account, ask the agent to “connect my Pexafy account”: it opens the Pexafy sign-in page in your browser (OAuth), with no key to paste.
Or sign in from the terminal:
claude mcp login pexafy
Prefer a project file? Add the same entry to .mcp.json — a url without a type field is rejected.
One command adds the server to Codex, from its command line.
Run, from any project:
codex mcp add pexafy --url https://mcp.pexafy.com/mcp
Codex opens the Pexafy sign-in page as soon as you add the server: sign in, or close it and carry on without an account.
Ask for photos in plain language: it works right away, without an account.
To use your Pexafy account, ask the agent to “connect my Pexafy account”: it opens the Pexafy sign-in page in your browser (OAuth), with no key to paste.
Or sign in from the terminal:
codex mcp login pexafy
One command adds the server to Gemini CLI, from its command line.
Run, from any project:
gemini mcp add -s user --transport http pexafy https://mcp.pexafy.com/mcp
Ask for photos in plain language: it works right away, without an account.
To use your Pexafy account, ask the agent to “connect my Pexafy account”: it opens the Pexafy sign-in page in your browser (OAuth), with no key to paste.
One command adds the server to GitHub Copilot CLI, from its command line.
Run, from any project:
copilot mcp add --transport http pexafy https://mcp.pexafy.com/mcp
Ask for photos in plain language: it works right away, without an account.
To use your Pexafy account, ask the agent to “connect my Pexafy account”: it opens the Pexafy sign-in page in your browser (OAuth), with no key to paste.
One command adds the server to OpenCode, from its command line.
Run, from any project:
opencode mcp add pexafy --url https://mcp.pexafy.com/mcp
Ask for photos in plain language: it works right away, without an account.
To use your Pexafy account, ask the agent to “connect my Pexafy account”: it opens the Pexafy sign-in page in your browser (OAuth), with no key to paste.
Or sign in from the terminal:
opencode mcp auth pexafy
One command adds the server to Factory Droid, from its command line.
Run, from any project:
droid mcp add pexafy https://mcp.pexafy.com/mcp --type http
Ask for photos in plain language: it works right away, without an account.
To use your Pexafy account, ask the agent to “connect my Pexafy account”: it opens the Pexafy sign-in page in your browser (OAuth), with no key to paste.
Cursor reads MCP servers from a JSON file, and supports OAuth for servers that require it.
Create .cursor/mcp.json in your project (or ~/.cursor/mcp.json for every project):
{ "mcpServers": { "pexafy": {
"url": "https://mcp.pexafy.com/mcp"
} } }
Reopen Cursor and check Pexafy under Customize in the sidebar.
Ask for photos in plain language: it works right away, without an account.
To use your Pexafy account, ask the agent to “connect my Pexafy account”: it opens the Pexafy sign-in page in your browser (OAuth), with no key to paste.
Optional: add the Pexafy skill, which tells the agent when and how to use these tools:
GitHub Copilot in VS Code reads MCP servers from mcp.json.
Run MCP: Add Server from the Command Palette, or create .vscode/mcp.json yourself:
{ "servers": { "pexafy": {
"type": "http",
"url": "https://mcp.pexafy.com/mcp"
} } }
Open Chat in Agent mode and pick Pexafy in the tools list.
Ask for photos in plain language: it works right away, without an account.
To use your Pexafy account, ask the agent to “connect my Pexafy account”: it opens the Pexafy sign-in page in your browser (OAuth), with no key to paste.
Optional: add the Pexafy skill, which tells the agent when and how to use these tools:
One command adds the server to Cline, from its command line.
Run, from any project:
cline mcp install pexafy --transport http https://mcp.pexafy.com/mcp
Ask for photos in plain language: it works right away, without an account.
To use your Pexafy account, ask the agent to “connect my Pexafy account”: it opens the Pexafy sign-in page in your browser (OAuth), with no key to paste.
Optional: add the Pexafy skill, which tells the agent when and how to use these tools:
One command adds the server to Devin, from its command line.
Run, from any project:
devin mcp add -s user pexafy https://mcp.pexafy.com/mcp
Devin opens the Pexafy sign-in page: approve access, then ask for a photo in plain language.
Zed connects to remote MCP servers natively, without an extension.
Open Settings → AI → MCP Servers.
Click Add Server, choose Add Remote Server and paste the server URL:
https://mcp.pexafy.com/mcp
Ask for photos in plain language in the Agent Panel: it works right away, without an account.
To use your Pexafy account, ask the agent to “connect my Pexafy account”: it opens the Pexafy sign-in page in your browser (OAuth), with no key to paste.
Prefer the settings file? The same entry in settings.json:
Claude Code, Cline, Codex, Devin, Factory, Gemini, GitHub Copilot, LibreChat, OpenCode and Zed are trademarks of their respective owners.
Good to know
Do I need an API key?
No. ChatGPT, Claude and most assistants sign in to Pexafy instead: when you authorize them, the connection makes its own key. Only a tool that cannot open a sign-in window takes a key in its settings — create one in API Keys and choose “In an AI assistant”.
The sign-in asks me to free a key
The Free plan includes one key, and a connected assistant uses it. If you already created one for your code, the sign-in page lets you revoke it, or you can keep it and use the API from your code.
Building your own app or script?
Call the REST API with a key: copy-paste code in Python, JavaScript, PHP and more, plus libraries for LangChain and the Vercel AI SDK.
Tell your assistant what you are working on, the way you would tell a colleague: “I'm writing a short article about Kyoto in autumn. Find photos of a temple garden with red maple leaves.” It writes the search; Pexafy matches the scene, not tags.
Choose together
Sixteen photographs come back. Open one large, swipe, heart the keepers, press ≈ for more like it: your picks go back to the assistant, in your order. Or simply answer in words: “the third one, but wider”.
Put them to work
The assistant carries on with them: the article with its photos in place, the slide, the landing page, the post. Each photograph keeps its licence and the credit line to display, and comes as an image file when the work needs one.
With the grid, or without it
In a chat that draws it
ChatGPT, Claude, VS Code, Cursor. The photographs appear as a grid in the conversation. You see them, open them, like them; the assistant works from what you picked.
› Illustrate post.md with Pexafy photos● search_photos "Kyoto temple garden, red maples"● get_photo_file_by_photo_id → images/kyoto.jpg✎ post.md  *Photo by Hat Trick on Unsplash*
In an agent, a terminal or a script
Claude Code, Codex, any MCP client. Each result arrives as a link with its licence and credit line. The assistant chooses, fetches the file and places it in your Markdown, HTML, slides or CMS.
Five tools, read-only
The connector can search. It cannot write to your account, and it never asks for permission to.
search_photos
Describe a scene in a full sentence. Pexafy searches by meaning, so “two people sharing a bench in comfortable silence” works better than a list of keywords.
search_photos_by_image
Give it a reference — an image link, an attached image, or a photo it already found — and get photographs that look like it, optionally adjusted in words: “like this, but at night”.
get_photo_file_by_photo_id
One photograph as an image file, with its credit line — to place in a document, a slide or a post.
get_grid_selected_photos
The photographs you liked in the results grid, in the order you chose, so the assistant works with exactly those.
connect_account
Connects your Pexafy account from the conversation, if you started without one.
Every result carries the credit to display, and comes from one of 9 free-licence sources.
Free to use
The Free plan covers 5000 searches a month — enough for regular use, and no card required. When you reach a limit, the assistant tells you in the conversation instead of failing with an unreadable error.