Pexafy

official

Semantic search over 9 free-license stock photo sources. Hosted remote server with OAuth — no API key to paste.

What can you do with Pexafy MCP?

  • Search by scene description — Ask your assistant to find photos from a full-sentence description, since Pexafy matches meaning rather than tags via search_photos.
  • Find similar photos — Give a reference image link, attachment, or an already-found photo and get visually similar results with search_photos_by_image.
  • Fetch a photo file — Get a single photograph as an image file with its credit line for a document, slide, or post using get_photo_file_by_photo_id.
  • Use your grid picks — Have the assistant work with exactly the photos you liked in the results grid, in your chosen order, via get_grid_selected_photos.
  • Connect your account — Ask the agent to "connect my Pexafy account" to sign in through OAuth from the conversation with connect_account.

Documentation

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
  • Visual Studio Code
  • VS Code Insiders
  • GitHub Copilot app
  • Cursor
  • Goose
  • Kiro
  • GitHub MCP Registry
  • Claude In preview Set it up by hand

Set it up by hand

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.

  1. Open Customize → Connectors.
  2. Click +, then Add custom connector.
  3. Paste the server URL and click Add: https://mcp.pexafy.com/mcp
  4. 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.

  1. Open Settings → Security and login and turn on Developer mode.
  2. Go to Plugins and click + to create a developer-mode app.
  3. Name it Pexafy and paste the server URL: https://mcp.pexafy.com/mcp
  4. 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.

  1. Run, from any project: claude mcp add --transport http pexafy https://mcp.pexafy.com/mcp
  2. Ask for photos in plain language: it works right away, without an account.
  3. 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.

{ "mcpServers": { "pexafy": { "type": "http", "url": "https://mcp.pexafy.com/mcp" } } }

Optional: add the Pexafy skill, which tells the agent when and how to use these tools:

npx skills add Pexafy/pexafy-mcp --skill find-stock-photos

One command adds the server to Codex, from its command line.

  1. Run, from any project: codex mcp add pexafy --url https://mcp.pexafy.com/mcp
  2. 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.
  3. Ask for photos in plain language: it works right away, without an account.
  4. 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.

  1. Run, from any project: gemini mcp add -s user --transport http pexafy https://mcp.pexafy.com/mcp
  2. Ask for photos in plain language: it works right away, without an account.
  3. 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.

  1. Run, from any project: copilot mcp add --transport http pexafy https://mcp.pexafy.com/mcp
  2. Ask for photos in plain language: it works right away, without an account.
  3. 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.

  1. Run, from any project: opencode mcp add pexafy --url https://mcp.pexafy.com/mcp
  2. Ask for photos in plain language: it works right away, without an account.
  3. 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.

  1. Run, from any project: droid mcp add pexafy https://mcp.pexafy.com/mcp --type http
  2. Ask for photos in plain language: it works right away, without an account.
  3. 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.

  1. Create .cursor/mcp.json in your project (or ~/.cursor/mcp.json for every project): { "mcpServers": { "pexafy": { "url": "https://mcp.pexafy.com/mcp" } } }
  2. Reopen Cursor and check Pexafy under Customize in the sidebar.
  3. Ask for photos in plain language: it works right away, without an account.
  4. 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:

npx skills add Pexafy/pexafy-mcp --skill find-stock-photos

GitHub Copilot in VS Code reads MCP servers from mcp.json.

  1. Run MCP: Add Server from the Command Palette, or create .vscode/mcp.json yourself: { "servers": { "pexafy": { "type": "http", "url": "https://mcp.pexafy.com/mcp" } } }
  2. Open Chat in Agent mode and pick Pexafy in the tools list.
  3. Ask for photos in plain language: it works right away, without an account.
  4. 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:

npx skills add Pexafy/pexafy-mcp --skill find-stock-photos

One command adds the server to Cline, from its command line.

  1. Run, from any project: cline mcp install pexafy --transport http https://mcp.pexafy.com/mcp
  2. Ask for photos in plain language: it works right away, without an account.
  3. 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:

cline skill install Pexafy/pexafy-mcp --skill find-stock-photos

Connects over OAuth — you sign in with your Pexafy account, there is no key to paste.

  1. Open MCP Settings and click +.
  2. Name the server Pexafy and paste its URL: https://mcp.pexafy.com/mcp
  3. Leave Streamable HTTPS and None (Auto-detect) as they are, tick I trust this application, then click Create.
  4. Click Connect, then Continue with OAuth, and sign in with Pexafy.

If you run LibreChat, you can add Pexafy for every user in librechat.yaml instead, then restart it. Each user still signs in with Pexafy once.

mcpServers: pexafy: type: streamable-http url: https://mcp.pexafy.com/mcp

One command adds the server to Devin, from its command line.

  1. Run, from any project: devin mcp add -s user pexafy https://mcp.pexafy.com/mcp
  2. 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.

  1. Open Settings → AI → MCP Servers.
  2. Click Add Server, choose Add Remote Server and paste the server URL: https://mcp.pexafy.com/mcp
  3. Ask for photos in plain language in the Agent Panel: it works right away, without an account.
  4. 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:

{ "context_servers": { "pexafy": { "url": "https://mcp.pexafy.com/mcp" } } }

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.

API quickstart →

The full documentation

Every assistant step by step, sign-in or key, the five tools, the skill, the limits and troubleshooting.

MCP documentation →

Ask. Choose together. Put them to work.

Ask, in your own words

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

Pexafy — The liked photos under the grid, numbered in the order chosen, ready for the assistant.

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.

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.

Pexafy — A follow-up in the same conversation, “more like the second one”, answered by more photographs of the same autumn scene.

Pexafy — A follow-up in the same conversation, “more like the second one”, answered by more photographs of the same autumn scene.

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.

Open source

The server is public and MIT-licensed. Read exactly what it sends, and what it asks of your account.

Pexafy/pexafy-mcp on GitHub →

Hosted and monitored

We run it, so you do not have to. Its health endpoint is public.

Check the server status →

Revocable at any time

The connector holds its own credentials, separate from your password. Remove it from your assistant and the access is gone.

Manage your access →