Image Resolver
Connects Pexels and Unsplash APIs to any MCP client through five tools: search_images for multi-provider queries with pagination and orientation filters, extract_image_query to parse natural language into search terms, get_best_image for single results, search_images_batch for parallel queries, and resolve_image_attribution for compliance text. Returns structured ImageResult objects with URLs, dimensions, photographer credits, and tags. Requires at least one API key but both providers offer free tiers. Run it with npx so there's no local build step. Useful when you're prototyping layouts, need placeholder assets in your editor, or want AI agents to fetch contextual imagery without leaving the development environment.
- tools
- 5
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Mar 5, 2026
Tools
5 toolsPublic tool metadata for what this MCP can expose to an agent.
search_imagesSearch for royalty-free images (supports limit, page, orientation)
Search for royalty-free images (supports limit, page, orientation)
No parameter schema in public metadata yet.
extract_image_queryTransform free-form text into an image search query
Transform free-form text into an image search query
No parameter schema in public metadata yet.
get_best_imageReturn a single best image for a query
Return a single best image for a query
No parameter schema in public metadata yet.
search_images_batchRun multiple searches in parallel
Run multiple searches in parallel
No parameter schema in public metadata yet.
resolve_image_attributionGenerate provider-compliant attribution text
Generate provider-compliant attribution text
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
PEXELS_API_KEYsecretPexels API key (free at https://www.pexels.com/api/)
UNSPLASH_ACCESS_KEYsecretUnsplash API key (free at https://unsplash.com/oauth/applications)
Readme
MCP Image Resolver Server
An MCP (Model Context Protocol) server that provides royalty-free image search for AI hosts like Cursor, Claude Desktop, VS Code, Windsurf, and more. Ask your AI assistant to find images by natural language—it uses the search_images tool and returns structured results from Pexels and Unsplash.
Features
- search_images — Search for royalty-free images (supports limit, page, orientation)
- extract_image_query — Transform free-form text into an image search query
- get_best_image — Return a single best image for a query
- search_images_batch — Run multiple searches in parallel
- resolve_image_attribution — Generate provider-compliant attribution text
- Pexels & Unsplash — Multi-provider support (free tier for both)
- Unified response — Structured results with url, source, dimensions, photographer, tags
- Works everywhere — Any MCP client that supports stdio servers
Requirements
- Node.js 18+
- At least one API key: Pexels (pexels.com/api) and/or Unsplash (unsplash.com/oauth/applications)
Quick Start (No Installation Required)
Details
- Repository
- github.com/ahmaddioxide/image-resolver-mcp
- Category
- Search & Web Crawling
- Package
@ahmaddioxide/mcp-image-resolver- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
Related Search & Web Crawling MCP servers
View all
Visibly AI — SEO MCP Serverantonioblago/claude-code-seo-starterRemote SEO/GEO MCP: Search Console, keyword research, backlinks, competitor & on-page audits.0stars
Web Scraper to Markdown APIbr0ski777/web-scraper-x402Extract clean markdown from any URL. Removes boilerplate. For RAG pipelines. x402.0stars
Merx — European Business Databricepourle13/merxprotocolEuropean business data — French company check, EU VAT validation, legal search.0stars
Essentialsfieldcure/fieldcure-mcp-essentialsEssential MCP server: HTTP, web search, downloads, Wolfram|Alpha, shell, JS, file I/O, memory.0stars
Nextrolehyperdrift-io/hyper-cvA job-search companion: tailor your CV to a role, score fit, fix ATS issues. Also via MCP.0stars
Handbookah-oh/handbook-mcp-serverMCP server for the Handbook API – manage handbook entries via CRUD, overview and tag search.0stars